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

استخدِم عمليات الربط في الجداول لربط 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. اضبط 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
بدون مكافئ	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	غير مناسب لي	لا تتيح أيٌّ من واجهتَي برمجة التطبيقات هذه المعرّفات للإحالات الناجحة خارج إطار الإنترنت أو الإحالات الناجحة المحسّنة للعملاء المحتملين، ولا يتيح 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 الأحداث بشكل غير متزامن. راجِع نتائج المعالجة باستخدام بيانات التشخيص.