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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

נתיב הגישה של המפרסם

Google Ads

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

חשבונות ומשתמשים ב-Google Ads

חשבון ניהול M1

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

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

חשבון Google cloudysanfrancisco@gmail.com הוא משתמש ב-M1.

חשבון ניהול M2

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

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

חשבון Google baklavainthebalkans@gmail.com הוא משתמש ב-M2.

חשבון לקוח C1

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

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

חשבון Google jeffersonloveshiking@gmail.com הוא משתמש ב-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 המזהה של הקהל או של פעולת ההמרה.
ניהול המשאבים
Request headers
login-account accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account אל תגדירו את הכותרת linked-account.

דוגמה לתרחיש של גישה ישירה, באמצעות החשבונות מהתרשים ופרטי הכניסה לחשבון Google‏ jeffersonloveshiking@gmail.com:

הטמעת נתונים
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

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

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
ניהול המשאבים
Request headers
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 המזהה של הקהל או של פעולת ההמרה.
ניהול המשאבים
Request headers
login-account accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account אל תגדירו את הכותרת linked-account.

הנה דוגמה לתרחיש של גישת ניהול לחשבון הלקוח C2 ב-Google Ads מהתרשים ופרטי הכניסה לחשבון Google baklavainthebalkans@gmail.com:

הטמעת נתונים
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
ניהול המשאבים
Request headers
login-account accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account אל תגדירו את הכותרת linked-account.

הנה עוד דוגמה לתרחיש של גישה לחשבון ניהול, שבו חשבון הלקוח ב-Google Ads הוא C2 ופרטי הכניסה הם של חשבון Google ‏cloudysanfrancisco@gmail.com, שהוא משתמש בחשבון הניהול M1 ב-Google Ads:

הטמעת נתונים
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
ניהול המשאבים
Request headers
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 המזהה של הקהל.
ניהול המשאבים
Request headers
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"
    }
  ]
}
ניהול המשאבים
Request headers
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 המזהה של הקהל.
ניהול המשאבים
Request headers
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"
    }
  ]
}
ניהול המשאבים
Request headers
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 המזהה של הקהל.
ניהול המשאבים
Request headers
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"
    }
  ]
}
ניהול המשאבים
Request headers
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
ניהול המשאבים
Request headers
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"
    }
  ]
}
ניהול המשאבים
Request headers
login-account accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account אל תגדירו את הכותרת linked-account.

Floodlight

הטמעת נתונים
יעד
operating_account
account_id המזהה של תצורת Floodlight
אם המפרסם שלכם הוא מפרסם משני של מפרסם ראשי, צריך להשתמש במזהה של המפרסם הראשי ב-Campaign Manager 360 בתור המזהה של תצורת Floodlight. אחרת, משתמשים במזהה של המפרסם. איך מוצאים את מזהה המפרסם בממשק המשתמש של Campaign Manager 360
account_type FLOODLIGHT_CONFIG
login_account אפשר לא להגדיר את login_account, או להגדיר אותו לאותם ערכים כמו operating_account.
linked_account אל תגדירו את השדה linked_account.
product_destination_id מזהה הפעילות ב-Floodlight

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

הטמעת נתונים
        {
          "destinations": [
            {
              "operatingAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "loginAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "productDestinationId": "FLOODLIGHT_ACTIVITY_ID"
            }
          ]
        }

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

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

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

נתיב הגישה של שותף הנתונים

Google Ads

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

חשבונות ומשתמשים של שותפי נתונים ו-Google Ads

שותף נתונים 1

יש קישור שותף בין D1 לבין חשבון הניהול M2 ב-Google Ads.

חשבון Google 222larabrown@gmail.com הוא משתמש בדומיין D1.

שותף נתונים 2

יש קישור שותף בין D2 לבין חשבון הלקוח C1 ב-Google Ads.

חשבון Google‏ jeffersonloveshiking@gmail.com הוא משתמש ב-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‏ 222larabrown@gmail.com כדי:

  • שולחים נתונים לחשבון הלקוח C1 או לחשבון הלקוח C2, באמצעות יעד שבו login_account מוגדר לחשבון שותף הנתונים D1 ו-linked_account מוגדר לחשבון הניהול M2.

  • שולחים נתונים ישירות לחשבון הניהול M2, באמצעות יעד שבו login_account מוגדר לחשבון שותף הנתונים D1. אל תגדירו את linked_account.

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

אתה שותף הנתונים D2

כדי לפעול כשותף המידע D2, צריך להשתמש בפרטי הכניסה של חשבון Google‏ jeffersonloveshiking@gmail.com כדי לשלוח נתונים לחשבון הלקוח C1, באמצעות יעד שבו login_account מוגדר לחשבון של שותף המידע D2. אל תגדירו את linked_account.

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

ההבדל העיקרי בין שותפי הנתונים D1 ו-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 המזהה של הקהל או של פעולת ההמרה.
ניהול המשאבים
Request headers
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account אל תגדירו את הכותרת linked-account.

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

הטמעת נתונים
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
ניהול המשאבים
Request headers
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 המזהה של הקהל או של פעולת ההמרה.
ניהול המשאבים
Request headers
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 222larabrown@gmail.com:

הטמעת נתונים
{
  "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"
    }
  ]
}
ניהול המשאבים
Request headers
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 המזהה של הקהל או של פעולת ההמרה.
ניהול המשאבים
Request headers
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account אל תגדירו את הכותרת linked-account.

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

הטמעת נתונים
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
ניהול המשאבים
Request headers
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 המזהה של הקהל או של פעולת ההמרה.
ניהול המשאבים
Request headers
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account אל תגדירו את הכותרת linked-account.

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

הטמעת נתונים
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
ניהול המשאבים
Request headers
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_ADVERTISER
login_account
account_id מספר הלקוח של חשבון שותף הנתונים
account_type DATA_PARTNER
linked_account
account_id המזהה של חשבון השותף ב-Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
product_destination_id המזהה של הקהל או של פעולת ההמרה.
ניהול המשאבים
Request headers
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"
    }
  ]
}
ניהול המשאבים
Request headers
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Google Ad Manager

אם אתם רוצים לשלוח נתונים לחשבון Google Ad Manager ויש לכם קישור שותף בין החשבון של שותף הנתונים לחשבון Google Ad Manager:

הטמעת נתונים
יעד
operating_account
account_id מזהה הקישור לקהל של החשבון ב-Google Ad Manager
account_type GOOGLE_AD_MANAGER_AUDIENCE_LINK
login_account
account_id מספר הלקוח של חשבון שותף הנתונים
account_type DATA_PARTNER
linked_account אל תגדירו את השדה linked_account.
product_destination_id המזהה של הקהל.
ניהול המשאבים
Request headers
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account אל תגדירו את הכותרת linked-account.

הנה דוגמה ל-Destination לשליחת נתונים לחשבון Google Ad Manager באמצעות קישור שותף:

הטמעת נתונים
      {
        "destinations": [
          {
            "operatingAccount": {
              "accountId": "GAM_AUDIENCE_LINK_ID",
              "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK"
            },
            "loginAccount": {
              "accountId": "DATA_PARTNER_ID",
              "accountType": "DATA_PARTNER"
            },
            "productDestinationId": "AUDIENCE_ID"
          }
        ]
      }
ניהול המשאבים
Request headers
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account אל תגדירו את הכותרת linked-account.

Google Analytics

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

Floodlight

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

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

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

שדות החשבון

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

operating_account

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

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

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

השדה login_account וה-request header‏ login-account

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

‫Data Manager API מוודא ש:

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

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

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

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

    • חשבון של שותף נתונים עם קישור שותף אל linked_account בבקשת IngestionService, או הכותרת linked-account בבקשה לניהול משאבים.

השדה linked_account וה-request header‏ 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:

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

Data Manager API

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

אירוע ב-Google Ads

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

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

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

כדי לקבל את מזהה פעולת ההמרה מ-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

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

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

משתמשים במזהה האפליקציה ב-Firebase של מקור הנתונים. יש שתי דרכים למצוא את מזהה האפליקציה ב-Firebase:

  • בממשק המשתמש של Google Analytics, עוברים אל Data streams, לוחצים על מקור הנתונים ומחפשים את מזהה אפליקציית Firebase.
  • שימוש במסוף Firebase.

אירוע ב-Floodlight

מזהה היעד של המוצר להטמעת אירועים ב-Floodlight הוא מזהה הפעילות ב-Floodlight. אפשר לאחזר את המזהה הזה באמצעות ממשק המשתמש של Campaign Manager 360 או Campaign Manager 360 API.

ממשק המשתמש של Campaign Manager 360

כדי לקבל את מזהה הפעילות ב-Floodlight מממשק המשתמש של Campaign Manager 360:

  1. נכנסים לממשק המשתמש של Campaign Manager 360.
  2. עוברים למפרסם ב-Campaign Manager 360 שבו משתמשים בשביל operating_account.
  3. בתפריט הימני, לוחצים על Floodlight ואז על פעילויות.
  4. מוצאים את הפעילות ב-Floodlight ברשימה. המזהה הוא המספר שמופיע לצד השם בעמודה שם הפעילות.

Campaign Manager 360 API

כדי לקבל את מזהה הפעילות ב-Floodlight מ-Campaign Manager 360 API:

  1. שולחים בקשת list למשאב floodlightActivities.
  2. מציינים את ה-floodlightConfigurationId של הגדרת Floodlight.
  3. אפשר גם להשתמש בפרמטר searchString כדי לסנן לפי שם הפעילות.
  4. מקבלים את מזהה הפעילות ב-Floodlight מהשדה id של FloodlightActivity שנבחר בתגובה.

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

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

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

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

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

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

Display & Video 360

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

Google Analytics

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

‫Floodlight‏ (Campaign Manager 360)

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