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 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.
Interests may not be AND’ed with any clause targeting contact audience matching segments or website retargeting segments.
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 :

  1. urn:li:adTargetingFacet:ageRanges
  2. urn:li:adTargetingFacet:genders
  3. urn:li:adTargetingFacet:groups
  4. urn:li:adTargetingFacet:interfaceLocales