המושג Destination וכותרות הבקשה מופיעים לעיתים קרובות כשעובדים עם Data Manager API. במדריך הזה מוסבר איך להגדיר יעדים וכותרות לתרחישים שונים.
מתי כדאי להשתמש ביעדים או בכותרות
שימוש ב-
Destinationבבקשות להוספת נתונים. בקשת העברה משתמשת ב-IngestionServiceכדי להוסיף או להסיר חברים בקהל או לשלוח אירועים. הרשימהdestinationsב-IngestAudienceMembersRequestאו ב-IngestEventsRequestמגדירה:- החשבון שמקבל את הנתונים. לדוגמה, חשבון Google Ads או נכס ב-Google Analytics.
- ישות היעד של הנתונים בחשבון, כמו פעולת המרה ב-Google Ads או מקור נתונים ב-Google Analytics.
- נתיב הגישה של פרטי הכניסה של הבקשה לחשבון שמקבל את הנתונים.
אפשר לכלול כמה יעדים באותה בקשת העברה.
משתמשים בכותרות של בקשות בבקשות לניהול משאבים שיוצרות, מעדכנות, מוחקות או מאחזרות משאבים. הכותרות מגדירות את נתיב הגישה של פרטי הכניסה של הבקשה לחשבון היעד של בקשת ניהול המשאבים. זו רשימת המשאבים עם שיטות לניהול משאבים שתומכות בכותרות של בקשות:
לדוגמה, אם רוצים ליצור קהל, להוסיף לו חברים, לבדוק את האבחון ואז לאחזר את הקהל כדי לבדוק את הגודל שלו, הנה כל שלב, סוג הבקשה שצריך להשתמש בה והאם צריך להשתמש ביעדים או בכותרות של בקשות:
| שלב | סוג הבקשה | כותרות של בקשות או של יעד |
|---|---|---|
| יצירת קהל | ניהול המשאבים | כותרות של בקשות |
| הוספת חברים לקהל | הטמעת נתונים | יעדים |
| בדיקת דוח האבחון | הטמעת נתונים | יעדים |
| אחזור הקהל | ניהול המשאבים | כותרות של בקשות |
כדי לעבור בין הפרטים במדריך הזה לכל סוג בקשה, לוחצים על הכרטיסייה העברה או ניהול משאבים שמעל כל טבלה.
אם אתם מפרסמים או סוכנויות, אתם יכולים לעבור אל תרחישים למפרסמים כדי לראות דוגמאות להגדרת כותרות וליצירת Destination:
אם אתם שותפי נתונים, תוכלו לעבור אל תרחישים של שותפי נתונים כדי לראות דוגמאות להגדרת כותרות וליצירת Destination לניהול משאבים ולשליחת נתונים לחשבון עם קישור לשותף לחשבון שלכם כשותפי נתונים:
בקטע דרישות מפורטות מוסברות הדרישות וכללי האימות.
תרחישים של מפרסמים
כאן מוסבר איך להגדיר Destination או כותרות בקשות לתרחישים נפוצים של מפרסמים וסוכנויות. בתרשים הזה מוצג אופן השימוש בפרטי הכניסה ובשדות Destination של Data Manager API כדי לגשת לחשבון המפרסם.
Google Ads
תרשים שמציג דוגמה של קבוצת חשבונות ומשתמשים ב-Google Ads.
- חשבון ניהול M1
לחשבון M1 יש שני חשבונות צאצא ישירים:
- חשבון ניהול M2
- חשבון לקוח C1
חשבון Google
cloudysanfrancisco@gmail.comהוא משתמש ב-M1.- חשבון ניהול M2
לחשבון M2 יש שני חשבונות צאצא ישירים:
- חשבון לקוח C1
- חשבון לקוח C2
חשבון Google
baklavainthebalkans@gmail.comהוא משתמש בחשבון M2.- חשבון לקוח C1
לחשבון C1 יש שני חשבונות ניהול הורה ישירים:
- חשבון ניהול M1
- חשבון ניהול M2
חשבון Google
jeffersonloveshiking@gmail.comהוא משתמש בחשבון C1.- חשבון לקוח C2
חשבון הניהול M2 הוא ההורה הישיר היחיד של C2.
אף אחד מחשבונות Google שמופיעים ברשימה לא מוגדר כמשתמש בחשבון C2.
בתרחיש של גישה ישירה ובתרחיש של גישה דרך חשבון ניהול מוסבר איך להגדיר יעד לשליחת נתונים לחשבונות האלה.
תרחיש של גישה ישירה
אם אתם רוצים לשלוח נתונים לחשבון Google Ads והפרטים שלכם הם של חשבון Google שהוא משתמש בחשבון Google Ads:
הטמעת נתונים
| יעד | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
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 |
|
||||
login_account |
|
||||
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:
- גישה ישירה, שבה פרטי הכניסה הם לחשבון Google שמוגדר כמשתמש בחשבון המפרסם או השותף ב-Display & Video 360.
- גישת שותף ב-Display & Video 360, שבה פרטי הכניסה הם לחשבון Google שהוא חשבון משתמש בחשבון השותף ב-Display & Video 360, וחשבון ההפעלה הוא חשבון מפרסם ב-Display & Video 360 שמשויך לחשבון השותף.
תרחישים של גישה ישירה
אם רוצים לשלוח נתונים לחשבון מפרסם ב-Display & Video 360 וההרשאות שלכם הן לחשבון Google שמוגדר כמשתמש בחשבון המפרסם:
הטמעת נתונים
| יעד | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
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 |
|
||||
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 |
|
||||
login_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. בתרחיש הזה, פרטי הכניסה צריכים להיות של חשבון 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 |
|
||||
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 |
|
||||
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 או חשבון שותף נתונים, וגם הקישורים לשותפים בין החשבונות.
- שותף נתונים D1
קיים קישור שותף בין חשבון D1 לבין חשבון הניהול M2 ב-Google Ads.
חשבון Google
222larabrown@gmail.comהוא משתמש ב-D1.- שותף נתונים D2
קיים קישור שותף בין D2 לבין חשבון לקוח C1 ב-Google Ads.
חשבון Google
jeffersonloveshiking@gmail.comהוא משתמש ב-D2.- חשבון ניהול M1
לחשבון M1 יש שני חשבונות צאצא ישירים:
- חשבון ניהול M2
- חשבון לקוח C1
- חשבון ניהול M2
לחשבון M2 יש שני חשבונות צאצא ישירים:
- חשבון לקוח C1
- חשבון לקוח C2
- חשבון לקוח C1
לחשבון C1 יש שני חשבונות ניהול הורה ישירים:
- חשבון ניהול M1
- חשבון ניהול 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.
- שותף הנתונים D1 מקושר לחשבון ניהול ב-Google Ads. זו דוגמה לתרחיש של קישור שותף לחשבון ניהול.
- שותף הנתונים D2 מקושר לחשבון לקוח ב-Google Ads. זו דוגמה לתרחיש של קישור ישיר לשותף.
תרחיש של קישור ישיר לשותף
אם רוצים לשלוח נתונים לחשבון Google Ads והקישור לשותף הוא בין חשבון Google Ads לבין חשבון השותף שלכם:
הטמעת נתונים
| יעד | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
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 |
|
||||
login_account |
|
||||
linked_account |
|
||||
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 בשתי דרכים:
- שימוש בקישור ישיר לשותף בין חשבון שותף נתונים לבין חשבון השותף או המפרסם ב-Display & Video 360.
- שליחת נתונים למפרסם ב-Display & Video 360 באמצעות קישור שותף בין חשבון שותף נתונים לבין חשבון השותף הראשי של המפרסם ב-Display & Video 360.
תרחישים של קישור ישיר לשותף
אם רוצים לשלוח נתונים למפרסם ב-Display & Video 360 והקישור לשותף הוא בין חשבון המפרסם ב-Display & Video 360 לבין חשבון השותף שלכם:
הטמעת נתונים
| יעד | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
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 |
|
||||
login_account |
|
||||
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 |
|
||||
login_account |
|
||||
linked_account |
|
||||
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יכול להיות כל אחת מהאפשרויות הבאות:- חשבון Google Ads
- חשבון מפרסם ב-Display & Video 360
- חשבון שותף ב-Display & Video 360
- נכס ב-Google Analytics
- חשבון של שותף נתונים אם שולחים נתונים לקהל שבבעלות חשבון שותף הנתונים.
אין כותרת בקשה שתואמת לשדה
operating_accountשלDestination. כששולחים בקשה לניהול משאבים, חשבון היעד של הבקשה הוא החשבון הפעיל.- השדה
login_accountוכותרת הבקשהlogin-account הפרמטר
login_accountלא תמיד נדרש, ובאופן ברירת מחדל הוא מוגדר לערךoperating_accountבבקשתIngestionServiceולחשבון היעד בבקשה לניהול משאבים. בבקשה לניהול משאבים, משתמשים בכותרת הבקשהlogin-accountכדי לזהות את חשבון הכניסה.ה-Data Manager API מוודא ש:
חשבון Google של פרטי הכניסה הוא משתמש בחשבון הכניסה.
החשבון שאיתו נכנסים הוא אחד מהבאים:
זהה לערך
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
כדי לקבל את מזהה הקהל מממשק המשתמש של Google Ads:
- בממשק המשתמש של Google Ads, לוחצים על המרכז לניהול קהלים.
- כדי לראות את הפרטים, לוחצים על שם הקהל.
- מזהה הקהל מופיע לצד מזהה הרשימה.
Data Manager API
מאחזרים את UserList באמצעות ה-method List, מספקים כותרות של בקשות אם נדרש, ומשתמשים ב-id של UserList כמזהה יעד המוצר.
אירוע ב-Google Ads
מזהה היעד של המוצר להעברת אירועים הוא מזהה פעולת ההמרה.
כדי לקבל את מזהה פעולת ההמרה מממשק המשתמש של Google Ads:
- עוברים אל המרות בממשק המשתמש של Google Ads.
- כדי לראות את הפרטים, לוחצים על השם של פעולת ההמרה.
מזהה פעולת ההמרה הוא הערך של פרמטר השאילתה של כתובת ה-URL שנקרא
ctId.https://ads.google.com/aw/conversions/detail?ocid=...&ctId=CONVERSION_ACTION_ID&...
כדי לקבל את מזהה פעולת ההמרה מ-Google Ads API:
שליחת בקשה מסוג
SearchאוSearchStreamאלGoogleAdsServiceעם השאילתה הבאה:SELECT conversion_action.id, conversion_action.name FROM conversion_action WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'מקבלים את המזהה של פעולת ההמרה מהשדה
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:
- נכנסים לממשק המשתמש של Display & Video 360 בכתובת https://displayvideo.google.com.
- עוברים אל חשבון השותף או המפרסם ב-Display & Video 360 שבו אתם משתמשים עבור
operating_account. - בתפריט הימני, עוברים אל קהלים ובוחרים באפשרות כל הקהלים.
- מוצאים את הקהל ברשימה. מזהה קהל היעד הוא המספר שלצד השם בעמודה שם.
Data Manager API
מאחזרים את UserList באמצעות ה-method 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:
- נכנסים לממשק המשתמש של Campaign Manager 360.
- עוברים לחשבון המפרסם ב-Campaign Manager 360 שבו אתם משתמשים עבור
operating_account. - בתפריט הימני, עוברים אל Floodlight ובוחרים באפשרות Activities (פעילויות).
- מחפשים את הפעילות ב-Floodlight ברשימה. המזהה הוא המספר שמופיע לצד השם בעמודה שם הפעילות.
Campaign Manager 360 API
כדי לקבל את מזהה הפעילות ב-Floodlight מ-Campaign Manager 360 API:
- שליחת בקשת
listלמשאבfloodlightActivities. - מציינים את
floodlightConfigurationIdשל ההגדרה ב-Floodlight. - אפשר גם להשתמש בפרמטר
searchStringכדי לסנן לפי שם הפעילות. - מקבלים את מזהה הפעילות ב-Floodlight מהשדה
idשלFloodlightActivityשנבחר בתגובה.
קביעה של המקומות שאליהם יש לפרטי הכניסה גישה
פרטי הכניסה שבהם אתם משתמשים כדי לאשר בקשת Data Manager API משויכים לחשבון Google ספציפי.
- אם משתמשים בפרטי כניסה של משתמש, הבקשות מאושרות כחשבון Google של המשתמש שהעניק הרשאה לפעול בשמו כשנוצרו פרטי הכניסה.
- אם משתמשים בפרטי כניסה של חשבון שירות, הבקשות מאושרות כחשבון Google של חשבון השירות.
כך בודקים שלחשבון Google שמשמש לאימות יש גישה לחשבון Google Ads, Display & Video 360, Google Analytics או Campaign Manager 360.
שותף נתונים או Google Ads
- בממשק המשתמש של Google Ads, עוברים אל אבטחה וגישה עבור
login_account. - בוחרים בכרטיסייה משתמשים.
- אם חשבון
login_accountהוא חשבון ניהול ב-Google Ads, משביתים את המתג הצגת המשתמשים בהיררכיה המלאה כדי להסתיר משתמשים מחשבונות צאצא. - מוודאים שחשבון Google שמשמש לפרטי הכניסה מופיע ברשימת החשבונות שמוצגת בכרטיסייה משתמשים.
Display & Video 360
- עוברים אל ניהול משתמשים והעדפות אימייל בממשק המשתמש של Display & Video 360.
- מוודאים שבדף ניהול משתמשים מופיע חשבון Google עם פרטי הכניסה שלכם כמשתמש ב-
login_account.
Google Analytics
- עוברים אל ניהול הרשאות הגישה לנכס בממשק המשתמש של Google Analytics.
- מוודאים שהנכס ב-Google Analytics שצוין ב-
login_accountנבחר. - מוודאים שבחשבון Google שמשמש לפרטי הכניסה מוגדר תפקיד עריכה או תפקיד האדמין בנכס.
Floodlight (Campaign Manager 360)
- נכנסים לממשק המשתמש של Campaign Manager 360.
- בתפריט הימני, עוברים אל ניהול > פרופילי משתמשים.
- מוודאים שחשבון Google שמשויך לפרטי הכניסה שלכם מופיע ברשימת הפרופילים.
- לוחצים על הפרופיל ומוודאים שיש לו גישה לחשבון המפרסם שמשמש כ
login_account. אם לא מגדיריםlogin_accountבבקשה, ברירת המחדל היאoperating_account. מוודאים שלחשבון יש תפקיד משתמש עם ההרשאה הוספת המרות אופליין.