REST Resource: customers.adsDataLinks

• Ressource: AdsDataLink
  • JSON-Darstellung
• Entität
  • JSON-Darstellung
• EntityType
• Plattform
• Messwert
• GmpExportScope
• Methoden

Ressource: AdsDataLink

Eine Werbedatenverknüpfung.

JSON-Darstellung
{ "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) ] }

Felder
name	string Name, der eine AdsDataLink-Ressource eindeutig identifiziert. Es hat das Format „customers/[customerId]/adsDataLinks/[resource_id]“. Die Ressourcen-ID wird vom Server generiert.
linkedEntity	object (Entity) Das Element ist über dieses AdsDataLink-Objekt verknüpft.
parentEntity	object (Entity) Zugehörige übergeordnete Entität, falls vorhanden. Wenn die verknüpfte Entität eine Google Ads-Kampagne ist, enthält dieses Feld einen entsprechenden Google Ads-Kunden, zu dem die Kampagne gehört.
childEntities[]	object (Entity) Zugehörige untergeordnete Entitäten, falls vorhanden. Wenn die verknüpfte Entität ein Google Ads-Kunde ist, der einer Verknüpfung mit einem Kundenmanager entspricht, enthält „childEntities“ einen vollständig erweiterten Satz von Google Ads-Kunden mit Daten, die über diesen Link in Ads Data Hub importiert werden.
platform	enum (Platform) Werbeplattform, die mit der verknüpften Entität verknüpft ist
customerLink	object (CustomerLink) Kundenverknüpfung, über die auf die verknüpften Daten zugegriffen werden kann. Nur Name, Kundennummer und displayName werden ausgefüllt.
status	enum (LinkStatus) Status der Datenverknüpfung.
createTime	string (Timestamp format) Zeitpunkt der Erstellung des Links. Ein Zeitstempel im Format RFC3339 UTC mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
updateTime	string (Timestamp format) Uhrzeit der letzten Aktualisierung des Verknüpfungsstatus. Ein Zeitstempel im Format RFC3339 UTC mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
vendorClientId	string Gegebenenfalls die anbieterseitige Client-ID.
metrics[]	enum (Metric) Messwerte, auf die über diese Verknüpfung zugegriffen werden kann. Wenn das Feld leer ist, werden keine Messwerteinschränkungen angewendet. Dieses Feld ist derzeit nur ein Einzelformat und wird nur unterstützt, wenn der Linkentitätstyp GOOGLE_ADS_CAMPAIGN oder YT_RESERVE_LINE_ITEM ist.
gmpExportScopes[]	enum (GmpExportScope) Datentypen, die für Display &Video 360-Verknüpfungen exportiert werden. Wird nur ausgefüllt, wenn die Plattform GOOGLE_MARKETING_PLATFORM ist. Wenn das Feld leer ist, dann nicht angegeben und eine beliebige Kombination davon verfügbar sein.

Entität

Eine Werbeeinheit, die mit einem Ads Data Hub-Kunden verknüpft werden kann

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

Felder
entityId	string (int64 format) Entitäts-ID. Der hier aufgeführte Wert ist vom Entitätstyp abhängig.
displayName	string Angezeigter Name der Entität.
type	enum (EntityType) Typ der verknüpften Entität.

EntityType

Unterstützte Werbeeinheiten.

Enums
ENTITY_TYPE_UNSPECIFIED	Nicht angegebener Entitätstyp.
GOOGLE_ADS_CUSTOMER	Ein Google Ads-Kunde. Die entityId entspricht [Customer.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#customer] in der Google Ads API.
GOOGLE_ADS_CAMPAIGN	Google Ads-Kampagne entityId entspricht [Campaign.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#campaign] in der Google Ads API.
GMP_CM_ACCOUNT	Ein Google Marketing Platform Campaign Manager-Konto. Die entityId entspricht [Accounts.id][https://developers.google.com/doubleclick-advertisers/v3.3/accounts]
GMP_CM_FLOODLIGHT	Ein Campaign Manager-Floodlight-Konto Die entityId entspricht [FloodlightConfigurations.accountId][https://developers.google.com/doubleclick-advertisers/v3.3/floodlightConfigurations]
GMP_DV360_PARTNER	Eine Display &Video 360-Partner-ID. entityId ist eine DV360-Partner-ID.
GMP_DV360_ADVERTISER	Eine Display &Video 360-Werbetreibenden-ID Die entityId ist eine DV360-Werbetreibenden-ID.
GMP_DV360_ORDER	Eine Display &Video 360-Bestell-ID. entityId ist eine DV360-Bestell-ID.
GMP_DV360_LINE_ITEM	Eine Display &Video 360-Werbebuchungs-ID entityId ist eine DV360-Werbebuchungs-ID.
YT_RESERVE_ORDER	Eine YouTube Reserve-Bestell-ID. entityId entspricht [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id] in Google Ads Manager.
YT_RESERVE_LINE_ITEM	Eine YouTube Reserve-Werbebuchung entityId entspricht [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id] in Google Ads Manager.
VENDOR_CLIENT_ID_REGISTRATION	Eine anbieterseitige Client-ID, die manuell von einem Drittanbieter für Anzeigentechnologien registriert wird, um Analysen durch Drittanbieter bereitzustellen.
GOOGLE_AD_MANAGER_ORDER	Eine Google Ad Manager-Bestell-ID. entityId entspricht [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id] in Google Ads Manager.
GOOGLE_AD_MANAGER_LINE_ITEM	Google Ad Manager-Werbebuchung entityId entspricht [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id] in Google Ads Manager.

Plattform

Unterstützte Werbeplattformen

Enums
PLATFORM_UNSPECIFIED	Nicht angegebene Plattform.
GOOGLE_ADS	Das Element ist mit Google Ads verknüpft.
GOOGLE_MARKETING_PLATFORM	Die Entität ist mit der Google Marketing Platform verknüpft.
YOUTUBE_RESERVE	Die Entität ist mit YouTube Reserve verknüpft.
GOOGLE_AD_MANAGER	Das Element ist mit Google Ad Manager verknüpft.
FREEWHEEL	Das Element ist mit FreeWheel verknüpft.

Messwert

Messwerte, die über Links zu Anzeigendaten preisgegeben werden können.

Enums
METRIC_UNSPECIFIED	Nicht angegebener Messwert.
BRAND_LIFT	Messwert für Brand Lift.
BRAND_SAFETY	Messwert zur Markensicherheit.
REACH	Messwert, der der Reichweite entspricht, wobei der Kunde der Werbetreibende ist
VIEWABILITY	Messwert für Sichtbarkeit, wobei der Kunde der Werbetreibende ist
PUBLISHER_REACH	Messwert, der der Reichweite entspricht, wobei der Kunde der Publisher/Contentanbieter ist
PUBLISHER_VIEWABILITY	Messwert, der der Sichtbarkeit entspricht, wobei der Kunde der Publisher oder Contentanbieter ist

GmpExportBereich

Verschiedene Datentypen, die für GMP-Verknüpfungen exportiert werden können.

Enums
GMP_EXPORT_SCOPE_UNSPECIFIED	Unbekannter Bereich.
GMP_EXPORT_SCOPE_YT_TRUEVIEW	Sie sollten DV360-YouTube-TrueView-Daten exportieren.
GMP_EXPORT_SCOPE_DT	DT-Daten exportieren.

Methoden
batchApprove	Eine Liste der ausstehenden Links für Anzeigendaten genehmigen.
batchReject	Eine Liste mit ausstehenden Datenverknüpfungen zu Anzeigen ablehnen.
list	Listet Verknüpfungen zwischen dem angegebenen Kunden und anderen Google-Werbeeinheiten auf