Targeting Criteria Facet URNs
LinkedIn uses member facets to define a segment of members who will be either included or excluded from an advertising campaign's targeting. targetingCriteria provides a generic AND / OR construct to include and exclude different targeting facets when defining audience for campaigns. targetingCriteria can be attached to a campaign just like previous targeting object.
The table below provides a list of adTargetingFacets that can be used in the targetingCriteria
Note
These facets names and facet values mentioned below are discoverable using the adTargetingFacets and adTargetingEntities API.
Read more: Ads Targeting Discovery
| adTargetingFacets | Array of URN Type | Description |
|---|---|---|
| urn:li:adTargetingFacet:ageRanges | ageRange | Values : urn:li:ageRange:(18,24) urn:li:ageRange:(25,34) urn:li:ageRange:(35,54) urn:li:ageRange:(55, 2147483647) |
| urn:li:adTargetingFacet:audienceMatchingSegments | Ad Segments | Example : urn:li:adSegment:10001 All audience matching segments like contact or company lists, except retargeting segments which are of type urn:li:adTargetingFacet:dynamicSegments. |
| urn:li:adTargetingFacet:companyCategory | organizationRankingList | Example: urn:li:organizationRankingList:1 urn:li:organizationRankingList:2 |
| urn:li:adTargetingFacet:degrees | Standardized degrees | Example : urn:li:degree:700 |
| urn:li:adTargetingFacet:dynamicSegments | Ad Segments | Example : urn:li:adSegment:10001 Website and engagement retargeting ad segments are categorized as dynamicSegments facet. All other types of audience matching segments are of type urn:li:adTargetingFacet:audienceMatchingSegments. Website retargeting segments may not be AND’ed with any clause targeting member behavior or interests. |
| urn:li:adTargetingFacet:employers | Organization | Example : urn:li:organization:1035 Industry and StaffCountRanges facets may not be AND'ed with any "include" clauses targeting Employers. |
| urn:li:adTargetingFacet:employersAll | Organization | Example : urn:li:organization:1035 Industry and StaffCountRanges facets may not be AND'ed with any "include" clauses targeting EmployersPast. |
| urn:li:adTargetingFacet:employersPast | Organization | Example : urn:li:organization:1035 Industry and StaffCountRanges facets may not be AND'ed with any "include" clauses targeting EmployersAll. |
| urn:li:adTargetingFacet:fieldsOfStudy | Standardized fieldsOfStudy | Example : urn:li:fieldOfStudy:100275 |
| urn:li:adTargetingFacet:firstDegreeConnectionCompanies | Organization | Example : urn:li:organization:1035 |
| urn:li:adTargetingFacet:followedCompanies | Organization | Example : urn:li:organization:1035 |
| urn:li:adTargetingFacet:genders | Gender | Values :urn:li:gender:FEMALE urn:li:gender:MALE |
| urn:li:adTargetingFacet:groups | Group | Example : urn:li:group:1234 |
| urn:li:adTargetingFacet:growthRate | growthRate | Values : urn:li:growthRate:(-2147483647,0) urn:li:growthRate:(0,3) urn:li:growthRate:(3,10) urn:li:growthRate:(10,20) urn:li:growthRate:(20,2147483647) The lower and upper limits in the range represents the growth rate in percentages |
| urn:li:adTargetingFacet:industries | Standardized industries | Example : urn:li:industry:9 Industries may not be AND'ed with any "include" clauses targeting Employers. |
| urn:li:adTargetingFacet:interests | Interest | Example : urn:li:interest:689290 Interest targeting allows advertisers to reach audiences based on specific interests expressed on LinkedIn. Subject to our members' ad settings, advertisers are able to target LinkedIn members whose interests are closely aligned with their goals and objectives, and deliver greater personalization with their content. |
| urn:li:adTargetingFacet:interfaceLocales | locale | Example : urn:li:locale:en_US |
| urn:li:adTargetingFacet:jobFunctions | Standardized jobFunctions | Example : urn:li:function:22 Job functions may not be AND'ed with any "include" clauses targeting Job Titles. |
| urn:li:adTargetingFacet:locations | Standardized locations | Examples : urn:li:countryGroup:NA urn:li:country:us urn:li:state:(urn:li:country:us,CA) urn:li:region:84 *Targeting by location implies that either a member's current IP location or his/her profile location can be used for matching. |
| urn:li:adTargetingFacet:memberBehaviors | memberBehavior | Example : urn:li:memberBehavior:2 Member behaviors may not be AND’ed with any clause targeting contact audience matching segments or website retargeting segments. |
| urn:li:adTargetingFacet:profileLocations | Standardized locations | The values are the same as "locations" facet. *Targeting by profileLocation implies that only the member's profile location should be used for matching. |
| urn:li:adTargetingFacet:schools | Organization | Example : urn:li:organization:1035 |
| urn:li:adTargetingFacet:seniorities | Standardized seniorities | Example : urn:li:seniority:7 Seniorities may not be AND'ed with any "include" clauses targeting Job Titles. |
| urn:li:adTargetingFacet:skills | Standardized skills | Example : urn:li:skill:17 |
| urn:li:adTargetingFacet:staffCountRanges | staffCountRange | Values : urn:li:staffCountRange:(1,1) urn:li:staffCountRange:(2,10) urn:li:staffCountRange:(11,50) urn:li:staffCountRange:(51,200) urn:li:staffCountRange:(201,500) urn:li:staffCountRange:(501,1000) urn:li:staffCountRange:(1001,5000) urn:li:staffCountRange:(5001,10000) urn:li:staffCountRange:(10001,2147483647) StaffCountRanges can be targeted either inclusively or exclusively, but not both. It cannot be AND'ed with any "include" clauses targeting Employers. |
| urn:li:adTargetingFacet:titles | Standardized titles | Example : urn:li:title:4 Seniorities and job functions may not be AND'ed with any "include" clauses targeting Job Titles. |
| urn:li:adTargetingFacet:titlesAll | Standardized titles | Example : urn:li:title:4 Seniorities and job functions may not be AND'ed with any "include" clauses targeting Job Titles. |
| urn:li:adTargetingFacet:titlesPast | Standardized titles | Example : urn:li:title:4 Seniorities and job functions may not be AND'ed with any "include" clauses targeting Job Titles. |
| urn:li:adTargetingFacet:yearsOfExperienceRanges | yearsOfExperienceRanges | Example : urn:li:yearsOfExperience:3 Range: 1 to 12+ yrs. Accepts up to 2 URNs to set a lower and upper limit. If you provide only 1 URN, it is considered the lower limit and the targeting will have no upper limit. |
*Some facets representing range (like StaffCount or Age) use INT_MAX value 2147483647 as a way to represent no upper limit.
Special Note
The following facets can only be used in the "include" clause of targetingCriteria :
- urn:li:adTargetingFacet:ageRanges
- urn:li:adTargetingFacet:genders
- urn:li:adTargetingFacet:groups
- urn:li:adTargetingFacet:interfaceLocales
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for