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

המושג 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
• Floodlight

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

• Google Ads
• Display & Video 360
• Google Ad Manager
• Google Analytics
• Floodlight

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

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

כאן מוסבר איך להגדיר 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.

דוגמה נוספת לתרחיש של גישה לחשבון ניהול בחשבון לקוח ב-Google Ads‏ C2, ופרטי כניסה לחשבון Google‏ [e-mail], שהוא משתמש בחשבון ניהול ב-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	מזהה המדידה של מקור לנתוני אתר. מזהה האפליקציה ב-Firebase של מקור לנתוני האפליקציה.

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

כותרות של בקשות
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 הוא הגדרת Floodlight, אל תגדירו את login_account או הגדירו אותו לאותם ערכים כמו operating_account. אחרת, הבקשה תיכשל ותוצג השגיאה OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

הטמעת נתונים

יעד
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 בתרחישים נפוצים של שותף נתונים ששולח נתונים לחשבונות של מפרסמים עם קישור שותף לחשבון של שותף הנתונים.

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

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

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

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

כותרות של בקשות
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"
          }
        ]
      }
      

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

כותרות של בקשות
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 יכול להיות כל אחת מהאפשרויות הבאות:

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

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

הערה: צריך לציין חשבון מקושר רק אם בחשבון הכניסה הערך של 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 או Google Ads API.

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

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

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

Google Ads API

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

אירוע ב-Google Analytics

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

מקור של נתוני אתר

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

המקור לנתוני האפליקציה

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

• בממשק המשתמש של 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. עוברים אל User management and email preferences בממשק המשתמש של 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. מוודאים שלחשבון יש תפקיד משתמש עם ההרשאה הוספת המרות אופליין.