targetingFacets Object


This page is deprecated. Please refer targetingCriteria and targetingCriteria 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. A member belongs to the segment if the member matches at least one of the specified values for each non-empty field.

The following table shows all the targeting facets available for targeting. All facets will default to empty. If an array-based criterion is associated with an empty array of values, whether explicitly or implicitly due to the default, it will be ignored. The same holds for gender; if no value is specified, it will be irrelevant to the process for determining whether a member is within the targeted audience. Note that some values can be inferred, rather than having been explicitly provided by a member.

Field Name Type Description
audienceMatchingSegments Array of AdSegmentUrn For ex: ["urn:li:adSegment:10001"]
retargetingSegments Array of AdSegmentUrn For ex: ["urn:li:adSegment:10001"]
ageRanges Array of AgeRange Age ranges to match against member. Valid AgeRange enum values:
  • AGE_18_24 - Age 18 ot 24 years, inclusive
  • AGE_25_34 - Age 25 to 34 years, inclusive
  • AGE_35_54 - Age 35 to 54 years, inclusive
  • AGE_55_PLUS - Age 55 and up
degrees Array of Degree URN Educational degrees attained to match against those of the member.
employers Array of Company URN Specific companies to match against member's current employer.
fieldsOfStudy Array of FieldOfStudy URN Fields of study to match against those listed by the member.
followedCompanies Array of Company URN Specific companies to match against those the member is following.
genders Array of Gender Genders to match against member. Valid Gender values:
  • MALE
groups Array of Group URN LinkedIn groups to match against the member's group memberships.
industries Array of Industry URN Industries to be targeted.
interfaceLocales Array of Locale Interface locales to be targeted. Currently limited to one locale.
jobFunctions Array of Function URN Top level groupings of supertitles to be targeted.
locations Array of valid location-type URN Location to be targeted. The URNs do not need to all be of the same type. The permitted URN types are:
  • countryGroup
  • country
  • state
  • region
Location is a union of member's current IP location and his/her profile location.
profileLocations Array of valid location-type URN The values are similar to "locations", however, profileLocation is purely based on the information provided on a member's profile. 
schools Array of School URN Schools to match against the member's listed schools, both past and present.
seniorities Array of Seniority URN Seniorities to be targeted.
skills Array of Skill URN Skills to match against the member's listed skills.
staffCountRanges Array of StaffCountRange Organization sizes to be targeted. Valid StaffCountRange enum values:
  • SIZE_1 - A single staff member.
  • SIZE_2_TO_10 - A staff of 2 to 10.
  • SIZE_11_TO_50 - A staff of 11 to 50.
  • SIZE_51_TO_200 - A staff of 51 to 200.
  • SIZE_201_TO_500 - A staff of 201 to 500.
  • SIZE_501_TO_1000 - A staff of 501 to 1000.
  • SIZE_1001_TO_5000 - A staff of 1001 to 5000.
  • SIZE_5001_TO_10000 - A staff of 5001 to 10000.
  • SIZE_10001_OR_MORE - A staff of 10001 or more.
titles Array of Title URN Job titles to match against the member's current title.
yearsOfExperienceRange.start optional int Inclusive range of years of experience of the member. Valid numbers are 1 to 12. Number 12 is only allowed for lower bound and when upper bound is omitted, which means 12+. Lower bound is mandatory, but upper is optional with unlimited as default. Represents the inclusive (greater than or equal) value in which to start the range. An unset field indicates an open range; for example, if end is 5, it means everything less than or equal to 5.
yearsOfExperienceRange.end optional int Represents the inclusive (less than or equal) value in which to end the range. This field is optional. An unset field indicates an open range; for example if start is 2 it means everything greater than or equal to 2.