Stay organized with collectionsSave and categorize content based on your preferences.
Entity: Audiences
Field
Required
Type
Description
ID
Required only when editing an existing entity.
String
Numeric ID value of the audience. If left blank, a new audience will be created and a unique ID will be assigned.
Name
Yes
String
The name of the audience.
Advertiser ID
(Read-only)
No
Long
Numeric ID value of the Advertiser who owns the audience.
Ownership
(Read-only)
No
Enum
The type of ownership of the audience with respect to the current advertiser. Possible values: 'Owned' | 'Shared'.
Floodlight activity ID
Yes
String
Numeric ID value of the parent Floodlight activity. You can specify any alphanumeric identifier for an activity that you are creating at the same time as the audience.
Floodlight activity name
(Read-only)
No
String
The name of the Floodlight activity associated with the audience.
Audience type
No
Enum
The type of the rule of the audience. Possible values: 'All visitors' | 'Custom rule' | 'Other'.
Membership lifespan
No
Long
The number of days a user remains a member of an audience before being removed due to inactivity. The default value is 30 days.
Description
No
String
The description of the audience.
Status
No
Enum
The status of the audience. Archiving (deactivating) a list prevents it from collecting additional users, but it won’t deactivate the ad associated with the list. Existing users will remain on the list until their memberships expire. Possible values: 'Active' | 'Archived'.
Source
(Read-only)
No
Enum
The source of the audience.
Number of members
(Read-only)
No
Long
The number of members on the audience.
Shared advertiser IDs
No
List
The numaric ID values of the advertisers to whom the audience is shared. When updating the existing audience, use the advertiser IDs to add and the negative advertiser IDs to remove. The field will only display up to 1000 IDs in the downloaded sheet. A '"TRUNCATED"' prefix will be added to the field if the audience is shared to more than 1000 advertisers.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eAudiences are defined by Floodlight activities and can be used to target specific user groups based on their interactions with your website or app.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage an audience's membership lifespan, description, and status (active or archived) to control its usage and data collection.\u003c/p\u003e\n"],["\u003cp\u003eAudiences can be shared with other advertisers, and you can view the number of members and ownership details for each audience.\u003c/p\u003e\n"],["\u003cp\u003eEssential audience details such as ID, name, Floodlight activity, and audience type are required for creation and management.\u003c/p\u003e\n"],["\u003cp\u003eAudience data provides insights like the advertiser ID, ownership, source, and number of members, offering valuable information for analysis and optimization.\u003c/p\u003e\n"]]],[],null,["# Bulk Sheet Entity Reference\n\nEntity: Audiences\n-----------------\n\n| Field | Required | Type | Description |\n|--------------------------------------|------------------------------------------------|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ID | Required only when editing an existing entity. | String | Numeric ID value of the audience. If left blank, a new audience will be created and a unique ID will be assigned. |\n| Name | Yes | String | The name of the audience. |\n| Advertiser ID (Read-only) | No | Long | Numeric ID value of the Advertiser who owns the audience. |\n| Ownership (Read-only) | No | Enum | The type of ownership of the audience with respect to the current advertiser. Possible values: 'Owned' \\| 'Shared'. |\n| Floodlight activity ID | Yes | String | Numeric ID value of the parent Floodlight activity. You can specify any alphanumeric identifier for an activity that you are creating at the same time as the audience. |\n| Floodlight activity name (Read-only) | No | String | The name of the Floodlight activity associated with the audience. |\n| Audience type | No | Enum | The type of the rule of the audience. Possible values: 'All visitors' \\| 'Custom rule' \\| 'Other'. |\n| Membership lifespan | No | Long | The number of days a user remains a member of an audience before being removed due to inactivity. The default value is 30 days. |\n| Description | No | String | The description of the audience. |\n| Status | No | Enum | The status of the audience. Archiving (deactivating) a list prevents it from collecting additional users, but it won't deactivate the ad associated with the list. Existing users will remain on the list until their memberships expire. Possible values: 'Active' \\| 'Archived'. |\n| Source (Read-only) | No | Enum | The source of the audience. |\n| Number of members (Read-only) | No | Long | The number of members on the audience. |\n| Shared advertiser IDs | No | List | The numaric ID values of the advertisers to whom the audience is shared. When updating the existing audience, use the advertiser IDs to add and the negative advertiser IDs to remove. The field will only display up to 1000 IDs in the downloaded sheet. A '\"TRUNCATED\"' prefix will be added to the field if the audience is shared to more than 1000 advertisers. |"]]
