REST Resource: customers.adsDataLinks

• Risorsa: AdsDataLink
  • Rappresentazione JSON
• Entità
  • Rappresentazione JSON
• Tipo di entità
• Piattaforma
• Metrica
• GmpExportScope
• Metodi

Risorsa: AdsDataLink

Rappresenta un link ai dati pubblicitari.

Rappresentazione 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) ] }

Campi
name	string Nome che identifica in modo univoco una risorsa AdsDataLink. Il formato è customer//customerId]/adsDataLinks/[resource_id]. L'ID risorsa è generato dal server.
linkedEntity	object (Entity) Entità collegata tramite questo AdsDataLink.
parentEntity	object (Entity) Entità correlata correlata, se presente. Se l'entità collegata è una campagna Google Ads, questo campo conterrà un cliente Google Ads corrispondente a cui appartiene la campagna.
childEntities[]	object (Entity) Eventuali entità secondarie correlate. Se l'entità collegata è un cliente Google Ads che corrisponde a un link da amministratore cliente, allora le entità secondarie includeranno un insieme completamente espanso di clienti Google Ads con i dati importati in Ads Data Hub tramite questo link.
platform	enum (Platform) Piattaforma pubblicitaria associata all'entità collegata.
customerLink	object (CustomerLink) Link del cliente tramite il quale è possibile accedere ai dati collegati. Vengono compilati solo il nome, l'ID cliente e il nome visualizzato.
status	enum (LinkStatus) Stato del link dei dati.
createTime	string (Timestamp format) L'ora in cui è stato creato il collegamento. Un timestamp in formato RFC3339 UTC "Zulu", con una risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime	string (Timestamp format) L'ultimo aggiornamento dello stato del link. Un timestamp in formato RFC3339 UTC "Zulu", con una risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
vendorClientId	string ID cliente del fornitore, se presente.
metrics[]	enum (Metric) Metriche accessibili tramite questo link ai dati. Se vuoto, non vengono applicate restrizioni per le metriche. Questo campo al momento è solo Single Sign-On ed è supportato solo quando il tipo di entità link è GOOGLE_ADS_CAMPAIGN o YT_RESERVE_LINE_ITEM.
gmpExportScopes[]	enum (GmpExportScope) Tipi di dati che verranno esportati per i collegamenti Display &Video 360. Completato solo quando la piattaforma è GOOGLE_MARKETING_PLATFORM. Se vuoto, non è specificato alcun valore ed è possibile che venga scelta una combinazione qualsiasi.

Entità

Rappresenta un'entità pubblicitaria che può essere collegata a un cliente Ads Data Hub.

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

Campi
entityId	string (int64 format) ID entità. Il valore elencato qui dipende dal tipo di entità.
displayName	string Nome visualizzato dell'entità.
type	enum (EntityType) Tipo di entità collegata.

EntityType

Entità pubblicitarie supportate.

Enum
ENTITY_TYPE_UNSPECIFIED	Tipo di entità non specificato.
GOOGLE_ADS_CUSTOMER	Un cliente Google Ads. entityId corrisponde a [Customer.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#customer] nell'API Google Ads.
GOOGLE_ADS_CAMPAIGN	Una campagna Google Ads. entityId corrisponde a [Campaign.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#campaign] nell'API Google Ads.
GMP_CM_ACCOUNT	Un account Campaign Manager di Google Marketing Platform. Il entityId corrisponde a [Accounts.id][https://developers.google.com/doubleclick-inserzionisti/v3.3/accounts]
GMP_CM_FLOODLIGHT	Un account Floodlight Campaign Manager. entityId corrisponde a [FloodlightConfigurations.accountId][https://developers.google.com/doubleclick-inserzionisti/v3.3/floodlightConfigurations]
GMP_DV360_PARTNER	Un ID partner Display &Video 360. entityId è un ID partner DV360.
GMP_DV360_ADVERTISER	Un ID inserzionista Display &Video 360. entityId è un ID inserzionista DV360.
GMP_DV360_ORDER	Un ID ordine Display &Video 360. entityId è un ID ordine DV360.
GMP_DV360_LINE_ITEM	Un ID elemento pubblicitario Display &Video 360. entityId è un ID elemento pubblicitario DV360.
YT_RESERVE_ORDER	Un ID ordine di YouTube Reserve. entityId corrisponde a [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id] in Google Ads Manager.
YT_RESERVE_LINE_ITEM	Un elemento pubblicitario di YouTube Reserve. entityId corrisponde a [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id] in Google Ads Manager.
VENDOR_CLIENT_ID_REGISTRATION	Un ID cliente fornitore registrato manualmente da un fornitore di tecnologia pubblicitaria di terze parti per fornire misurazioni di terze parti.
GOOGLE_AD_MANAGER_ORDER	Un ID ordine Google Ad Manager. entityId corrisponde a [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id] in Google Ads Manager.
GOOGLE_AD_MANAGER_LINE_ITEM	Un elemento pubblicitario Google Ad Manager. entityId corrisponde a [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id] in Google Ads Manager.

Piattaforma

Piattaforme pubblicitarie supportate.

Enum
PLATFORM_UNSPECIFIED	Piattaforma non specificata.
GOOGLE_ADS	L'entità è associata a Google Ads.
GOOGLE_MARKETING_PLATFORM	L'entità è associata a Google Marketing Platform.
YOUTUBE_RESERVE	L'entità è associata a YouTube Reserve.
GOOGLE_AD_MANAGER	L'entità è associata a Google Ad Manager.
FREEWHEEL	L'entità è associata a FreeWheel.

Metrica

Metriche che possono essere esposte tramite i link ai dati degli annunci.

Enum
METRIC_UNSPECIFIED	Metrica non specificata.
BRAND_LIFT	Metrica corrispondente all'impatto del brand.
BRAND_SAFETY	Metrica corrispondente alla sicurezza del brand.
REACH	Metrica corrispondente a Copertura, in cui il cliente è l'inserzionista.
VIEWABILITY	Metrica corrispondente alla visibilità, in cui il cliente è l'inserzionista.
PUBLISHER_REACH	Metrica corrispondente a Copertura, in cui il cliente è il publisher/fornitore di contenuti.
PUBLISHER_VIEWABILITY	Metrica corrispondente alla visibilità, dove il cliente è il publisher o il fornitore di contenuti.

GmpExportScope

Diversi tipi di dati che possono essere esportati per i link GMP.

Enum
GMP_EXPORT_SCOPE_UNSPECIFIED	Ambito non specificato.
GMP_EXPORT_SCOPE_YT_TRUEVIEW	Devi esportare i dati TrueView di YouTube DV360.
GMP_EXPORT_SCOPE_DT	Deve esportare i dati DT.

Metodi
batchApprove	Approva un elenco di link di dati pubblicitari in attesa.
batchReject	Rifiuta un elenco di link per i dati pubblicitari in attesa.
list	Elenca i collegamenti tra il cliente specificato e altre entità pubblicitarie di Google.