REST Resource: customers.adsDataLinks

• Kaynak: AdsDataLink
  • JSON gösterimi
• Varlık
  • JSON gösterimi
• Varlık Türü
• Platform
• Metrik
• GmpExportScope
• Yöntemler

Kaynak: AdsDataLink

Bir reklam verileri bağlantısını temsil eder.

JSON gösterimi
{ "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) ] }

Alanlar
name	string AdsDataLink kaynağını benzersiz şekilde tanımlayan ad. Müşteri/[müşterikimliği]/adsDataLinks/[kaynak_kimliği] biçimindedir. Kaynak kimliği, sunucu tarafından oluşturulur.
linkedEntity	object (Entity) Bu AdsDataLink aracılığıyla bağlanan varlık.
parentEntity	object (Entity) Varsa ilgili üst varlık. Bağlı varlık bir Google Ads kampanyasıysa bu alan, kampanyanın ait olduğu karşılık gelen bir Google Ads müşterisini içerir.
childEntities[]	object (Entity) Varsa ilgili alt varlıklar. Bağlı tüzel müşteri, müşteri yöneticisi bağlantısına karşılık gelen bir Google Ads müşterisiyse bu alt kuruluş, bu bağlantı aracılığıyla Ads Data Hub'a aktarılan verileri içeren, tamamen genişletilmiş bir Google Ads müşteri grubunu içerir.
platform	enum (Platform) Bağlantılı varlıkla ilişkili reklamcılık platformu.
customerLink	object (CustomerLink) Bağlantılı verilere erişilebilen müşteri bağlantısı. Yalnızca ad, müşteri kimliği ve görünen ad doldurulur.
status	enum (LinkStatus) Veri bağlantısının durumu.
createTime	string (Timestamp format) Bağlantının oluşturulduğu saat. RFC3339 UTC "Zulu&quot" biçiminde nanosaniye çözünürlüğe ve dokuz adede kadar kesir basamağına sahip zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
updateTime	string (Timestamp format) Bağlantı durumunun son güncellenme zamanı. RFC3339 UTC "Zulu&quot" biçiminde nanosaniye çözünürlüğe ve dokuz adede kadar kesir basamağına sahip zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
vendorClientId	string Tedarikçi firma müşteri kimliği (varsa).
metrics[]	enum (Metric) Bu veri bağlantısı üzerinden erişilebilen metrikler. Boşsa metrik kısıtlaması uygulanmaz. Bu alan şu anda yalnızca tek başına kullanılabilir ve yalnızca bağlantı varlığı türü GOOGLE_ADS_CAMPAIGN veya YT_RESERVE_LINE_ITEM olduğunda desteklenir.
gmpExportScopes[]	enum (GmpExportScope) Display &Video 360 bağlantıları için dışa aktarılacak veri türleri. Yalnızca platform GOOGLE_MARKETING_PLATFORM olduğunda doldurulur. Boşsa belirtilmemiş ve bunların herhangi bir kombinasyonu mevcut olabilir.

Varlık

Bir Ads Data Hub müşterisine bağlanabilecek reklamcılık varlığını temsil eder.

JSON gösterimi
{ "entityId": string, "displayName": string, "type": enum (EntityType) }

Alanlar
entityId	string (int64 format) Varlık kimliği. Burada listelenen değer, öğe türüne bağlıdır.
displayName	string Varlık görünen adı.
type	enum (EntityType) Bağlı varlığın türü.

VarlıkTürü

Desteklenen reklam varlıkları.

Sıralamalar
ENTITY_TYPE_UNSPECIFIED	Belirtilmemiş öğe türü.
GOOGLE_ADS_CUSTOMER	Google Ads müşterisi olmanız gerekir. entityId, Google Ads API'deki [Customer.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#customer] ile ilgilidir.
GOOGLE_ADS_CAMPAIGN	Google Ads kampanyası. entityId, Google Ads API'deki [Campaign.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#campaign]'a karşılık gelir.
GMP_CM_ACCOUNT	Google Marketing Platform Campaign Manager hesabı. entityId, [Accounts.id][https://developers.google.com/doubleclick-advertisers/v3.3/accounts] adresine karşılık gelir
GMP_CM_FLOODLIGHT	Campaign Manager Floodlight hesabı. entityId, [FloodlightConfigurations.accountId][https://developers.google.com/doubleclick-advertisers/v3.3/floodlightConfigurations] ile eşleşir.
GMP_DV360_PARTNER	Display &Video 360 iş ortağı kimliği. entityId, DV360 iş ortağı kimliğidir.
GMP_DV360_ADVERTISER	Display &Video 360 reklamveren kimliği. entityId, DV360 reklamveren kimliğidir.
GMP_DV360_ORDER	Display &Video 360 sipariş kimliği. entityId, DV360 sipariş kimliğidir.
GMP_DV360_LINE_ITEM	Display &Video 360 satır öğesi kimliği. entityId, DV360 satır öğesi kimliğidir.
YT_RESERVE_ORDER	YouTube Reserve sipariş kimliği. entityId, Google Ads Yöneticisi'ndeki [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id]'e karşılık gelir.
YT_RESERVE_LINE_ITEM	YouTube Reserve satır öğesi. entityId, Google Ads Yöneticisi'ndeki [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id]'ye karşılık gelir.
VENDOR_CLIENT_ID_REGISTRATION	Üçüncü taraf ölçüm sağlamak için üçüncü taraf reklam teknolojisi tedarikçisi tarafından manuel olarak kaydedilen Tedarikçi Firma Müşteri Kimliği.
GOOGLE_AD_MANAGER_ORDER	Google Ad Manager sipariş kimliği. entityId, Google Ads Yöneticisi'ndeki [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id]'e karşılık gelir.
GOOGLE_AD_MANAGER_LINE_ITEM	Google Ad Manager satır öğesi. entityId, Google Ads Yöneticisi'ndeki [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id]'ye karşılık gelir.

Platform

Desteklenen reklamcılık platformları.

Sıralamalar
PLATFORM_UNSPECIFIED	Belirtilmemiş platform.
GOOGLE_ADS	Varlık, Google Ads ile ilişkilendirilmiştir.
GOOGLE_MARKETING_PLATFORM	Varlık, Google Marketing Platform ile ilişkilendirilir.
YOUTUBE_RESERVE	Varlık, YouTube Reserve ile ilişkilidir.
GOOGLE_AD_MANAGER	Varlık, Google Ad Manager ile ilişkilidir.
FREEWHEEL	Varlık, FreeWheel ile ilişkilendirilmiş.

Metrik

Reklam verileri bağlantıları üzerinden gösterilebilen metrikler.

Sıralamalar
METRIC_UNSPECIFIED	Belirtilmemiş metrik.
BRAND_LIFT	Brand Lift'e karşılık gelen metrik.
BRAND_SAFETY	Marka Güvenliği'ne karşılık gelen metrik.
REACH	Müşterinin reklamveren olduğu Erişim'e karşılık gelen metrik.
VIEWABILITY	Müşterinin reklamveren olduğu Görüntülenebilirliğe karşılık gelen metrik.
PUBLISHER_REACH	Müşterinin yayıncı/içerik sağlayıcı olduğu Erişim'e karşılık gelen metrik.
PUBLISHER_VIEWABILITY	Müşterinin yayıncı/içerik sağlayıcı olduğu Görüntülenebilirlik metriğine karşılık gelen metrik.

GmpExportScope

GMP bağlantıları için dışa aktarılabilen farklı veri türleri.

Sıralamalar
GMP_EXPORT_SCOPE_UNSPECIFIED	Belirtilmemiş kapsam.
GMP_EXPORT_SCOPE_YT_TRUEVIEW	DV360 YouTube TrueView verileri dışa aktarılmalıdır.
GMP_EXPORT_SCOPE_DT	DT verileri dışa aktarılmalıdır.

Yöntemler
batchApprove	Beklemedeki reklam veri bağlantılarının listesini onaylayın.
batchReject	Bekleyen reklam verileri bağlantıları listesini reddedin.
list	Belirtilen müşteri ile diğer Google reklam varlıkları arasındaki bağlantıları listeler.