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

استخدِم عمليات الربط في الجداول لربط 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`. قد تتطلّب Data Manager API معرّف عميل مختلفًا عن المعرّف الذي تستخدمه في Google Ads API. لمزيد من التفاصيل، يُرجى الاطّلاع على الاختلاف في متطلبات الحساب الوجهة.
عنوان طلب `developer-token`	بدون مكافئ	لا يلزم توفّر رمز مميز للمطوِّر لاستخدام Data Manager API.
عنوان طلب `login-customer-id`	`login_account`	اضبط قيمة `account_id` على رقم تعريف العميل الخاص بحساب تسجيل الدخول. اضبط قيمة `account_type` على `GOOGLE_ADS` إذا كان حساب تسجيل الدخول هو حساب على "إعلانات Google"، أو على `DATA_PARTNER` إذا كان حساب تسجيل الدخول هو حساب شريك بيانات.
عنوان طلب `linked-customer-id`	`linked_account`	اضبط قيمة `account_id` على رقم تعريف العميل الخاص بالحساب المرتبط. اضبط قيمة `account_type` على `DATA_PARTNER`.
‫`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`

حقول معرّفات المستخدمين

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

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