מיפוי שדות

אתם יכולים להשתמש במיפויים שבטבלאות כדי למפות 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 ‫request header של developer-token ‫request header של login-customer_id ‫request header של linked-customer-id conversion_action	destinations	שדות של לקוחות ופעולות המרה
אין דוח מקביל	consent	הגדרות ברירת מחדל אופציונליות בנוגע להסכמה לאירועים בבקשה. אפשר לשנות את הערך הזה לאירוע ספציפי על ידי הגדרת השדה consent של Event.
אין דוח מקביל	encoding	חובה: צריך להגדיר את Encoding שמשמש לערכי UserIdentifier.
אין דוח מקביל	encryption_info	צריך להגדיר אם הבקשה מכילה ערכים מוצפנים. פרטים נוספים זמינים במאמר הצפנה.
job_id	אין דוח מקביל	משתמשים ב-request_id שמוחזר בתגובה כדי לאחזר אבחון.
partial_failure	אין דוח מקביל	‫Data Manager API משתמש במודל שגיאות מסוג fast-fail. אם שדה כלשהו של 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.
‫request header של developer-token	אין דוח מקביל	לא צריך קוד מפתח כדי להשתמש ב-Data Manager API.
‫request header של login-customer-id	login_account	מגדירים את account_id למספר הלקוח של חשבון ההתחברות. מגדירים את account_type כ-GOOGLE_ADS אם החשבון שמתחברים אליו הוא חשבון Google Ads, או כ-DATA_PARTNER אם החשבון שמתחברים אליו הוא חשבון של שותף נתונים.
‫request header של 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. אם משתמשים במאגרי אחסון לפרוטוקולים, צריך להשתמש ב-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

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

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

שדות תשובה

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