מיפוי שדות

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

אימות

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

שדות של בקשה

‫UploadClickConversionRequest (Google Ads API)	‫IngestEventsRequest (Data Manager API)	הערות
customer_id developer-token request header login-customer_id request header linked-customer-id request header 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. יכול להיות שהערך הזה יהיה שונה מהערך של customer_id בבקשה ל-Google Ads API. מגדירים את account_type של operating_account לערך GOOGLE_ADS.
developer-token request header	אין דוח מקביל	לא נדרש קוד מפתח לשימוש ב-Data Manager API.
login-customer-id request header	login_account	מגדירים את account_id למספר הלקוח של החשבון שדרכו מתבצעת הכניסה. מגדירים את account_type לערך GOOGLE_ADS אם חשבון הכניסה הוא חשבון Google Ads, או לערך DATA_PARTNER אם חשבון הכניסה הוא חשבון של שותף נתונים.
linked-customer-id request header	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	user_properties.customer_type	מגדירים ערך ב-enum‏ CustomerType.
אין דוח מקביל	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	ב-Google Ads API נדרשות בקשות נפרדות לכל פעולת המרה. ‫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 response header	request_id	מזהה הבקשה מוחזר כשדה תגובה ב-Data Manager API ולא ככותרת תגובה.
results	אין דוח מקביל	מערכת Data Manager API מעבדת אירועים באופן אסינכרוני. בודקים את תוצאות העיבוד באמצעות דוח האבחון.