Od
8 września 2025 r. każdy nowy element zamówienia będzie musiał deklarować, czy będzie wyświetlać reklamy polityczne w Unii Europejskiej (UE). Przesyłanie plików SDF i wywoływanie interfejsu Display & Video 360 API bez deklaracji zakończy się niepowodzeniem. Więcej informacji o tym, jak zaktualizować integrację, aby złożyć to oświadczenie, znajdziesz na naszej
stronie dotyczącej wycofania.
Typy odbiorców
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Na tej stronie opisujemy dostępne typy odbiorców i sposób ich pobierania za pomocą interfejsu Display & Video 360 API.
Odbiorcy Google
Odbiorcy Google to listy użytkowników o określonym podobieństwie, zdarzeniu z życia lub zamiarze zakupu. Listy odbiorców są tworzone i utrzymywane przez Google. Za pomocą metody googleAudiences.list możesz pobrać dostępne zasoby GoogleAudience.
Własne listy odbiorców i listy odbiorców partnera
Listy odbiorców utworzone za pomocą danych własnych lub danych partnera są reprezentowane w interfejsie Display & Video 360 API jako zasoby FirstPartyAndPartnerAudience. Ten zasób obejmuje w polu audienceType kilka typów list odbiorców, m.in. listy kierowania na listę klientów, listy oparte na tagach, listy oparte na aktywności i listy licencjonowane.
Listy odbiorców własnych i dostarczonych przez firmę zewnętrzną możesz pobrać za pomocą metody firstPartyAndPartnerAudiences.list. W zależności od tego, czy żądanie używa identyfikatora reklamodawcy, czy jego nadrzędnego partnera w wymaganym parametrze z użyciem funkcji złączenia accessor, mogą zostać zwrócone różne listy odbiorców.
Listy odbiorców z kierowania na listę klientów utworzone na podstawie danych kontaktowych klientów lub identyfikatorów urządzeń mobilnych możesz tworzyć i aktualizować za pomocą interfejsu Display & Video 360 API. Więcej informacji znajdziesz na stronie Przesyłanie listy odbiorców dopasowania do klientów w dalszej części tego przewodnika. Listy odbiorców z kierowania na listę klientów, a także inne własne listy odbiorców możesz tworzyć w interfejsie Display & Video 360.
Listy niestandardowe
Listy klientów umożliwiają klientom Display & Video 360 kierowanie reklam na użytkowników, którzy wykazali określone zainteresowania lub szukają określonych produktów. Listy niestandardowe możesz tworzyć w interfejsie Display & Video 360. Dostępne zasoby CustomList możesz pobrać za pomocą interfejsu Display & Video 360 API, korzystając z metody customLists.list.
Połączone grupy odbiorców
Odbiorcy z połączonych list to listy odbiorców konfigurowane przez użytkownika, utworzone przez złączenie i przecięcie dotychczasowych list odbiorców Google, własnych i od innych firm. Możesz je tworzyć w interfejsie Display & Video 360. Za pomocą metody combinedAudiences.list możesz pobrać dostępne zasoby CombinedAudience.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-25 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."]]
