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

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