The Audience API functionality is fully comprehensive and includes all targeting options that the UI supports. However, the API only supports getting, creating and updating audiences using advanced targeting expressions.
Terminology
| Term | Description |
|---|---|
| Advanced Targeting Expression | The term used to describe the construction of targeting types and codes to set targeting for a particular audience. |
| Targeting Type |
Sub-category within the parent targeting type. For example, "viant.taxonomy" is a targeting type and translates to Viant Segments in the UI. See full list of available targeting types in the section below titled, "Advanced Audience Targeting Types". |
| Code |
The value set for the Targeting Type. For example: viant.taxonomy:["51256","51271","52056"]. This expression would be targeting users with Viant Segments 51256, 51271, or 52056.For a full list of available codes download the Targeting Meta Data file in the Account Bulk Edit page in the UI. |
| Target | Only accepts bid requests with specified values. Bid requests with NULL or non-matching values are not accepted. |
| Exclude | Does not accept bid requests with specified values. Bid requests with NULL or non-matching values are accepted. |
Boolean Logic
An Advanced targeting expression supports the use of "AND" and "OR". It does not support the use of "NOT". It only allows for a series of ANDs to be followed by a series of ORs. Otherwise, parentheses must be used.
| Validity | Targeting Expression |
|---|---|
| Valid | provider.taxonomy:["1"] AND user.demographic.age:["2"] OR dv.fraud:["3"] |
| Not Valid | provider.taxonomy:["1"] OR dv.fraud:["3"] AND user.demographic.age:["2"] |
| Valid | provider.taxonomy:["1"] OR (dv.fraud:["3"] AND user.demographic.age:["2"]) |
Enabling Cross Device
To enable cross device targeting add a "x#" before the ID.
For example: user.segment:["x#8892"]
The following Targeting Types support cross device:
| Category | Targeting Type |
|---|---|
| Data | dmp.adobe.id |
| Data | ninthdecimal.taxonomy |
| Data | provider.taxonomy |
| Data | pushspring.taxonomy |
| Data | user.segment |