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

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