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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 המזהה של קהל היעד או של פעולת ההמרה.
ניהול המשאבים
כותרות של בקשות
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"
    }
  ]
}
ניהול המשאבים
כותרות של בקשות
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.

הנה דוגמה לתרחיש של גישת ניהול לחשבון לקוח ב-Google Ads‏ C2 מתוך התרשים ופרטי הכניסה לחשבון 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"
    }
  ]
}
ניהול המשאבים
כותרות של בקשות
login-account accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account אל תגדירו את הכותרת linked-account.

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

הטמעת נתונים
{
  "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.

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 ומשתמשים

שותף נתונים D1

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

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

שותף נתונים D2

קיים קישור שותף בין 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 כדי לשלוח נתונים לחשבון הניהול M2, לחשבון הלקוח C1 או לחשבון הלקוח C2, באמצעות יעד עם login_account שמוגדר כחשבון שותף נתונים D1 ועם linked_account שמוגדר כחשבון ניהול M2.

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

תפעל בתור שותף נתונים D2

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

כשותף נתונים 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 המזהה של קהל היעד או של פעולת ההמרה.
ניהול המשאבים
כותרות של בקשות
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"
    }
  ]
}
ניהול המשאבים
כותרות של בקשות
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 שולח נתונים של חברי קהל ללקוח Google Ads C2 באמצעות הקישור לשותף בין 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"
    }
  ]
}
ניהול המשאבים
כותרות של בקשות
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 שחשבון המפרסם הוא חשבון צאצא שלו:

הטמעת נתונים
יעד
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.

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 וכותרת הבקשה 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 וכותרת הבקשה 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, מספקים כותרות של בקשות אם נדרש, ומשתמשים ב-id של UserList כמזהה יעד המוצר.

אירוע ב-Google Ads

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

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

  1. עוברים אל המרות בממשק המשתמש של Google Ads.
  2. כדי לראות את הפרטים, לוחצים על השם של פעולת ההמרה.
  3. מזהה פעולת ההמרה הוא הערך של פרמטר השאילתה של כתובת ה-URL שנקרא 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

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

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

משתמשים במזהה האפליקציה ב-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 ובוחרים באפשרות Activities (פעילויות).
  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 שמשמש לפרטי הכניסה מופיע ברשימת החשבונות שמוצגת בכרטיסייה משתמשים.

Display & Video 360

  1. עוברים אל ניהול משתמשים והעדפות אימייל בממשק המשתמש של Display & Video 360.
  2. מוודאים שבדף ניהול משתמשים מופיע חשבון 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. מוודאים שלחשבון יש תפקיד משתמש עם ההרשאה הוספת המרות אופליין.