تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

خطوات الترقية