הגדרת יעדים

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

הנה דוגמה לתרחיש של גישה ישירה, באמצעות החשבונות מהתרשים ופרטי הכניסה לחשבון 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"
    }
  ]
}

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

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

הנה דוגמה לתרחיש של גישת ניהול לחשבון לקוח ב-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"
    }
  ]
}

הנה דוגמה נוספת לתרחיש של גישת ניהול לחשבון לקוח C2 ב-Google Ads ולפרטי כניסה לחשבון 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"
    }
  ]
}

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 המזהה של הקהל.

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

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

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

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

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

תרחיש של גישה לשותף ב-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 המזהה של הקהל.

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

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

Google Analytics

הערה: הערכים operating_account ו-login_account צריכים להיות זהים אם היעד הוא חשבון Google Analytics. אחרת, הבקשה תיכשל ותוצג השגיאה 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 מזהה המדידה של מקור הנתונים.

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

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_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 המזהה של קהל היעד או של פעולת ההמרה.

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

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

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

דוגמה לתרחיש של קישור מוצר לחשבון ניהול באמצעות חשבונות מהתרשים. בתרחיש הזה, שותף הנתונים 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"
    }
  ]
}

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

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

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

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

הנה דוגמה ל-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"
    }
  ]
}

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

הנה דוגמה ל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"
    }
  ]
}

Google Analytics

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

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

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

שדות בחשבון

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

operating_account

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

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

login_account

הפרמטר login_account לא תמיד נדרש, וברירת המחדל שלו היא operating_account.

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

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

  2. הערך של login_account הוא אחד מהבאים:

    • בדיוק כמו בoperating_account. זו ברירת המחדל אם לא מגדירים את login_account.

    • חשבון ניהול ב-Google Ads או חשבון שותף ב-Display & Video 360 שהוא חשבון אב של operating_account.

    • חשבון של שותף נתונים עם קישור מוצרים אל linked_account.

linked_account

הסמל linked_account מציין לאיזה חשבון יש קישור מוצר אל login_account.

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

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

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

קהל ב-Google Ads

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

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

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

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

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

    SELECT
  user_list.id,
  user_list.name
FROM user_list
WHERE user_list.name = 'USER_LIST_NAME'

  2. מקבלים את מזהה הקהל מהשדה id ב-user_list בתשובה.

    [
  {
    "results": [
      {
        "userList": {
          "resourceName": "customers/CUSTOMER_ID/userLists/USER_LIST_ID",
          "id": "USER_LIST_ID",
          "name": "USER_LIST_NAME"
        }
      }
    ]
  }
]

אירוע ב-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:

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

אירוע ב-Google Analytics

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

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

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

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

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

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

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

Display & Video 360

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

Google Analytics

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