REST Resource: customers.adsDataLinks

• מקור: AdsDataLink
  • ייצוג JSON
• ישות
  • ייצוג JSON
• סוג ישות
• פלטפורמה
• מדד
• 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 שתואם לקישור של מנהל לקוח, ישויות הצאצאים יכללו קבוצה מורחבת של לקוחות 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) סוג הישות המקושרת.

סוג יישות

יישויות פרסום נתמכות.

Enums
ENTITY_TYPE_UNSPECIFIED	סוג הישות לא צוין.
GOOGLE_ADS_CUSTOMER	לקוח Google Ads. ה-entityId תואם ל-[Customer.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#customer] ב-Google Ads API.
GOOGLE_ADS_CAMPAIGN	קמפיין ב-Google Ads. ה-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	חשבון Floodlight ב-Campaign Manager. entityId תואם ל-[FloodlightConfigurations.accountId][https://developers.google.com/doubleclick-advertisers/v3.3/flaudlightConfigurations]
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 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	המדד שתואם להיקף החשיפה, שבו הלקוח הוא המפרסם.
VIEWABILITY	מדד שתואם לניראות, שבו הלקוח הוא המפרסם.
PUBLISHER_REACH	המדד שתואם להיקף החשיפה, שבו הלקוח הוא ספק התוכן או בעל התוכן הדיגיטלי.
PUBLISHER_VIEWABILITY	מדד שתואם לניראות, שבו הלקוח הוא בעל התוכן הדיגיטלי או ספק התוכן.

GmpExportScope

סוגים שונים של נתונים שניתן לייצא לקישורי GMP.

Enums
GMP_EXPORT_SCOPE_UNSPECIFIED	היקף לא מוגדר.
GMP_EXPORT_SCOPE_YT_TRUEVIEW	אתם צריכים לייצא את הנתונים מ-YouTube TrueView ב-DV360.
GMP_EXPORT_SCOPE_DT	צריך לייצא נתוני DT.

שיטות
batchApprove	מאשרים רשימה של קישורים בהמתנה לנתוני מודעות.
batchReject	דחיית רשימה של קישורים בהמתנה לנתוני מודעות.
list	מפרט קישורים בין הלקוח שצוין לישויות פרסום אחרות של Google.