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 add-in processes other filters client-side within the add-in. 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. |