Within Lincx, Ad Groups will use publisher-provided criteria to target visitors via whitelist and blacklists.
In addition, any criteria given to the Lincx client may be used as macros in creative target urls and conversion pixels.
For example, if targeting based on "credit rating" is important, the Publisher can provide this information about the visitor and an Advertiser can use it for targeting in an Ad Group.
When the publisher is rendering the script, they can provide it as criteria:
<script
src="https://api.lincx.com/load"
data-zone-id="abc123"
data-credit-rating="excellent">
</script>
When Lincx is choosing ads to render in this zone it will be limited to the constraints of the available Ad Groups. For example, if an Ad Group has a targeting whitelist of creditRating: ['excellent', 'good'], it will be eligible to show Ads in this zone. Conversely, if instead it had a blacklist of creditRating: ['excellent'], it would not show ads in this zone.
In addition, the Advertiser may use this criteria as a macro in the Creative target url. Example: https://advertiser.com/offer?rating={{creditRating}}
Advertisers may use criteria as macros even if they do not wish to use them for targeting. This is commonly used for passing click IDs or other tracking data.
Publishers and advertisers may use any criteria for targeting as long as it does not conflict with a reserved setting name (listed below).
There are multiple ways to provide criteria to the Lincx client
- Passing them to the script tag via
data-*attributes - Allowing the client to pull them from the URL query parameters
- Providing them as an argument to the
window.lincx()method
Details about how to implement the above methods can be found here.
In addition to targeting criteria, the Lincx client accepts special settings that change its behavior. Below are the name, purpose, and example of each. With the exception of "Zone ID", all are optional.
| Name | Value type | Meaning | Example |
|---|---|---|---|
| zone-id | A valid ID | REQUIRED: The id of a zone, zoneId should be already available when you copy the script tag |
data-zoneId="12ik3b" |
| geo-state | 2-char geo code (CA, AL...etc) | U.S. state used in adgroup targeting | data-geo-state="CA" |
| ad-feed-count | Integer Number | The number of ads rendered in a publisher's ad feed | data-ad-feed-count="3" |
| score-key | String | A special key used to optimize traffic, different keys will make the zone order differently depending on the source | data-score-key="A" |
| zone-load-cost | Real Number | This can be used to assign a traffic aquisition cost for reporting | data-zone-load-cost="0.123" |
| manual-render | true/false (default) | Whethere you want the script tag to render automatically or you want to control where to render the ads | data-manual-render="true" |