The request object can contain the following fields:
Field | Modifier | Type | Description |
---|---|---|---|
| Required | String | A unique name for the audience. -- |
| Optional Default = 8760 (1 year) | Integer | Period of time (in hours) for which a give user will belong to this audience. |
| Optional Default = | Boolean | If set to |
| Optional | String | This field is for 3rd-party platforms only. Advertisers managing their own audiences can ignore this field. Used for integration tracking and diagnostics. Pass the name of the integration partner - e.g. Use a naming convention of your preference. |
If you leave out the
ttl
param, the default value is 8760 (1 year).
All field values are final - they cannot be changed once the audience has been created.
For use by 3rd-party platforms only. Specifies the name of the integration partner (e.g., a CDP, DMP) creating the audience. This value is used for integration tracking and diagnostics.
Direct advertisers managing their own audiences should not use this field.
Example values: "Tealium", "Segment", "LiveRamp".
When used, please pass the same value consistently throughout the lifecycle of the audience.