- Zasób: FirstAndThirdPartyAudience
- FirstAndThirdPartyAudienceType
- AudienceType
- AudienceSource
- ContactInfoList
- ContactInfo
- Zgoda
- ConsentStatus
- MobileDeviceIdList
- Metody
Zasób: FirstAndThirdPartyAudience
Opisuje listę odbiorców własnych lub pochodzących od innych firm używaną do kierowania reklam. Listy odbiorców własnych są tworzone na podstawie danych klienta. Listy odbiorców pochodzą od zewnętrznych dostawców danych i mogą być licencjonowane tylko dla klientów.
Zapis JSON |
---|
{ "name": string, "firstAndThirdPartyAudienceId": string, "displayName": string, "description": string, "firstAndThirdPartyAudienceType": enum ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. Nazwa zasobu z własną listą odbiorców i listą odbiorców dostarczoną przez firmę zewnętrzną. |
firstAndThirdPartyAudienceId |
Tylko dane wyjściowe. Niepowtarzalny identyfikator własnej listy odbiorców i listy odbiorców dostarczonej przez firmę zewnętrzną. Przypisany przez system. |
displayName |
Wyświetlana nazwa listy odbiorców własnej lub zewnętrznej. |
description |
Podany przez użytkownika opis listy odbiorców. Dotyczy to tylko własnych list odbiorców. |
firstAndThirdPartyAudienceType |
Określa, czy lista odbiorców jest własna czy zewnętrzna. |
audienceType |
Typ listy odbiorców. |
audienceSource |
Tylko dane wyjściowe. Źródło odbiorców. |
membershipDurationDays |
Liczba dni, przez którą wpis pozostaje na liście odbiorców po spełnieniu kryterium. Jeśli lista odbiorców nie ma daty wygaśnięcia, ustaw wartość tego pola na 10000. W przeciwnym razie ustawiona wartość musi być większa od 0, ale nie większa niż 540. Dotyczy to tylko własnych list odbiorców. To pole jest wymagane, jeśli używana jest jedna z tych wartości
|
displayAudienceSize |
Tylko dane wyjściowe. Szacunkowa wielkość grupy odbiorców w sieci reklamowej. Jeśli rozmiar jest mniejszy niż 1000, liczba zostanie ukryta, a z powodu ochrony prywatności zwrócona zostanie wartość 0. W przeciwnym razie liczba zostanie zaokrąglona do 2 cyfr znaczących. Zwracany tylko w żądaniu GET. |
activeDisplayAudienceSize |
Tylko dane wyjściowe. Szacowana wielkość grupy odbiorców w sieci reklamowej w ostatnim miesiącu. Jeśli rozmiar jest mniejszy niż 1000, liczba zostanie ukryta, a z powodu ochrony prywatności zwrócona zostanie wartość 0. W przeciwnym razie liczba zostanie zaokrąglona do 2 cyfr znaczących. Zwracany tylko w żądaniu GET. |
youtubeAudienceSize |
Tylko dane wyjściowe. Szacunkowa wielkość grupy odbiorców w sieci reklamowej YouTube. Jeśli rozmiar jest mniejszy niż 1000, liczba zostanie ukryta, a z powodu ochrony prywatności zwrócona zostanie wartość 0. W przeciwnym razie liczba zostanie zaokrąglona do 2 cyfr znaczących. Dotyczy to tylko własnych list odbiorców. Zwracany tylko w żądaniu GET. |
gmailAudienceSize |
Tylko dane wyjściowe. Szacunkowa wielkość grupy odbiorców w sieci Gmail. Jeśli rozmiar jest mniejszy niż 1000, liczba zostanie ukryta, a z powodu ochrony prywatności zwrócona zostanie wartość 0. W przeciwnym razie liczba zostanie zaokrąglona do 2 cyfr znaczących. Dotyczy to tylko własnych list odbiorców. Zwracany tylko w żądaniu GET. |
displayMobileAppAudienceSize |
Tylko dane wyjściowe. Szacowana wielkość grupy odbiorców aplikacji mobilnej w sieci reklamowej. Jeśli rozmiar jest mniejszy niż 1000, liczba zostanie ukryta, a z powodu ochrony prywatności zwrócona zostanie wartość 0. W przeciwnym razie liczba zostanie zaokrąglona do 2 cyfr znaczących. Dotyczy to tylko własnych list odbiorców. Zwracany tylko w żądaniu GET. |
displayMobileWebAudienceSize |
Tylko dane wyjściowe. Szacunkowa wielkość grupy odbiorców w internecie mobilnym w sieci reklamowej. Jeśli rozmiar jest mniejszy niż 1000, liczba zostanie ukryta, a z powodu ochrony prywatności zwrócona zostanie wartość 0. W przeciwnym razie liczba zostanie zaokrąglona do 2 cyfr znaczących. Dotyczy to tylko własnych list odbiorców. Zwracany tylko w żądaniu GET. |
displayDesktopAudienceSize |
Tylko dane wyjściowe. Szacunkowa wielkość grupy odbiorców na komputerach w sieci reklamowej. Jeśli rozmiar jest mniejszy niż 1000, liczba zostanie ukryta, a z powodu ochrony prywatności zwrócona zostanie wartość 0. W przeciwnym razie liczba zostanie zaokrąglona do 2 cyfr znaczących. Dotyczy to tylko własnych list odbiorców. Zwracany tylko w żądaniu GET. |
appId |
Identyfikator aplikacji musi być zgodny z typem przesyłanych identyfikatorów urządzeń mobilnych. Dotyczy tylko |
Pole unii members . Pierwsi członkowie listy odbiorców kierowania na listę klientów. members może być tylko jednym z tych elementów: |
|
contactInfoList |
Tylko dane wejściowe. Lista informacji kontaktowych, która służy do definiowania początkowych członków listy odbiorców. Dotyczy tylko |
mobileDeviceIdList |
Tylko dane wejściowe. Lista identyfikatorów urządzeń mobilnych, która służy do definiowania początkowych członków listy odbiorców. Dotyczy tylko |
FirstAndThirdPartyAudienceType
Możliwe typy własnych i zewnętrznych list odbiorców
Wartości w polu enum | |
---|---|
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED |
Wartość domyślna, gdy typ nie jest określony lub jest nieznany. |
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY |
Lista odbiorców utworzona na podstawie danych klienta. |
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY |
Odbiorcy udostępniani przez zewnętrznych dostawców danych. |
AudienceType
Możliwe typy odbiorców
Wartości w polu enum | |
---|---|
AUDIENCE_TYPE_UNSPECIFIED |
Wartość domyślna, gdy typ nie jest określony lub jest nieznany. |
CUSTOMER_MATCH_CONTACT_INFO |
Lista odbiorców została utworzona przez dopasowanie klientów do znanych informacji kontaktowych. |
CUSTOMER_MATCH_DEVICE_ID |
Lista odbiorców została utworzona przez dopasowanie klientów do znanych identyfikatorów urządzeń mobilnych. |
CUSTOMER_MATCH_USER_ID |
Lista odbiorców została utworzona przez dopasowanie klientów do znanych identyfikatorów użytkowników. |
ACTIVITY_BASED |
Lista odbiorców została utworzona na podstawie aktywności w kampanii. |
FREQUENCY_CAP |
Lista odbiorców została utworzona na podstawie wykluczenia liczby wyświetleń, które zobaczyli. |
TAG_BASED |
Lista odbiorców została utworzona na podstawie zmiennych niestandardowych przypisanych do piksela. |
YOUTUBE_USERS |
Lista odbiorców została utworzona na podstawie wcześniejszych interakcji z filmami, reklamami w YouTube lub kanałem w YouTube. |
LICENSED |
Podtyp typu listy odbiorców dostarczonej przez firmę zewnętrzną. |
AudienceSource
Możliwe źródła danych o odbiorcach
Wartości w polu enum | |
---|---|
AUDIENCE_SOURCE_UNSPECIFIED |
Wartość domyślna, gdy źródło listy odbiorców nie jest określone lub jest nieznane. |
DISPLAY_VIDEO_360 |
pochodzi z Display & Video 360, |
CAMPAIGN_MANAGER |
Pochodzi z Campaign Managera 360. |
AD_MANAGER |
Pochodzi z Google Ad Managera. |
SEARCH_ADS_360 |
Pochodzi z Search Ads 360. |
YOUTUBE |
Pochodzi z YouTube. |
ADS_DATA_HUB |
Pochodzi z Centrum danych reklam. |
ContactInfoList
Komunikat opakowujący listę informacji kontaktowych definiujących członków listy odbiorców kierowania na listę klientów.
Zapis JSON |
---|
{ "contactInfos": [ { object ( |
Pola | |
---|---|
contactInfos[] |
Lista obiektów ContactInfo, które definiują członków listy odbiorców z kierowania na listę klientów. Liczba elementów members po podzieleniu informacji kontaktowych nie może być większa niż 500 tys. |
consent |
Tylko dane wejściowe. Ustawienie zgody użytkowników w Pozostawienie tego pola pustego oznacza, że nie wyrażono zgody. Jeśli pola |
ContactInfo
Dane kontaktowe określające odbiorcę listy odbiorców kierowania na listę klientów.
Zapis JSON |
---|
{ "hashedEmails": [ string ], "hashedPhoneNumbers": [ string ], "zipCodes": [ string ], "hashedFirstName": string, "hashedLastName": string, "countryCode": string } |
Pola | |
---|---|
hashedEmails[] |
Lista adresów e-mail członka zaszyfrowanych za pomocą algorytmu SHA256. Przed zaszyfrowaniem usuń wszystkie spacje i upewnij się, że ciąg znaków jest zapisany wyłącznie małymi literami. |
hashedPhoneNumbers[] |
Lista numerów telefonów członka zaszyfrowanych za pomocą algorytmu SHA256. Przed zaszyfrowaniem wszystkie numery telefonów muszą być sformatowane zgodnie z formatem E.164 i mieć kod kraju. |
zipCodes[] |
Lista kodów pocztowych członka. Musisz też ustawić te pola: |
hashedFirstName |
Imię użytkownika zaszyfrowane za pomocą algorytmu SHA-256. Przed zaszyfrowaniem usuń wszystkie spacje i upewnij się, że ciąg znaków jest zapisany wyłącznie małymi literami. Musisz też ustawić te pola: |
hashedLastName |
Hasz SHA256 nazwiska użytkownika. Przed zaszyfrowaniem usuń wszystkie spacje i upewnij się, że ciąg znaków jest zapisany wyłącznie małymi literami. Musisz też ustawić te pola: |
countryCode |
Kod kraju użytkownika. Musisz też ustawić te pola: |
Zgoda
Stan zgody użytkownika.
Zapis JSON |
---|
{ "adUserData": enum ( |
Pola | |
---|---|
adUserData |
Reprezentuje zgodę na korzystanie z danych użytkowników reklam. |
adPersonalization |
Reprezentuje zgodę na personalizację reklam. |
ConsentStatus
Stan zgody.
Wartości w polu enum | |
---|---|
CONSENT_STATUS_UNSPECIFIED |
Wartość typu nie została określona lub jest nieznana w tej wersji. |
CONSENT_STATUS_GRANTED |
Zgoda została udzielona. |
CONSENT_STATUS_DENIED |
Odmowa zgody. |
MobileDeviceIdList
Wiadomość opakowująca listę identyfikatorów urządzeń mobilnych, która określa członków listy odbiorców kierowania na listę klientów.
Zapis JSON |
---|
{
"mobileDeviceIds": [
string
],
"consent": {
object ( |
Pola | |
---|---|
mobileDeviceIds[] |
Lista identyfikatorów urządzeń mobilnych definiujących członków listy odbiorców kierowania na listę klientów. Rozmiar identyfikatorów mobileDeviceId nie może przekraczać 500 tys. |
consent |
Tylko dane wejściowe. Ustawienie zgody użytkowników w Pozostawienie tego pola pustego oznacza, że nie wyrażono zgody. Jeśli pola |
Metody |
|
---|---|
|
Tworzy listę odbiorców FirstAndThirdPartyAudience. |
|
Aktualizuje listę użytkowników odbiorców kierowania na listę klientów. |
|
Pobiera własną listę odbiorców i listę odbiorców dostarczoną przez firmę zewnętrzną. |
|
Wyświetla listy własnych i dostarczonych przez inną firmę list odbiorców. |
|
Aktualizuje dotychczasowy zbiór odbiorców FirstAndThirdPartyAudience. |