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

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

استخدِم عمليات الربط في الجداول لربط طلب جمع البيانات في Measurement Protocol (/mp/collect) بما يعادله في IngestEventsRequest في Data Manager API.

المصادقة

تتطلّب واجهة Data Manager API بيانات اعتماد OAuth بدلاً من api_secret. اتّبِع الخطوات الواردة في مقالة إعداد إمكانية الوصول إلى واجهة برمجة التطبيقات لإنشاء بيانات اعتماد جديدة تتضمّن نطاق Data Manager API.

حقول الطلب

طلب `/mp/collect` (Measurement Protocol)	`IngestEventsRequest` (Data Manager API)	ملاحظات
‫`measurement_id` (مَعلمة طلب البحث)	`destinations`	الربط بـ "`product_destination_id`" من أجل أحداث الويب يُرجى الاطّلاع على حقول الوجهة لمزيد من التفاصيل.
‫`firebase_app_id` (مَعلمة طلب البحث)	`destinations`	الربط بـ `product_destination_id` من أجل أحداث التطبيق يُرجى الاطّلاع على حقول الوجهة لمزيد من التفاصيل.
‫`api_secret` (مَعلمة طلب البحث)	بدون مكافئ	يُرجى الاطّلاع على مقالة إعداد إمكانية الوصول إلى واجهة برمجة التطبيقات للتعرّف على كيفية مصادقة الطلبات في Data Manager API.
`consent`	`consent`	يجب ضبطها على عنصر `Consent`.
`events`	`events`	يجب ضبط هذه السمة على قائمة بموارد `Event`. لمزيد من التفاصيل، يُرجى الاطّلاع على قسم حقول الأحداث.
`client_id`	`events.client_id`	مطلوبة لأحداث الويب.
`app_instance_id`	`events.app_instance_id`	مطلوبة لأحداث التطبيق.
`user_id`	`events.user_id`	اختيارية: هي معرّف فريد لعميل.
`timestamp_micros`	`events.event_timestamp`	في Measurement Protocol، يمكن تقديم هذه القيمة على مستوى الطلب أو لحدث فردي. في Data Manager API، لا يتوفّر طابع زمني على مستوى الطلب. اضبط `event_timestamp` في كل حدث على وقت وقوع الحدث. في حال استخدام تنسيق JSON، اضبط القيمة على تنسيق RFC 3339. في حال استخدام Protocol Buffers، استخدِم `Timestamp` واضبط الحقلَين `seconds` و`nanoseconds` (اختياري). يمكنك الاطّلاع على تنسيق الطابع الزمني لمزيد من التفاصيل.
`user_properties`	`events.user_properties`	يجب ضبطها على عنصر `UserProperties`. في حال إرسال نوع المستخدِم أو مجموعة القيمة التي ينتمي إليها، استخدِم الحقل `customer_type` أو `customer_value_bucket` على التوالي من `UserProperties`. بالنسبة إلى خصائص المستخدمين الأخرى، أنشِئ عنصر `UserProperty` منفصلاً، واضبط حقلَي `property_name` و`value`، وأضِفه إلى قائمة `additional_user_properties`. لا تتيح واجهة Data Manager API ضبط الطوابع الزمنية لسمات المستخدمين الفردية. يتم استنتاج الطوابع الزمنية المرتبطة بالتغييرات في خصائص المستخدم من الطابع الزمني للحدث (`event_timestamp`).
`user_data`	`events.user_data`	يجب ضبطها على عنصر `UserData`. لمعرفة التفاصيل، يُرجى الاطّلاع على حقول معرّفات المستخدمين.
`non_personalized_ads`	`events.consent.ad_personalization`	إذا كانت قيمة `non_personalized_ads` هي `true`، اضبط قيمة `ad_personalization` على `CONSENT_DENIED`.
`user_location`	`events.event_location`	يُرجى الاطّلاع على حقول الموقع الجغرافي للمستخدم لمعرفة التفاصيل.
`ip_override`	`events.event_device_info.ip_address`
`device`	`events.event_device_info`	لمعرفة التفاصيل، يُرجى الاطّلاع على حقول الجهاز.
`user_agent`	`events.event_device_info.user_agent`
`validation_behavior`	بدون مكافئ	استخدِم بيانات التشخيص لاسترداد حالة التحميل بالإضافة إلى الأخطاء والتحذيرات المتعلّقة بالأحداث الفردية أثناء المعالجة اللاحقة. إذا تعذّر تنفيذ `IngestEventsRequest` (على سبيل المثال، بسبب عدم توفّر حقول مطلوبة)، لن تتم معالجة أي أحداث وسيكون عليك حلّ الخطأ وإعادة محاولة إرسال الطلب. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة فهم أخطاء واجهة برمجة التطبيقات.
`/debug/mp/collect`	`validate_only`	اضبط المَعلمة `validate_only` على `true` للتحقّق من صحة الأحداث بدون نقل أي بيانات، على غرار خادم التحقق من بنية الأحداث في Measurement Protocol.
بدون مكافئ	`encoding`	هذا الحقل مطلوب لتحميل `UserData`. يجب ضبطها على `Encoding` المستخدَمة لقيم `UserIdentifier`.

حقول الوجهة

يرسل Measurement Protocol الأحداث مباشرةً إلى مصدر بيانات معيّن باستخدام مَعلمة طلب البحث measurement_id أو firebase_app_id.

تستخدم واجهة Data Manager API عنصر Destination لتحديد مكان إرسال البيانات. يمكنك الاطّلاع على ضبط الوجهات لمزيد من المعلومات حول الوجهات.

في ما يلي كيفية ربط حقول Measurement Protocol بالحقول المكافئة في Destination:

Measurement Protocol	`Destination` (Data Manager API)	ملاحظات
‫`measurement_id` (مَعلمة طلب البحث)	`product_destination_id`	يجب ضبطه على رقم تعريف القياس لمصدر بيانات الموقع الإلكتروني في "إحصاءات Google"
‫`firebase_app_id` (مَعلمة طلب البحث)	`product_destination_id`	يجب ضبط هذه المَعلمة على رقم تعريف تطبيق Firebase لمصدر بيانات التطبيق في "إحصاءات Google"
بدون مكافئ	`operating_account`	اضبط `account_id` على رقم تعريف موقع على "إحصاءات Google". اضبط النوع `account_type` على `GOOGLE_ANALYTICS_PROPERTY`.
بدون مكافئ	`login_account`	اضبط `account_id` على رقم تعريف موقع على "إحصاءات Google". اضبط النوع `account_type` على `GOOGLE_ANALYTICS_PROPERTY`.

حقول الحدث

منصة Measurement Protocol في "`events[]`"	`Event` (Data Manager API)	ملاحظات
`name`	`event_name`	إذا كان `event_name` يستخدم اسمًا محجوزًا، ترفض واجهة برمجة التطبيقات الحدث وتعرض الخطأ `INVALID_EVENT_NAME`.
بدون مكافئ	`event_source`	يجب ضبط هذه المَعلمة على `WEB` إذا تم إنشاء الحدث من متصفّح ويب، وعلى `APP` إذا تم إنشاؤه من تطبيق.
بدون مكافئ	`destination_references`	مطلوبة إذا كانت قائمة `destinations` على مستوى الطلب تحتوي على أكثر من `Destination` واحدة في "إحصاءات Google". أضِف إدخالاً لتحديد الوجهة التي يجب أن تتلقّى الحدث.
`timestamp_micros`	`event_timestamp`	في حال استخدام تنسيق JSON، اضبط القيمة على تنسيق RFC 3339. في حال استخدام Protocol Buffers، استخدِم `Timestamp` واضبط الحقلَين `seconds` و`nanoseconds` (اختياري). يمكنك الاطّلاع على تنسيق الطابع الزمني لمزيد من التفاصيل.
`params.currency`	`currency`
`params.value`	`conversion_value`
`params.customer_type`	`user_properties.customer_type`	في Measurement Protocol، يتم ضبط المَعلمة `customer_type` كمَعلمة خاصة بالحدث. في Data Manager API، اضبطه في حقل `customer_type` ضمن عنصر `UserProperties` في الحدث.
`params.transaction_id`	`transaction_id`	مطلوبة لبعض الأحداث وحالات الاستخدام يُرجى الاطّلاع على تحويل البيانات إلى عناصر `Event` لمزيد من التفاصيل.
`params.items`	`cart_data.items`	يمكنك الاطّلاع على حقول السلع لبيانات سلة التسوّق لمعرفة التفاصيل.
`params.coupon`	`cart_data.coupon_codes`	استخدِم الحقل `coupon_codes` لتقديم القسائم التي تم تطبيقها على سلة التسوّق. يُرجى تقديم قسيمة واحدة فقط لخدمة "إحصاءات Google". وهذا مستقل عن القسائم على مستوى `Item`، والتي يمكن ضبطها باستخدام `cart_data.items.additional_item_parameters` للسلع الفردية.
`params.session_id`	`additional_event_parameters`	يتم الربط بإدخال تم ضبط `parameter_name` فيه على `session_id`.
`params.engagement_time_msec`	`additional_event_parameters`	يتم الربط بإدخال تم ضبط `parameter_name` فيه على `engagement_time_msec`.
`params` أخرى	`additional_event_parameters`	يمكنك ربط المَعلمات الأخرى كقائمة من العناصر باستخدام `parameter_name` و`value`. ملاحظة: لا تُضِف إدخالات لـ `transaction_id` أو `currency` أو `value` هنا، بل استخدِم الحقول ذات المستوى الأعلى في `Event` بدلاً من ذلك.

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

`Measurement Protocol user_data`	`UserIdentifier` (Data Manager API)	ملاحظات
`sha256_email_address[]`	`email_address`	يجب ضبطه على عنوان البريد الإلكتروني المُنسَّق والمُجزَّأ. يمكنك أيضًا تشفير عنوان البريد الإلكتروني المجزّأ.
`sha256_phone_number[]`	`phone_number`	يجب ضبط هذه السمة على رقم الهاتف المُنسَّق والمُجزَّأ. يمكنك أيضًا تشفير رقم الهاتف المجزّأ.
`address[]`	`address`	يجب ضبطها على عنصر `AddressInfo`. اتّبِع إرشادات التنسيق والتجزئة.
`address[].sha256_first_name`	`address.given_name`	يتم ضبطه على الاسم الأول المنسَّق والمجزّأ. يمكنك أيضًا تشفير الاسم الأول المجزّأ.
`address[].sha256_last_name`	`address.family_name`	يجب ضبط هذه السمة على اسم العائلة المُجزَّأ والمُنسَّق. يمكنك أيضًا تشفير اسم العائلة المجزّأ.
`address[].country`	`address.region_code`
`address[].postal_code`	`address.postal_code`
`address[].city`	`address.city`	يجب ضبطها على المدينة الموحّدة. لا تجزّئ هذا الحقل.
`address[].region`	`address.administrative_area`	يجب ضبطها على المنطقة الإدارية الموحّدة (الولاية أو المقاطعة). لا تجزّئ هذا الحقل.
`address[].sha256_street`	`address.address_line`	يجب ضبطها على عنوان الشارع المنسَّق والمُجزَّأ. يمكنك أيضًا تشفير عنوان الشارع المجزّأ.

حقول السلع لبيانات سلة التسوّق

منصة Measurement Protocol في "`items[]`"	`Item` (Data Manager API)	ملاحظات
`item_id`	`item_id`	هذا العنصر مطلوب.
`item_name`	`additional_item_parameters`	يتم الربط بإدخال تم ضبط `parameter_name` فيه على `item_name`.
`quantity`	`quantity`	هذا العنصر مطلوب.
`price`	`unit_price`	هذا العنصر مطلوب.
حقول المنتجات الأخرى	`additional_item_parameters`	يمكنك ربط مَعلمات السلع الأخرى (مثل `discount` و`affiliation` و`item_brand` وما إلى ذلك) كقائمة من العناصر باستخدام `parameter_name` و`value`. ملاحظة: لا تُضِف إدخالات لـ `quantity` أو `price` أو `item_id` هنا، بل استخدِم الحقول ذات المستوى الأعلى في `Item` بدلاً من ذلك.

حقول الموقع الجغرافي للمستخدم

`Measurement Protocol user_location`	`EventLocation` (Data Manager API)	ملاحظات
`city`	`city`	اسم المدينة التي وقع فيها الحدث
`country_id`	`region_code`	يجب ضبطه على رمز CLDR للمنطقة المكوّن من حرفَين.
`region_id`	`subdivision_code`	يجب ضبطها على رمز التقسيم الفرعي ISO 3166-2.
`continent_id`	`continent_code`	يجب ضبط هذه السمة على رمز القارة بتنسيق UN M49.
`subcontinent_id`	`subcontinent_code`	يجب ضبط هذه السمة على رمز شبه القارة بتنسيق UN M49.

حقول الأجهزة

`Measurement Protocol device`	`DeviceInfo` (Data Manager API)	ملاحظات
`category`	`category`
`language`	`language_code`
`screen_resolution`	`screen_height` و`screen_width`	في Measurement Protocol، يتم تقديم `screen_resolution` كسلسلة (`"1280x720"`). في Data Manager API، أرسِل `screen_height` و`screen_width` كقيمتَين منفصلتَين لعدد صحيح.
`operating_system`	`operating_system`
`operating_system_version`	`operating_system_version`
`model`	`model`
`brand`	`brand`
`browser`	`browser`
`browser_version`	`browser_version`

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

تعيينات الحقول تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.