מיפוי שדות

משתמשים במיפויים שבטבלאות כדי למפות UploadClickConversionRequest ב-Google Ads API למקבילה שלו IngestEventsRequest ב-Data Manager API.

שדות של בקשה

‫`UploadClickConversionRequest` (Google Ads API)	‫`IngestEventsRequest` (Data Manager API)	הערות
`customer_id` כותרת הבקשה `developer-token` כותרת הבקשה `login-customer_id` כותרת הבקשה `linked-customer-id` `conversion_action`	`destinations`	מידע על שדות של לקוחות ופעולות המרה
אין דוח מקביל	`consent`	הגדרות ברירת מחדל אופציונליות להסכמה לשימוש בנתונים של אירועים בבקשה. אפשר לשנות את הערך הזה לאירוע ספציפי על ידי הגדרת השדה `consent` של `Event`.
אין דוח מקביל	`encoding`	חובה: מגדירים את הערך `Encoding` שמשמש לערכים של `UserIdentifier`.
אין דוח מקביל	`encryption_info`	הגדרה אם הבקשה מכילה ערכים מוצפנים. פרטים נוספים זמינים במאמר בנושא הצפנה.
`job_id`	אין דוח מקביל	משתמשים ב-`request_id` שמוחזר בתגובה כדי לאחזר אבחון.
`partial_failure`	אין דוח מקביל	‫Data Manager API לא תומך בכשל חלקי. אם שדה כלשהו ב-`IngestEventsRequest` נכשל באימות, Data Manager API דוחה את הבקשה כולה.
`validate_only`	`validate_only`
`conversions`	`events`	רשימת ההמרות או האירועים. פרטים נוספים זמינים בקטע 'שדות המרה'.

שדות של לקוחות ושל פעולות המרה

ב-Google Ads API נדרשת developer-token כותרת בקשה, ומגדירים את login-customer-id ו-linked-customer-id כותרות הבקשה לתרחישי אימות שונים.

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

כך ממפים את השדות של Google Ads API עבור conversion_action יחיד לשדות המקבילים ב-Destination:

Google Ads API	‫`Destination` (Data Manager API)	הערות
`customer_id` של הבקשה	`operating_account`	מגדירים את `account_id` למספר הלקוח של חשבון ההמרות ב-Google Ads. מגדירים את `account_type` של `operating_account` לערך `GOOGLE_ADS`. יכול להיות ש-Data Manager API ידרוש מזהה לקוח שונה מזה שמשמש אתכם ב-Google Ads API. פרטים נוספים מופיעים במאמר ההבדלים בדרישות לגבי חשבון היעד.
כותרת הבקשה `developer-token`	אין דוח מקביל	לא נדרש קוד מפתח ל-Data Manager API.
כותרת הבקשה `login-customer-id`	`login_account`	מגדירים את `account_id` למספר הלקוח של החשבון שאיתו מתחברים. מגדירים את `account_type` לערך `GOOGLE_ADS` אם חשבון הכניסה הוא חשבון Google Ads, או לערך `DATA_PARTNER` אם חשבון הכניסה הוא חשבון של שותף נתונים.
כותרת הבקשה `linked-customer-id`	`linked_account`	מגדירים את הערך של `account_id` למספר הלקוח של החשבון המקושר. מגדירים את `account_type` לערך `DATA_PARTNER`.
`conversion_action` מתוך `ClickConversion`	`product_destination_id`	מוגדר למזהה המספרי של פעולת ההמרה. אסור להשתמש בשם המשאב של `ConversionAction`.
אין דוח מקביל	`reference`	מזהה שהמשתמש מגדיר עבור `Destination`. צריך להגדיר את השדה הזה אם שולחים המרות למספר פעולות המרה בבקשה אחת.

שדות המרה

‫`ClickConversion` (Google Ads API)	‫`Event` (Data Manager API)	הערות
`cart_data`	`cart_data`	פרטים נוספים זמינים במאמר בנושא השדות של נתוני עגלות הקניות.
`consent`	`consent`	בשני ממשקי ה-API נעשה שימוש באובייקט `Consent` דומה (`ad_user_data`, `ad_personalization`). ב-API של המרכז לניהול נתונים, אפשר גם להגדיר הסכמה לכל האירועים בבקשה על ידי הגדרת השדה `consent` ברמת הבקשה.
`conversion_action`	`destination_references`	אם שולחים המרות למספר פעולות המרה בבקשה אחת, צריך להגדיר בשדה הזה את הערך `reference` המתאים של יעד.
`conversion_date_time`	`event_timestamp`	אם משתמשים בפורמט JSON, צריך להגדיר ערך בפורמט RFC 3339, ששונה מעט מפורמט התאריך והשעה של Google Ads API. אם משתמשים ב-protocol buffers, צריך להשתמש ב-`Timestamp` ולהגדיר את השדות `seconds` ו-(אופציונלית) `nanoseconds`. פרטים נוספים מופיעים בקטע פורמט של חותמות זמן.
`conversion_environment`	אין דוח מקביל
`conversion_value`	`conversion_value`	הערך שצריך להגדיר הוא ערך המטבע, ולא הערך במיקרו. לדוגמה, אם ערך ההמרה הוא 5.23$, משתמשים בערך `5.23`.
`currency_code`	`currency`
`custom_variables`	`custom_variables`	פרטים נוספים זמינים במאמר בנושא שדות של משתנים מותאמים אישית.
`customer_type`
אין דוח מקביל	`event_source`
אין דוח מקביל	`event_device_info`
`external_attribution_data`	אין דוח מקביל
`gbraid`	`ad_identifiers.gbraid`
`gclid`	`ad_identifiers.gclid`
אין דוח מקביל	`last_updated_timestamp`
`order_id`	`transaction_id`
`session_attributes_encoded`	`ad_identifiers.session_attributes`	לפרטים נוספים, אפשר לעיין במאמר בנושא הוספת מאפייני סשן.
`session_attributes_key_value_pairs`	`experimental_fields`	לפרטים נוספים, אפשר לעיין במאמר בנושא הוספת מאפייני סשן.
`user_identifiers`	`user_data.user_identifiers`	פרטים נוספים זמינים במאמר בנושא שדות של מזהי משתמשים.
`user_ip_address`	`landing_page_device_info.ip_address`
`wbraid`	`ad_identifiers.wbraid`

השדות של נתוני עגלות הקניות

‫`CartData` (Google Ads API)	‫`CartData` (Data Manager API)	הערות
`feed_country_code`	`merchant_feed_label`	מגדירים את הערך לתווית הפיד.
`feed_language_code`	`merchant_feed_language_code`
`items`	`items`
`local_transaction_cost`	`transaction_discount`
`merchant_id`	`merchant_id`

שדות פריטים של נתוני עגלות הקניות

‫`Item` (Google Ads API)	‫`Item` (Data Manager API)	הערות
`product_id`	`merchant_product_id`
`quantity`	`quantity`
`unit_price`	`unit_price`
אין דוח מקביל	`item_id`
אין דוח מקביל	`additional_item_parameters`

שדות של משתנים מותאמים אישית

‫`CustomVariable` (Google Ads API)	‫`CustomVariable` (Data Manager API)	הערות
אין דוח מקביל	`destination_references`	ה-API של Google Ads מחייב שליחת בקשות נפרדות לכל פעולת המרה. ה-API של המרכז לניהול נתונים תומך בשליחת המרות לכמה פעולות המרה בבקשה אחת, וגם בשימוש בשדה `destination_references` הזה כדי לציין אילו יעדים צריכים לקבל משתנה מותאם אישית ספציפי.
`conversion_custom_variable`	`variable`	הערך שמוגדר הוא שם המשתנה ולא שם המשאב.
`value`	`value`

שדות של מזהי משתמשים

‫`UserIdentifier` (Google Ads API)	‫`UserIdentifier` (Data Manager API)
`address_info`	`address`	פועלים לפי ההנחיות בנוגע לפורמט ולגיבוב. אפשר גם להצפין את מאפייני הכתובת שעברו גיבוב.
`hashed_email`	`email_address`	הערך שמוגדר הוא כתובת האימייל בפורמט מגובב. אפשר גם להצפין את כתובת האימייל שעברה גיבוב.
`hashed_phone_number`	`phone_number`	הערך מוגדר למספר הטלפון בפורמט מגובב. אפשר גם להצפין את מספר הטלפון המגובב.
שדות אחרים: `mobile_id` `third_party_user_id` `user_identifier_source`	לא רלוונטי	אף אחד מהממשקי ה-API לא תומך במזהים האלה להמרות אופליין או להמרות משופרות לצורך שיוך ללידים, ו-Data Manager API לא תומך במזהים האלה כששולחים אירועי המרה כמקור נתונים נוסף.

שדות תשובה

‫`UploadClickConversionResponse` (Google Ads API)	‫`IngestEventsResponse` (Data Manager API)	הערות
`job_id`	אין דוח מקביל	משתמשים ב-`request_id` שמוחזר בתגובה כדי לאחזר אבחון.
`partial_failure_error`	אין דוח מקביל	‫Data Manager API לא תומך בכשל חלקי. אם שדה כלשהו ב-`IngestEventsRequest` נכשל באימות, Data Manager API דוחה את הבקשה כולה.
`request-id` כותרת תגובה	`request_id`	מזהה הבקשה מוחזר כשדה בתגובה ב-Data Manager API, ולא ככותרת בתגובה.
`results`	אין דוח מקביל	ה-API של המרכז לניהול נתונים מעבד אירועים באופן אסינכרוני. בודקים את תוצאות העיבוד באמצעות דוח האבחון.

שלבים לשדרוג