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

استخدِم عمليات الربط في الجداول لربط 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 الأحداث بشكل غير متزامن. اطّلِع على نتائج المعالجة باستخدام بيانات التشخيص.