Starting
September 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our
deprecations page for more details on how to update your integration to make this declaration.
Audience Types
Stay organized with collections
Save and categorize content based on your preferences.
This page describes the available audience types and specifies how they can be
retrieved using the Display & Video 360 API.
Google Audiences
Google Audiences are lists of users with an identified affinity, life event, or
recent purchase intent. Audiences are created and maintained by Google. You can
retrieve available GoogleAudience resources using the
googleAudiences.list method.
First-party and partner audiences
Audiences created using first-party or partner data are represented in the
Display & Video 360 API as FirstPartyAndPartnerAudience resources. This
resource encompasses a number of individual audience types, including Customer
Match, tag-based, activity-based, and licensed audiences, in the resource's
audienceType field.
You can retrieve first and third-party audiences using the
firstPartyAndPartnerAudiences.list method. Different lists of
audiences may be returned depending on whether the request uses the ID of an
advertiser or its parent partner in the required
accessor union parameter.
You can create and update Customer Match audiences generated using customer
contact information or mobile device IDs through the Display & Video 360 API. See the
Upload Customer Match Audience page later in this guide for
more information. You can also create Customer Match audiences, along with other
types first-party audiences, through the Display & Video 360 UI.
Custom lists
Custom lists allow Display & Video 360 customers to target users who have
indicated specific interests or are looking for specific items. You can create
custom lists through the Display & Video 360 UI. You can retrieve available
CustomList resources through the Display & Video 360 API using the
customLists.list method.
Combined audiences
Combined audiences are user-configured audiences created by the union
and intersection of existing Google, first-party, and third-party audiences. You
can create them through the Display & Video 360 UI. You can retrieve available
CombinedAudience resources using the
combinedAudiences.list method.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-04-09 UTC.
[null,null,["Last updated 2025-04-09 UTC."],[[["\u003cp\u003eThis page explains how to retrieve different audience types, including Google Audiences, first- and third-party audiences, custom lists, and combined audiences, using the Display & Video 360 API.\u003c/p\u003e\n"],["\u003cp\u003eGoogle provides Google Audiences, while first- and third-party audiences are based on your own or third-party data and encompass various types like Customer Match, tag-based, activity-based, and licensed audiences.\u003c/p\u003e\n"],["\u003cp\u003eCustom lists target users with specific interests, are created in the Display & Video 360 UI, and can be retrieved via the API.\u003c/p\u003e\n"],["\u003cp\u003eCombined audiences are user-defined combinations of other audience types, created in the Display & Video 360 UI, and retrievable using the API.\u003c/p\u003e\n"]]],[],null,["# Audience Types\n\nThis page describes the available audience types and specifies how they can be\nretrieved using the Display \\& Video 360 API.\n\nGoogle Audiences\n----------------\n\nGoogle Audiences are lists of users with an identified affinity, life event, or\nrecent purchase intent. Audiences are created and maintained by Google. You can\nretrieve available [`GoogleAudience`](/display-video/api/reference/rest/current/googleAudiences#GoogleAudience) resources using the\n[`googleAudiences.list`](/display-video/api/reference/rest/current/googleAudiences/list) method.\n| **Key Point:** [Extended Demographic Google Audiences](/display-video/api/reference/rest/current/googleAudiences#GoogleAudienceType.ENUM_VALUES.GOOGLE_AUDIENCE_TYPE_EXTENDED_DEMOGRAPHIC) are not retrievable or targetable using the Display \\& Video 360 API.\n\nFirst-party and partner audiences\n---------------------------------\n\nAudiences created using first-party or partner data are represented in the\nDisplay \\& Video 360 API as [`FirstPartyAndPartnerAudience`](/display-video/api/reference/rest/current/firstPartyAndPartnerAudiences#FirstPartyAndPartnerAudience) resources. This\nresource encompasses a number of individual audience types, including Customer\nMatch, tag-based, activity-based, and licensed audiences, in the resource's\n[`audienceType`](/display-video/api/reference/rest/current/firstPartyAndPartnerAudiences#FirstPartyAndPartnerAudience.FIELDS.audience_type) field.\n\nYou can retrieve first and third-party audiences using the\n[`firstPartyAndPartnerAudiences.list`](/display-video/api/reference/rest/current/firstPartyAndPartnerAudiences/list) method. Different lists of\naudiences may be returned depending on whether the request uses the ID of an\nadvertiser or its parent partner in the required\n[`accessor`](/display-video/api/reference/rest/current/firstPartyAndPartnerAudiences/list#body.QUERY_PARAMETERS.oneof_accessor) union parameter.\n| **Note:** [Estimated audience size fields](/display-video/api/reference/rest/current/firstPartyAndPartnerAudiences#FirstPartyAndPartnerAudience.FIELDS.display_audience_size) are available in the resource object, but are only included in the resource when individually retrieved using the [`firstPartyAndPartnerAudiences.get`](/display-video/api/reference/rest/current/firstPartyAndPartnerAudiences/get) method.\n\nYou can create and update Customer Match audiences generated using customer\ncontact information or mobile device IDs through the Display \\& Video 360 API. See the\n[Upload Customer Match Audience](/display-video/api/guides/audiences/upload-customer-match) page later in this guide for\nmore information. You can also create Customer Match audiences, along with other\ntypes first-party audiences, through the Display \\& Video 360 UI.\n\nCustom lists\n------------\n\n[Custom lists](//support.google.com/displayvideo/answer/7583366) allow Display \\& Video 360 customers to target users who have\nindicated specific interests or are looking for specific items. You can create\ncustom lists through the Display \\& Video 360 UI. You can retrieve available\n[`CustomList`](/display-video/api/reference/rest/current/customLists#CustomList) resources through the Display \\& Video 360 API using the\n[`customLists.list`](/display-video/api/reference/rest/current/customLists/list) method.\n\nCombined audiences\n------------------\n\n[Combined audiences](//support.google.com/displayvideo/answer/9001225) are user-configured audiences created by the union\nand intersection of existing Google, first-party, and third-party audiences. You\ncan create them through the Display \\& Video 360 UI. You can retrieve available\n[`CombinedAudience`](/display-video/api/reference/rest/current/combinedAudiences#CombinedAudience) resources using the\n[`combinedAudiences.list`](/display-video/api/reference/rest/current/combinedAudiences/list) method."]]
