מיפוי שדות

משתמשים במיפויים שבטבלאות כדי למפות 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.
כותרת הבקשה 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	אם אתם ניגשים אל operating_account באמצעות קישור לשותף, צריך להגדיר את account_id למספר הלקוח של החשבון המקושר ואת account_type לערך DATA_PARTNER. אחרת, לא מגדירים את השדה linked_account.
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). ב-Data Manager 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 מחייב שליחת בקשות נפרדות לכל פעולת המרה. ‫Data Manager API תומך בשליחת המרות לכמה פעולות המרה בבקשה אחת, וגם בשימוש בשדה destination_references כדי לציין אילו יעדים צריכים לקבל משתנה מותאם אישית ספציפי.
conversion_custom_variable	variable	הערך שמוגדר הוא שם המשתנה ולא שם המשאב.
value	value

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

טיפ: ב-Data Manager API, מוסיפים מזהי משתמשים לאובייקט UserData, ואז מגדירים את השדה user_data של Event. ב-Google Ads API, מזהי המשתמשים מתווספים ישירות ל-ClickConversion בשדה user_identifiers.

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