REST Resource: customers.adsDataLinks

• Zasób: AdsDataLink
  • Zapis JSON
• Jednostka
  • Zapis JSON
• Typ encji
• Platforma
• Dane
• GmpExportScope
• Metody

Zasób: AdsDataLink

Reprezentuje link do danych reklamowych.

Zapis JSON
{ "name": string, "linkedEntity": { object (Entity) }, "parentEntity": { object (Entity) }, "childEntities": [ { object (Entity) } ], "platform": enum (Platform), "customerLink": { object (CustomerLink) }, "status": enum (LinkStatus), "createTime": string, "updateTime": string, "vendorClientId": string, "metrics": [ enum (Metric) ], "gmpExportScopes": [ enum (GmpExportScope) ] }

Pola
name	string Nazwa, która jednoznacznie identyfikuje zasób AdsDataLink. Ma ona format klienci/[identyfikator klienta]/adsDataLinks/[identyfikator_zasobu]. Identyfikator zasobu jest generowany przez serwer.
linkedEntity	object (Entity) Element połączony przez ten link AdsDataLink.
parentEntity	object (Entity) Powiązany podmiot nadrzędny (jeśli istnieje). Jeśli połączony podmiot jest kampanią Google Ads, to pole będzie zawierać odpowiedniego klienta Google Ads, do którego należy kampania.
childEntities[]	object (Entity) Powiązane elementy podrzędne, jeśli istnieją. Jeśli połączony podmiot jest klientem Google Ads odpowiadającym łączu menedżera klienta, elementy podrzędne będą zawierać w pełni rozszerzony zbiór klientów Google Ads z danymi zaimportowanymi do Centrum danych reklam za pomocą tego połączenia.
platform	enum (Platform) Platforma reklamowa powiązana z połączonym podmiotem.
customerLink	object (CustomerLink) Link klienta, przez który można otwierać połączone dane. Wypełniono tylko nazwę, identyfikator klienta i wyświetlaną nazwę.
status	enum (LinkStatus) Stan połączenia danych.
createTime	string (Timestamp format) Czas utworzenia połączenia. Sygnatura czasowa w formacie RFC3339 UTC &Zulu" z rozdzielczością nanosekundy i do 9 cyfr po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
updateTime	string (Timestamp format) Czas ostatniej aktualizacji stanu połączenia. Sygnatura czasowa w formacie RFC3339 UTC &Zulu" z rozdzielczością nanosekundy i do 9 cyfr po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
vendorClientId	string Identyfikator dostawcy klienta (jeśli istnieje).
metrics[]	enum (Metric) Dane dostępne po kliknięciu tego linku. Brak wartości oznacza, że nie obowiązują żadne ograniczenia dotyczące danych. To pole jest obecnie tylko pojedyncze. Jest obsługiwane tylko wtedy, gdy typ elementu połączenia to GOOGLE_ADS_CAMPAIGN lub YT_RESERVE_LINE_ITEM.
gmpExportScopes[]	enum (GmpExportScope) Typy danych, które będą eksportowane do połączeń Display &Video 360. Wartość wypełniana tylko wtedy, gdy platforma to GOOGLE_MARKETING_PLATFORM. Brak wartości oznacza, że dane nie są określone, a ich kombinacje mogą być dostępne.

Jednostka

Reprezentuje podmiot reklamowy, który można połączyć z klientem Centrum danych reklam.

Zapis JSON
{ "entityId": string, "displayName": string, "type": enum (EntityType) }

Pola
entityId	string (int64 format) Identyfikator jednostki. Podana tutaj wartość zależy od typu encji.
displayName	string Wyświetlana nazwa elementu.
type	enum (EntityType) Typ połączonej jednostki.

Typ encji

Obsługiwane jednostki reklamowe.

Wartości w polu enum
ENTITY_TYPE_UNSPECIFIED	Nieokreślony typ encji.
GOOGLE_ADS_CUSTOMER	Klientem Google Ads entityId odpowiada Customer.id w interfejsie Google Ads API.
GOOGLE_ADS_CAMPAIGN	Kampania Google Ads entityId odpowiada Campaign.id w interfejsie Google Ads API.
GMP_CM_ACCOUNT	Konto Campaign Managera 360. entityId odpowiada Accounts.id w interfejsie Campaign Manager 360 API.
GMP_CM_FLOODLIGHT	Konto Floodlight w usłudze Campaign Manager 360. entityId odpowiada FloodlightConfigurations.accountId w interfejsie Campaign Manager 360 API.
GMP_DV360_PARTNER	Identyfikator partnera w Display &Video 360. entityId to identyfikator partnera Display &Video 360.
GMP_DV360_ADVERTISER	Identyfikator reklamodawcy w Display &Video 360. entityId to identyfikator reklamodawcy w Display &Video 360.
GMP_DV360_ORDER	Identyfikator zamówienia w Display &Video 360. entityId to identyfikator zamówienia z Display &Video 360.
GMP_DV360_LINE_ITEM	Identyfikator elementu zamówienia w Display &Video 360. entityId to identyfikator elementu zamówienia w Display &Video 360.
YT_RESERVE_ORDER	Identyfikator zamówienia YouTube Reserve. entityId odpowiada Order.id w interfejsie Google Ad Manager API.
YT_RESERVE_LINE_ITEM	Element zamówienia YouTube Reserve. entityId odpowiada LineItem.id w interfejsie Google Ad Manager API.
VENDOR_CLIENT_ID_REGISTRATION	Identyfikator klienta dostawcy, który został ręcznie zarejestrowany przez zewnętrznego dostawcę technologii reklamowych na potrzeby zewnętrznych pomiarów.
GOOGLE_AD_MANAGER_ORDER	Identyfikator zamówienia w usłudze Google Ad Manager. entityId odpowiada Order.id w interfejsie Google Ad Manager API.
GOOGLE_AD_MANAGER_LINE_ITEM	elementu zamówienia Google Ad Managera. entityId odpowiada LineItem.id w interfejsie Google Ad Manager API.

Platforma

Obsługiwane platformy reklamowe.

Wartości w polu enum
PLATFORM_UNSPECIFIED	Nieokreślona platforma.
GOOGLE_ADS	Ten element jest powiązany z Google Ads.
GOOGLE_MARKETING_PLATFORM	Element jest powiązany z usługą Google Marketing Platform.
YOUTUBE_RESERVE	Podmiot jest powiązany z rezerwacją w YouTube.
GOOGLE_AD_MANAGER	Ten element jest powiązany z Google Ad Managerem.
FREEWHEEL	Element jest powiązany z FreeWheel.

Dane

Dane, które można wyświetlać za pomocą linków z danymi reklam.

Wartości w polu enum
METRIC_UNSPECIFIED	Nieokreślone dane.
BRAND_LIFT	Dane odpowiadające Wynikom marki.
BRAND_SAFETY	Wartość odpowiadająca bezpieczeństwu marki.
REACH	Dane odpowiadające zasięgowi, gdzie klient jest reklamodawcą.
VIEWABILITY	Wartość odpowiadająca widoczności, w której klient jest reklamodawcą.
PUBLISHER_REACH	Dane odpowiadające zasięgowi, gdzie klient jest wydawcą lub dostawcą treści.
PUBLISHER_VIEWABILITY	Wartość odpowiadająca widoczności, w której klient jest wydawcą lub dostawcą treści.

Zakres eksportu Gmp

Różne typy danych, które można eksportować na potrzeby linków do GMP.

Wartości w polu enum
GMP_EXPORT_SCOPE_UNSPECIFIED	Nieokreślony zakres.
GMP_EXPORT_SCOPE_YT_TRUEVIEW	Powinien eksportować dane TrueView w Display &Video 360 z YouTube.
GMP_EXPORT_SCOPE_DT	Należy wyeksportować dane z Przenoszenia danych.

Metody
batchApprove	Zaakceptuj listę oczekujących połączeń z danymi dotyczącymi reklam.
batchReject	Odrzuć listę linków do oczekujących danych z reklam.
list	Wyświetla linki między określonym klientem a innymi jednostkami reklamowymi Google.