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 identyfikatorowi [Customer.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#customer] w interfejsie Google Ads API,
GOOGLE_ADS_CAMPAIGN	Kampania Google Ads entityId odpowiada identyfikatorowi [Campaign.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#campaign] w interfejsie Google Ads API.
GMP_CM_ACCOUNT	Konto Campaign Managera Google Marketing Platform. entityId odpowiada adresowi [Accounts.id][https://developers.google.com/doubleclick-advertisers/v3.3/accounts].
GMP_CM_FLOODLIGHT	Konto Floodlight w usłudze Campaign Manager. entityId odpowiada [FloodlightConfigurations.accountId][https://developers.google.com/doubleclick-advertisers/v3.3/floodlightConfigurations].
GMP_DV360_PARTNER	Identyfikator partnera w Display &Video 360. entityId to identyfikator partnera DV360.
GMP_DV360_ADVERTISER	Identyfikator reklamodawcy w Display &Video 360. entityId to identyfikator reklamodawcy DV360.
GMP_DV360_ORDER	Identyfikator zamówienia w Display &Video 360. entityId to identyfikator zamówienia w DV360.
GMP_DV360_LINE_ITEM	Identyfikator elementu zamówienia w Display &Video 360. entityId to identyfikator elementu zamówienia DV360.
YT_RESERVE_ORDER	Identyfikator zamówienia YouTube Reserve. entityId odpowiada identyfikatorowi [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id] w Menedżerze Google Ads.
YT_RESERVE_LINE_ITEM	Element zamówienia YouTube Reserve. entityId odpowiada [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id] w Menedżerze Google Ads.
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 identyfikatorowi [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id] w Menedżerze Google Ads.
GOOGLE_AD_MANAGER_LINE_ITEM	elementu zamówienia Google Ad Managera. entityId odpowiada [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id] w Menedżerze Google Ads.

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	Element jest powiązany z YouTube Reserve.
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 z DV360 w YouTube.
GMP_EXPORT_SCOPE_DT	Należy eksportować 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.