PredictiveAudiences
Create and manage LinkedIn Predictive Audiences, which combine first-party or third-party seed data with LinkedIn's predictive AI modeling to build high-intent audience segments for advertising campaigns.
Table Specific Information
The Predictive Audiences API is a private API available to developers with access to the Matched Audiences API.
Select
The Id column is required in the WHERE clause. Specifying DMPSegmentId is recommended. The provider processes other filters client-side within the provider. For example, the following queries are processed server side.
SELECT * FROM PredictiveAudiences WHERE Id = '12345678' AND DMPSegmentId = '44348177';
SELECT * FROM PredictiveAudiences WHERE Id = '12345678';
Insert
To create a new predictive audience, specify the DMPSegmentId, Seeds, and TargetingCriteria columns. The TargetingCriteria must include a geo filter.
INSERT INTO PredictiveAudiences (DMPSegmentId, Seeds, TargetingCriteria, DesiredAudienceCount)
VALUES ('44348177', 'urn:li:dmpSegment:44348177',
'{
"include": {
"and": [
{
"or": {
"urn:li:adTargetingFacet:locations": [
"urn:li:countryGroup:US"
]
}
}
]
}
}', 50000);
Update
To modify an existing predictive audience, use an UPDATE statement. The Id column is required in the WHERE clause. Specifying DMPSegmentId is recommended.
UPDATE PredictiveAudiences SET DesiredAudienceCount = 75000 WHERE Id = '12345678' AND DMPSegmentId = '44348177';
Delete
To remove a predictive audience, use a DELETE statement. The Id column is required in the WHERE clause. Specifying DMPSegmentId is recommended.
DELETE FROM PredictiveAudiences WHERE Id = '12345678' AND DMPSegmentId = '44348177';
Columns
| Name | Type | ReadOnly | References | Description |
| Id [KEY] | Long | True |
The unique ID of the predictive audience. | |
| DMPSegmentId | Long | False |
DMPSegments.Id |
The ID of the parent DMP segment to which this predictive audience belongs. |
| Seeds | String | False |
A comma-separated list of seed URNs from which the predictive audience is built. Accepted seed types include conversions (urn:lla:llaPartnerConversion:1), matched audience segments (urn:li:dmpSegment:123), and ad lead gen forms (urn:li:adForm:1). | |
| TargetingCriteria | String | False |
The targeting criteria used to build the predictive audience, specified as a JSON object. A geo filter must be present in the targeting criteria. | |
| DesiredAudienceCount | Long | False |
The target number of members for the predictive audience segment. If not specified, the system uses the value from RecommendedAudienceCount. | |
| RecommendedAudienceCount | Long | True |
The system-recommended number of members for the predictive audience segment. This value is null if the system is still processing or cannot generate a recommendation. | |
| CompanyExpansionMultiplier | Long | False |
The expansion factor applied to company seeds. For example, a value of 2 with 10 company seeds produces an expansion output of 20 companies. Only applicable when Seeds contains company URNs. | |
| AudienceAutomation | String | True |
The audience automation source from which this audience was created. Set to AUTO_TARGETING for audiences created from an Optima campaign. Absent for audiences not created via audience automation. | |
| CreatedAt | Datetime | True |
The date and time when the predictive audience was created. | |
| LastModifiedAt | Datetime | True |
The date and time when the predictive audience was last modified. | |
| DeletedAt | Datetime | True |
The date and time when the predictive audience was deleted. |