REST Resource: customers.adsDataLinks

• منبع: AdsDataLink
  • نمایندگی JSON
• وجود، موجودیت
  • نمایندگی JSON
• EntityType
• سکو
• متریک
• GmpExportScope
• مواد و روش ها

منبع: AdsDataLink

نشان دهنده یک پیوند داده تبلیغاتی است.

نمایندگی 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) ] }

زمینه های
name	string نامی که به طور منحصر به فرد منبع AdsDataLink را شناسایی می کند. دارای فرم مشتریان/[customerId]/adsDataLinks/[resource_id] است. شناسه منبع توسط سرور تولید می شود.
linkedEntity	object ( Entity ) نهاد از طریق این AdsDataLink پیوند داده شده است.
parentEntity	object ( Entity ) نهاد مادر مرتبط، در صورت وجود. اگر نهاد پیوند داده شده یک کمپین Google Ads باشد، این فیلد حاوی یک مشتری مربوط به Google Ads است که کمپین به آن تعلق دارد.
childEntities[]	object ( Entity ) نهادهای فرزند مرتبط، در صورت وجود. اگر نهاد پیوند شده یک مشتری Google Ads باشد که با پیوند مشتری-مدیر مطابقت دارد، childEntities مجموعه کاملاً گسترده‌ای از مشتریان Google Ads را با داده‌های وارد شده به Ads Data Hub از طریق این پیوند شامل می‌شود.
platform	enum ( Platform ) پلت فرم تبلیغاتی مرتبط با نهاد مرتبط.
customerLink	object ( CustomerLink ) پیوند مشتری که از طریق آن می توان به داده های پیوند شده دسترسی داشت. فقط نام، شناسه مشتری، و displayName پر شده است.
status	enum ( LinkStatus ) وضعیت پیوند داده
createTime	string ( Timestamp format) زمان ایجاد لینک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .
updateTime	string ( Timestamp format) زمان آخرین به روز رسانی وضعیت پیوند. مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .
vendorClientId	string شناسه مشتری فروشنده، در صورت وجود.
metrics[]	enum ( Metric ) معیارهای قابل دسترسی از طریق این پیوند داده. اگر خالی باشد، هیچ محدودیت متریک اعمال نمی شود. این فیلد در حال حاضر فقط تک است و فقط زمانی پشتیبانی می‌شود که نوع نهاد پیوند GOOGLE_ADS_CAMPAIGN یا YT_RESERVE_LINE_ITEM باشد.
gmpExportScopes[]	enum ( GmpExportScope ) انواع داده‌هایی که برای پیوندهای Display & Video 360 صادر می‌شوند. فقط زمانی پر می شود که پلتفرم GOOGLE_MARKETING_PLATFORM باشد. اگر خالی باشد، مشخص نیست و هر ترکیبی از اینها ممکن است در دسترس باشد.

وجود، موجودیت

نشان دهنده یک نهاد تبلیغاتی است که می تواند به یک مشتری Ads Data Hub مرتبط شود.

نمایندگی JSON
{ "entityId": string, "displayName": string, "type": enum (EntityType) }

زمینه های
entityId	string ( int64 format) شناسه نهاد. مقدار فهرست شده در اینجا به نوع موجودیت بستگی دارد.
displayName	string نام نمایشی نهاد
type	enum ( EntityType ) نوع موجودیت مرتبط

EntityType

حمایت از نهادهای تبلیغاتی

Enums
ENTITY_TYPE_UNSPECIFIED	نوع نهاد نامشخص
GOOGLE_ADS_CUSTOMER	یک مشتری گوگل ادز. entityId با [Customer.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#customer] در Google Ads API مطابقت دارد.
GOOGLE_ADS_CAMPAIGN	یک کمپین تبلیغاتی گوگل entityId مربوط به [Campaign.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#campaign] در Google Ads API است.
GMP_CM_ACCOUNT	یک حساب Google Marketing Platform Campaign Manager. entityId مربوط به [Accounts.id][https://developers.google.com/doubleclick-advertisers/v3.3/accounts] است
GMP_CM_FLOODLIGHT	یک حساب نورافکن Campaign Manager. entityId مربوط به [FloodlightConfigurations.accountId][https://developers.google.com/doubleclick-advertisers/v3.3/floodlightConfigurations] است.
GMP_DV360_PARTNER	شناسه شریک Display & Video 360. entityId یک شناسه شریک DV360 است.
GMP_DV360_ADVERTISER	شناسه تبلیغ کننده Display & Video 360. entityId یک شناسه تبلیغ‌کننده DV360 است.
GMP_DV360_ORDER	شناسه سفارش Display & Video 360. entityId یک شناسه سفارش DV360 است.
GMP_DV360_LINE_ITEM	شناسه مورد خط Display & Video 360. entityId یک شناسه مورد خط DV360 است.
YT_RESERVE_ORDER	شناسه سفارش YouTube Reserve. entityId با [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id] در Google Ads Manager مطابقت دارد.
YT_RESERVE_LINE_ITEM	یک مورد خط YouTube Reserve. entityId با [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id] در Google Ads Manager مطابقت دارد.
VENDOR_CLIENT_ID_REGISTRATION	شناسه مشتری فروشنده که به صورت دستی توسط یک فروشنده فناوری تبلیغاتی شخص ثالث برای ارائه اندازه‌گیری‌های شخص ثالث ثبت می‌شود.
GOOGLE_AD_MANAGER_ORDER	شناسه سفارش Google Ad Manager. entityId با [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id] در Google Ads Manager مطابقت دارد.
GOOGLE_AD_MANAGER_LINE_ITEM	یک مورد خط Google Ad Manager. entityId با [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id] در Google Ads Manager مطابقت دارد.

سکو

پلتفرم های تبلیغاتی پشتیبانی شده

Enums
PLATFORM_UNSPECIFIED	پلت فرم نامشخص
GOOGLE_ADS	این نهاد با تبلیغات گوگل مرتبط است.
GOOGLE_MARKETING_PLATFORM	نهاد با Google Marketing Platform مرتبط است.
YOUTUBE_RESERVE	این نهاد با YouTube Reserve مرتبط است.
GOOGLE_AD_MANAGER	این نهاد با Google Ad Manager مرتبط است.
FREEWHEEL	موجودیت با FreeWheel مرتبط است.

متریک

معیارهایی که می توانند از طریق پیوندهای داده تبلیغاتی در معرض نمایش قرار گیرند.

Enums
METRIC_UNSPECIFIED	متریک نامشخص
BRAND_LIFT	متریک مربوط به افزایش برند.
BRAND_SAFETY	متریک مربوط به ایمنی برند.
REACH	متریک مربوط به Reach، جایی که مشتری تبلیغ‌کننده است.
VIEWABILITY	معیار مربوط به قابلیت مشاهده، جایی که مشتری تبلیغ‌کننده است.
PUBLISHER_REACH	متریک مربوط به Reach، جایی که مشتری ناشر/ارائه‌دهنده محتوا است.
PUBLISHER_VIEWABILITY	معیار مربوط به قابلیت مشاهده، جایی که مشتری ناشر/ارائه‌دهنده محتوا است.

GmpExportScope

انواع مختلف داده هایی که می توانند برای پیوندهای GMP صادر شوند.

Enums
GMP_EXPORT_SCOPE_UNSPECIFIED	محدوده نامشخص
GMP_EXPORT_SCOPE_YT_TRUEVIEW	باید داده های DV360 Youtube TrueView را صادر کند.
GMP_EXPORT_SCOPE_DT	باید داده های DT را صادر کند.

مواد و روش ها
batchApprove	لیستی از پیوندهای داده آگهی های معلق را تأیید کنید.
batchReject	لیستی از پیوندهای داده آگهی های معلق را رد کنید.
list	پیوندهای بین مشتری مشخص شده و سایر نهادهای تبلیغاتی Google را فهرست می کند.