הגדרת יעדים וכותרות

המושג Destination וכותרות הבקשה מופיעים לעיתים קרובות כשעובדים עם Data Manager API. במדריך הזה מוסבר איך להגדיר יעדים וכותרות לתרחישים שונים.

מתי כדאי להשתמש ביעדים או בכותרות

• משתמשים בDestination בבקשות להעברת נתונים. בקשת העברה משתמשת ב-IngestionService כדי להוסיף או להסיר חברים בקהל או לשלוח אירועים. הרשימה destinations באובייקט IngestAudienceMembersRequest או IngestEventsRequest מגדירה:

  1. החשבון שמקבל את הנתונים. לדוגמה, חשבון Google Ads או נכס ב-Google Analytics.
  2. ישות היעד של הנתונים בחשבון, כמו פעולת המרה ב-Google Ads או מקור נתונים ב-Google Analytics.
  3. נתיב הגישה של פרטי הכניסה של הבקשה לחשבון שמקבל את הנתונים.

  אפשר לכלול כמה יעדים באותה בקשת הטמעה.

  טיפ: אל תגדירו כותרות של בקשות בבקשת IngestionService. ‫Data Manager API מתעלם מכותרות בבקשת הטמעה.

• משתמשים בכותרות של בקשות בבקשות לניהול משאבים שיוצרות, מעדכנות, מוחקות או מאחזרות משאבים. הכותרות מגדירות את נתיב הגישה של פרטי הכניסה של הבקשה לחשבון היעד של בקשת ניהול המשאבים. זו רשימת המשאבים עם שיטות לניהול משאבים שתומכות בכותרות של בקשות:

  • Insights
  • PartnerLink
  • UserList
  • UserListDirectLicense
  • UserListGlobalLicense
  • UserListGlobalLicenseCustomerInfo

לדוגמה, אם רוצים ליצור קהל, להוסיף לו חברים, לבדוק את האבחון ואז לאחזר את הקהל כדי לבדוק את הגודל שלו, הנה כל שלב, סוג הבקשה שצריך להשתמש בה והאם צריך להשתמש ביעדים או בכותרות של בקשות:

שלב	סוג הבקשה	כותרות של יעד או בקשה
יצירת קהל	ניהול המשאבים	כותרות של בקשות
הוספת חברים לקהל	הטמעת נתונים	יעדים
בדיקת דוח האבחון	הטמעת נתונים	יעדים
אחזור הקהל	ניהול המשאבים	כותרות של בקשות

כדי לעבור בין הפרטים במדריך הזה לכל סוג בקשה, לוחצים על הכרטיסייה העברה או ניהול משאבים שמעל כל טבלה.

אם אתם מפרסמים או סוכנויות, אתם יכולים לעבור אל תרחישים לדוגמה למפרסמים כדי לראות איך להגדיר כותרות ולבנות Destination:

• Google Ads
• Display & Video 360
• Google Analytics

אם אתם שותפי נתונים, תוכלו לעבור אל תרחישים של שותפי נתונים כדי לראות דוגמאות להגדרת כותרות וליצירת Destination לניהול משאבים ולשליחת נתונים לחשבון עם קישור מוצרים לחשבון של שותף הנתונים:

• Google Ads
• Display & Video 360
• Google Analytics

בקטע דרישות מפורטות מוסברות הדרישות וכללי האימות.

תרחישים של מפרסמים

כאן מוסבר איך להגדיר Destination או כותרות בקשות לתרחישים נפוצים של מפרסמים וסוכנויות. בתרשים הזה מוצג אופן השימוש בפרטי הכניסה ובשדות Destination של Data Manager API כדי לגשת לחשבון המפרסם.

Google Ads

תרשים שמציג דוגמה של קבוצת חשבונות ומשתמשים ב-Google Ads.

חשבון ניהול M1

לחשבון M1 יש שני חשבונות צאצא ישירים:

1. חשבון ניהול M2
2. חשבון לקוח C1

חשבון Google מספר [e-mail] הוא משתמש בחשבון M1.

חשבון ניהול M2

לחשבון M2 יש שני חשבונות צאצא ישירים:

1. חשבון לקוח C1
2. חשבון לקוח C2

חשבון Google‏ [e-mail] הוא משתמש בחשבון M2.

חשבון לקוח C1

לחשבון C1 יש שני חשבונות ניהול הורה ישירים:

1. חשבון ניהול M1
2. חשבון ניהול M2

חשבון Google‏ [e-mail] הוא משתמש בחשבון C1.

חשבון לקוח C2

חשבון הניהול M2 הוא ההורה הישיר היחיד של C2.

אף אחד מחשבונות Google שרשומים לא מוגדר כמשתמש בחשבון C2.

בתרחיש של גישה ישירה ובתרחיש של גישת מנהל מוסבר איך מגדירים יעד לשליחת נתונים לחשבונות האלה.

תרחיש של גישה ישירה

אם אתם רוצים לשלוח נתונים לחשבון Google Ads והאישורים שלכם הם לחשבון Google שהוא משתמש בחשבון Google Ads:

הטמעת נתונים

יעד
operating_account	account_id מספר הלקוח של חשבון Google Ads account_type GOOGLE_ADS
login_account	אל תגדירו את login_account, או הגדירו את אותם ערכים כמו operating_account.
linked_account	אל תגדירו את השדה linked_account.
product_destination_id	המזהה של קהל היעד או של פעולת ההמרה.

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account	לא מגדירים את הכותרת linked-account.

הנה דוגמה לתרחיש של גישה ישירה, באמצעות החשבונות מהתרשים ופרטי הכניסה לחשבון Google‏ [e-mail]:

הטמעת נתונים

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "loginAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID
linked-account	לא מגדירים את הכותרת linked-account.

תרחיש של גישת מנהל

אם אתם רוצים לשלוח נתונים לחשבון Google Ads ופרטי הכניסה שלכם הם לחשבון Google שהוא משתמש בחשבון ניהול ב-Google Ads שבו חשבון המפרסם הוא חשבון משני:

הטמעת נתונים

יעד
operating_account	account_id מספר הלקוח של חשבון הלקוח ב-Google Ads account_type GOOGLE_ADS
login_account	account_id מספר הלקוח של חשבון הניהול ב-Google Ads account_type GOOGLE_ADS
linked_account	אל תגדירו את השדה linked_account.
product_destination_id	המזהה של קהל היעד או של פעולת ההמרה.

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account	לא מגדירים את הכותרת linked-account.

הנה דוגמה לתרחיש של גישת ניהול לחשבון לקוח C2 ב-Google Ads מתוך התרשים ופרטי הכניסה לחשבון Google [e-mail]:

הטמעת נתונים

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account	לא מגדירים את הכותרת linked-account.

הנה דוגמה נוספת לתרחיש של גישת ניהול לחשבון לקוח C2 ב-Google Ads ולפרטי כניסה לחשבון Google [e-mail], שהוא משתמש בחשבון ניהול M1 ב-Google Ads:

הטמעת נתונים

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID
linked-account	לא מגדירים את הכותרת linked-account.

Display & Video 360

יש שתי דרכים לשלוח נתונים אל Display & Video 360:

1. גישה ישירה, שבה פרטי הכניסה הם לחשבון Google שהוא משתמש בחשבון המפרסם או השותף ב-Display & Video 360.
2. גישת שותף ב-Display & Video 360, שבה פרטי הכניסה הם לחשבון Google שהוא חשבון משתמש בחשבון השותף ב-Display & Video 360, וחשבון ההפעלה הוא חשבון מפרסם ב-Display & Video 360 שמשויך לחשבון השותף.

תרחישים של גישה ישירה

אם רוצים לשלוח נתונים לחשבון מפרסם ב-Display & Video 360 והפרטים שלכם הם של חשבון Google שהוא משתמש בחשבון המפרסם:

הטמעת נתונים

יעד
operating_account	account_id המזהה של חשבון המפרסם ב-Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	אל תגדירו את login_account, או הגדירו את אותם ערכים כמו operating_account.
linked_account	אל תגדירו את השדה linked_account.
product_destination_id	המזהה של הקהל.

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	לא מגדירים את הכותרת linked-account.

הנה דוגמה ל-Destination לתרחיש של גישה ישירה לשליחת נתונים אל מפרסם ב-Display & Video 360:

הטמעת נתונים

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	לא מגדירים את הכותרת linked-account.

באופן דומה, אם רוצים לשלוח נתונים לחשבון שותף ב-Display & Video 360 והאישורים הם לחשבון Google שמוגדר כמשתמש בחשבון השותף:

הטמעת נתונים

יעד
operating_account	account_id המזהה של חשבון השותף ב-Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
login_account	אל תגדירו את login_account, או הגדירו את אותם ערכים כמו operating_account.
linked_account	אל תגדירו את השדה linked_account.
product_destination_id	המזהה של הקהל.

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	לא מגדירים את הכותרת linked-account.

הנה דוגמה לDestination לתרחיש של גישה ישירה לשליחת נתונים לשותף ב-Display & Video 360:

הטמעת נתונים

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	לא מגדירים את הכותרת linked-account.

תרחיש של גישה לשותף ב-Display & Video 360

אם אתם רוצים לשלוח נתונים למפרסם ב-Display & Video 360 והפרטים שלכם הם של חשבון Google שהוא משתמש בחשבון השותף הראשי של המפרסם ב-Display & Video 360:

הטמעת נתונים

יעד
operating_account	account_id המזהה של חשבון המפרסם ב-Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id המזהה של חשבון השותף ב-Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
linked_account	אל תגדירו את השדה linked_account.
product_destination_id	המזהה של הקהל.

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	לא מגדירים את הכותרת linked-account.

הנה דוגמה לDestination לתרחיש של גישת שותף לשליחת נתונים למפרסם ב-Display & Video 360. בתרחיש הזה, פרטי הכניסה צריכים להיות של חשבון Google שהוא משתמש בחשבון השותף ב-Display & Video 360‏ DISPLAY_VIDEO_PARTNER_ID, וחשבון המפרסם ב-Display & Video 360‏ DISPLAY_VIDEO_ADVERTISER_ID צריך להיות חשבון צאצא של חשבון השותף DISPLAY_VIDEO_PARTNER_ID.

הטמעת נתונים

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	לא מגדירים את הכותרת linked-account.

Google Analytics

הערה: אם operating_account הוא חשבון Google Analytics, אל תגדירו את login_account או הגדירו אותו לאותם ערכים כמו operating_account. אחרת, הבקשה נכשלת ומתקבלת השגיאה OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

הטמעת נתונים

יעד
operating_account	account_id המזהה של הנכס ב-Google Analytics account_type GOOGLE_ANALYTICS_PROPERTY
login_account	אל תגדירו את login_account, או הגדירו את אותם ערכים כמו operating_account.
linked_account	אל תגדירו את השדה linked_account.
product_destination_id	מזהה המדידה של מקור הנתונים.

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	לא מגדירים את הכותרת linked-account.

דוגמה ל-Destination לשליחת אירועים אל Google Analytics:

הטמעת נתונים

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	לא מגדירים את הכותרת linked-account.

תרחישים של שותפי נתונים

כך מגדירים Destination לתרחישים נפוצים של שותף נתונים ששולח נתונים לחשבונות של מפרסמים עם קישור מוצר קיים לחשבון של שותף הנתונים.

הערה: בכל תרחיש שבו משתמשים בשותף נתונים, פרטי הכניסה צריכים להיות של חשבון Google שמוגדר כמשתמש בחשבון של שותף הנתונים.

בתרשים הזה מוצג איך ה-API של המרכז לניהול נתונים משתמש בפרטי הכניסה ובשדות Destination כדי לגשת לחשבון המפרסם דרך קישור למוצר.

Google Ads

תרשים שמציג דוגמה לקבוצה של חשבונות Google Ads וחשבונות של שותפי נתונים. בדיאגרמה מוצג גם חשבון Google שבו המשתמש רשום בכל חשבון Google Ads או חשבון של שותף נתונים, וגם הקישורים בין החשבונות למוצרים.

שותף נתונים D1

קיים קישור מוצרים בין חשבון D1 לבין חשבון הניהול M2 ב-Google Ads.

חשבון Google מספר [e-mail] הוא משתמש ב-D1.

שותף נתונים D2

קיים קישור מוצרים בין D2 לבין חשבון לקוח C1 ב-Google Ads.

חשבון Google‏ [e-mail] הוא משתמש ב-D2.

חשבון ניהול M1

לחשבון M1 יש שני חשבונות צאצא ישירים:

1. חשבון ניהול M2
2. חשבון לקוח C1

חשבון ניהול M2

לחשבון M2 יש שני חשבונות צאצא ישירים:

1. חשבון לקוח C1
2. חשבון לקוח C2

חשבון לקוח C1

לחשבון C1 יש שני חשבונות ניהול הורה ישירים:

1. חשבון ניהול M1
2. חשבון ניהול M2

חשבון לקוח C2

חשבון הניהול M2 הוא ההורה הישיר היחיד של C2.

אלה הפעולות שאפשר לבצע באמצעות קבוצת החשבונות הזו:

תפעל כשותף נתונים D1

כדי לפעול כשותף נתונים D1, צריך להשתמש בפרטי הכניסה לחשבון Google מספר [e-mail] כדי לשלוח נתונים לחשבון הניהול M2, לחשבון הלקוח C1 או לחשבון הלקוח C2, באמצעות יעד שבו הערך של login_account מוגדר כחשבון שותף הנתונים D1 והערך של linked_account מוגדר כחשבון הניהול M2.

שותף הנתונים D1 לא יכול לשלוח נתונים לחשבון הניהול M1 כי אין קישור מוצר בין D1 ל-M1.

תפעל כשותף נתונים D2

כדי לפעול בתור שותף הנתונים D2, צריך להשתמש בפרטי הכניסה של חשבון Google‏ [e-mail] כדי לשלוח נתונים לחשבון הלקוח C1, באמצעות יעד עם login_account שמוגדר לחשבון שותף הנתונים D2 ועם linked_account שמוגדר לחשבון הלקוח C1.

בתור שותף הנתונים D2, אי אפשר לשלוח נתונים לחשבון הניהול M1, לחשבון הניהול M2 או לחשבון הלקוח C2, כי אין קישור מוצרים בין D2 לבין אף אחד מהחשבונות האלה או חשבונות הניהול הראשיים שלהם.

ההבדל העיקרי בין שותפי הנתונים D1 ו-D2 הוא האופן שבו שותף הנתונים מקושר לחשבונות Google Ads.

• שותף הנתונים D1 מקושר לחשבון ניהול ב-Google Ads. זו דוגמה לתרחיש של קישור מוצר לחשבון ניהול.
• שותף הנתונים D2 מקושר לחשבון לקוח ב-Google Ads. זו דוגמה לתרחיש של קישור ישיר למוצר.

תרחיש של קישור ישיר למוצר

אם אתם רוצים לשלוח נתונים לחשבון Google Ads והקישור בין המוצרים הוא בין חשבון Google Ads לבין חשבון שותף הנתונים:

הטמעת נתונים

יעד
operating_account	account_id מספר הלקוח של חשבון Google Ads account_type GOOGLE_ADS
login_account	account_id מספר הלקוח של חשבון שותף הנתונים account_type DATA_PARTNER
linked_account	אל תגדירו את השדה linked_account.
product_destination_id	המזהה של קהל היעד או של פעולת ההמרה.

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	לא מגדירים את הכותרת linked-account.

הנה דוגמה לתרחיש של קישור ישיר למוצר באמצעות חשבונות מהתרשים, וכותרות הבקשות התואמות לבקשות לניהול משאבים. בתרחיש הזה, שותף הנתונים D2 שולח נתונים של חברי קהל ללקוח Google Ads C1 באמצעות קישור המוצר בין D2 ל-C1, ופרטי הכניסה לחשבון Google [e-mail]:

הטמעת נתונים

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID
linked-account	לא מגדירים את הכותרת linked-account.

תרחיש של קישור מוצרים לחשבון ניהול

אם אתם רוצים לשלוח נתונים לחשבון Google Ads והקישור למוצר הוא בין חשבון ניהול ראשי ב-Google Ads לבין חשבון שותף הנתונים שלכם:

הטמעת נתונים

יעד
operating_account	account_id מספר הלקוח של חשבון הלקוח ב-Google Ads account_type GOOGLE_ADS
login_account	account_id מספר הלקוח של חשבון שותף הנתונים account_type DATA_PARTNER
linked_account	account_id מספר הלקוח של חשבון הניהול ב-Google Ads account_type GOOGLE_ADS
product_destination_id	המזהה של קהל היעד או של פעולת ההמרה.

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID

דוגמה לתרחיש של קישור מוצר לחשבון ניהול באמצעות חשבונות מהתרשים. בתרחיש הזה, שותף הנתונים D1 שולח נתונים של חברי קהל ללקוח C2 של Google Ads באמצעות קישור המוצר בין D1 ל-M2, ופרטי הכניסה לחשבון Google [e-mail]:

הטמעת נתונים

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D1_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID

Display & Video 360

שותפי נתונים יכולים לשלוח נתונים לחשבון Display & Video 360 בשתי דרכים:

1. שימוש בקישור ישיר למוצר בין חשבון של שותף נתונים לבין חשבון השותף או המפרסם ב-Display & Video 360.
2. שליחת נתונים למפרסם ב-Display & Video 360 באמצעות קישור מוצרים בין חשבון שותף נתונים לבין חשבון השותף הראשי של המפרסם ב-Display & Video 360.

תרחישים של קישור ישיר למוצר

אם אתם רוצים לשלוח נתונים למפרסם ב-Display & Video 360 וקישור המוצרים הוא בין חשבון המפרסם ב-Display & Video 360 לבין חשבון שותף הנתונים שלכם:

הטמעת נתונים

יעד
operating_account	account_id המזהה של חשבון המפרסם ב-Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id מספר הלקוח של חשבון שותף הנתונים account_type DATA_PARTNER
linked_account	אל תגדירו את השדה linked_account.
product_destination_id	המזהה של קהל היעד או של פעולת ההמרה.

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	לא מגדירים את הכותרת linked-account.

הנה דוגמה ל-Destination לתרחיש של קישור ישיר למוצר לשליחת נתונים למפרסם ב-Display & Video 360, וכותרות הבקשה התואמות לבקשות לניהול משאבים:

הטמעת נתונים

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	לא מגדירים את הכותרת linked-account.

אם אתם רוצים לשלוח נתונים לחשבון שותף ב-Display & Video 360, צריך להיות קישור מוצרים בין חשבון השותף ב-Display & Video 360 לבין חשבון שותף הנתונים שלכם.

הטמעת נתונים

יעד
operating_account	account_id המזהה של חשבון השותף ב-Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
login_account	account_id מספר הלקוח של חשבון שותף הנתונים account_type DATA_PARTNER
linked_account	אל תגדירו את השדה linked_account.
product_destination_id	המזהה של קהל היעד או של פעולת ההמרה.

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	לא מגדירים את הכותרת linked-account.

הנה דוגמה ל-Destination לתרחיש של קישור ישיר למוצר לשליחת נתונים לשותף ב-Display & Video 360, וכותרות הבקשה התואמות לבקשות לניהול משאבים:

הטמעת נתונים

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	לא מגדירים את הכותרת linked-account.

תרחיש של קישור מוצר שותף ב-Display & Video 360

אם רוצים לשלוח נתונים למפרסם ב-Display & Video 360 וקישור המוצרים לחשבון השותף שלכם לשיתוף נתונים הוא לחשבון שותף ב-Display & Video 360 שחשבון המפרסם הוא חשבון צאצא שלו:

הטמעת נתונים

יעד
operating_account	account_id המזהה של חשבון המפרסם ב-Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id מספר הלקוח של חשבון שותף הנתונים account_type DATA_PARTNER
linked_account	account_id המזהה של חשבון השותף ב-Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
product_destination_id	המזהה של קהל היעד או של פעולת ההמרה.

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

הנה דוגמה לDestination לתרחיש של קישור מוצר שותף לשליחת נתונים למפרסם ב-Display & Video 360 באמצעות קישור מוצר בין שותף הנתונים לבין חשבון ההורה של השותף ב-Display & Video 360 של המפרסם:

הטמעת נתונים

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

ניהול המשאבים

כותרות של בקשות
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Google Analytics

‫Data Manager API לא תומך בשליחת נתונים לחשבון Google Analytics באמצעות קישור מוצרים. במקום זאת, צריך להשתמש בגישה של תרחישים לפרסום ב-Google Analytics.

דרישות מפורטות

בקטע הזה מפורטות הדרישות לגבי שדות החשבון של Destination בבקשת IngestionService, כותרות הבקשה המקבילות לבקשות לניהול משאבים, טיפים להגדרת product_destination_id והסבר על קביעת המקומות שאליהם יש לפרטי הכניסה שלכם גישה.

שדות בחשבון

ב-Destination יכולים להיות עד 3 חשבונות שונים:

operating_account

השדה operating_account הוא שדה חובה.

הפרמטר operating_account מציין לאיזה חשבון מועברים הנתונים בבקשה. הערך operating_account יכול להיות כל אחת מהאפשרויות הבאות:

• חשבון Google Ads
• חשבון מפרסם ב-Display & Video 360
• חשבון שותף ב-Display & Video 360
• נכס ב-Google Analytics
• חשבון של שותף נתונים אם שולחים נתונים לקהל שבבעלות חשבון שותף הנתונים.

אין כותרת בקשה שמתאימה לשדה operating_account של Destination. כששולחים בקשה לניהול משאבים, חשבון היעד של הבקשה הוא החשבון הפעיל.

השדה login_account וכותרת הבקשה login-account

הפרמטר login_account לא תמיד נדרש, ובאופן ברירת מחדל הוא מוגדר לערך operating_account בבקשת IngestionService, ולחשבון היעד בבקשה לניהול משאבים. בבקשה לניהול משאבים, משתמשים בכותרת הבקשה login-account כדי לזהות את חשבון הכניסה.

ה-API של המרכז לניהול נתונים מוודא ש:

1. חשבון Google של פרטי הכניסה הוא משתמש בחשבון הכניסה.

2. החשבון שדרכו מתחברים הוא אחד מהבאים:

   • בדיוק כמו בoperating_account. זוהי ברירת המחדל אם לא מגדירים את login_account של Destination בבקשת IngestionService, או אם לא מגדירים את הכותרת login-account בבקשה לניהול משאבים.

   • חשבון ניהול ב-Google Ads או חשבון שותף ב-Display & Video 360 שהוא חשבון ראשי של operating_account בבקשת IngestionService, או חשבון ראשי של חשבון היעד בבקשה לניהול משאבים.

   • חשבון של שותף נתונים עם קישור מוצר ל-linked_account in an IngestionService request, or the linked-account header in a resource management request.

השדה linked_account וכותרת הבקשה linked-account

הערה: צריך לציין חשבון מקושר רק אם בחשבון הכניסה הערך של account_type הוא DATA_PARTNER וחשבון הורה של operating_account מקושר לחשבון השותף של הנתונים. אם operating_account מקושר ישירות לחשבון השותף של נתוני המכירות, אל תגדירו את linked_account.

הסמל linked_account מציין לאיזה חשבון יש קישור מוצר לlogin_account של בקשת IngestionService, או לחשבון היעד של בקשה לניהול משאבים.

מזהה יעד של מוצר

ה-product_destination_id של Destination מציין איזה אובייקט ב-operating_account מקבל את הנתונים. לדוגמה, יכול להיות שזה מזהה קהל ב-Google Ads או ב-Display & Video 360, מזהה פעולת המרה ב-Google Ads או מזהה מדידה בפיד נתונים של Google Analytics.

כך מוצאים את המזהה של כל סוג של יעד מוצר.

קהל ב-Google Ads

מזהה היעד של המוצר להעברת חברי הקהל הוא מזהה הקהל. אפשר לאחזר את המזהה הזה באמצעות ממשק המשתמש של Google Ads או Data Manager API.

ממשק המשתמש של Google Ads

כדי לקבל את מזהה הקהל מממשק המשתמש של Google Ads:

1. בממשק המשתמש של Google Ads, לוחצים על המרכז לניהול קהלים.
2. כדי לראות פרטים, לוחצים על שם הקהל.
3. מזהה הקהל מופיע לצד מזהה הרשימה.

Data Manager API

מאחזרים את UserList באמצעות ה-method ‏List, מספקים כותרות של בקשות אם נדרש, ומשתמשים ב-id של UserList בתור מזהה יעד המוצר.

אירוע ב-Google Ads

מזהה היעד של המוצר להעברת אירועים הוא מזהה פעולת ההמרה.

כדי לקבל את מזהה פעולת ההמרה מממשק המשתמש של Google Ads:

1. עוברים אל המרות בממשק המשתמש של Google Ads.
2. כדי לראות את הפרטים, לוחצים על השם של פעולת ההמרה.

3. מזהה פעולת ההמרה הוא הערך של פרמטר השאילתה של כתובת האתר שנקרא ctId.

   https://ads.google.com/aw/conversions/detail?ocid=...&ctId=CONVERSION_ACTION_ID&...
   

כדי לקבל את מזהה פעולת ההמרה מ-Google Ads API:

1. שליחת בקשה מסוג Search או SearchStream אל GoogleAdsService עם השאילתה הבאה:

   SELECT
     conversion_action.id,
     conversion_action.name
   FROM conversion_action
   WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'
   

2. מקבלים את המזהה של פעולת ההמרה מהשדה id בתגובה conversion_action.

   [
     {
       "results": [
         {
           "conversionAction": {
             "resourceName": "customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID",
             "id": "CONVERSION_ACTION_ID",
             "name": "CONVERSION_ACTION_NAME"
           }
         }
       ]
     }
   ]
   

קהל ב-Display & Video 360

מזהה היעד של המוצר להעברת חברי הקהל הוא מזהה הקהל. אפשר לאחזר את המזהה הזה באמצעות ממשק המשתמש של Display & Video 360 או Data Manager API.

ממשק המשתמש של Display & Video 360

כדי לקבל את מזהה הקהל מממשק המשתמש של Display & Video 360:

1. נכנסים לממשק המשתמש של Display & Video 360 בכתובת https://displayvideo.google.com.
2. עוברים אל חשבון השותף או המפרסם ב-Display & Video 360 שבו אתם משתמשים עבור operating_account.
3. בתפריט הימני, עוברים אל קהלים ובוחרים באפשרות כל הקהלים.
4. מוצאים את הקהל ברשימה. מזהה הקהל הוא המספר שלצד השם בעמודה שם.

Data Manager API

מאחזרים את UserList באמצעות ה-method ‏List, מספקים כותרות של בקשות אם נדרש, ומשתמשים ב-id של UserList בתור מזהה יעד המוצר.

אירוע ב-Google Analytics

מזהה היעד של המוצר להעברת אירועים הוא מזהה המדידה של מקור הנתונים.

קובעים לאילו מקומות יש גישה לפרטי הכניסה

פרטי הכניסה שבהם אתם משתמשים כדי לאשר בקשה ל-Data Manager API משויכים לחשבון Google ספציפי.

• אם משתמשים בפרטי כניסה של משתמש, הבקשות מאומתות כחשבון Google של המשתמש שהעניק הרשאה לפעול בשמו כשנוצרו פרטי הכניסה.
• אם משתמשים בפרטי כניסה של חשבון שירות, הבקשות מאושרות כחשבון Google של חשבון השירות.

כך בודקים שלחשבון Google שמשויך לפרטי הכניסה יש גישה לחשבון Google Ads, לחשבון Display & Video 360 או לחשבון Google Analytics.

‫Google Ads או שותף נתונים

1. בממשק המשתמש של Google Ads, עוברים אל אבטחה וגישה בקטע login_account.
2. לוחצים על הכרטיסייה משתמשים.
3. אם חשבון login_account הוא חשבון ניהול ב-Google Ads, משביתים את המתג הצגת משתמשים בהיררכיה מלאה כדי להסתיר משתמשים מחשבונות צאצא.
4. מוודאים שחשבון Google שמשמש לפרטי הכניסה מופיע ברשימת החשבונות שמוצגת בכרטיסייה משתמשים.

Display & Video 360

1. עוברים אל User management and email preferences (ניהול משתמשים והעדפות אימייל) בממשק המשתמש של Display & Video 360.
2. מוודאים שבקטע ניהול משתמשים מופיע חשבון Google עם פרטי הכניסה שלכם כמשתמש ב-login_account.

Google Analytics

1. עוברים אל ניהול הרשאות הגישה לנכס בממשק המשתמש של Google Analytics.
2. מוודאים שהנכס ב-Google Analytics שצוין ב-login_account נבחר.
3. מוודאים שבחשבון Google שמשויך לפרטי הכניסה מוגדר תפקיד עריכה או אדמין בנכס.