تعيينات الحقول

استخدِم عمليات الربط في الجداول لربط UploadClickConversionRequest في Google Ads API بمكافئها IngestEventsRequest في Data Manager API.

المصادقة

تتطلّب Data Manager API بيانات اعتماد بنطاق مختلف عن Google Ads API. اتّبِع الخطوات الواردة في إعداد إمكانية الوصول إلى واجهة برمجة التطبيقات لإنشاء بيانات اعتماد جديدة تتضمّن نطاق 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. قد يختلف هذا عن customer_id في طلب Google Ads API. اضبط account_type في operating_account على GOOGLE_ADS.
عنوان طلب developer-token	بدون مكافئ	لا يلزم توفّر الرمز المميز للمطوِّر لاستخدام Data Manager API.
عنوان طلب login-customer-id	login_account	اضبط account_id على رقم تعريف عميل حساب تسجيل الدخول. اضبط account_type على GOOGLE_ADS إذا كان حساب تسجيل الدخول حسابًا على "إعلانات Google"، أو 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	تستخدم كلتا واجهتَي برمجة التطبيقات كائن 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	اضبط على قيمة في الـ 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	اتّبِع إرشادات التنسيق والتجزئة. يمكنك أيضًا تشفير السمات المجزّأة لعنوان.
hashed_email	email_address	اضبط على عنوان البريد الإلكتروني الـ منسَّق والمجزّأ. يمكنك أيضًا تشفير عنوان البريد الإلكتروني المجزّأ.
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 نموذج أخطاء سريعًا. إذا تعذّر التحقّق من أي حقل في IngestEventsRequest، ترفض Data Manager API الطلب بأكمله.
request-id عنوان الاستجابة	request_id	يتم عرض رقم تعريف الطلب كحقل ردّ في Data Manager API بدلاً من عنوان الاستجابة.
results	بدون مكافئ	تعالج Data Manager API الأحداث بشكل غير متزامن. راجِع نتائج المعالجة باستخدام بيانات التشخيص.