اختَر النظام الأساسي:
لا يعرض Measurement Protocol في "إحصاءات Google" رموزاً لخطأ
HTTP
، حتى إذا كان الحدث منسقًا بشكل غير صحيح أو يفتقر إلى
مَعلمات مطلوبة. لضمان أنّ الأحداث صالحة، يجب اختبارها باستخدام
خادم التحقّق من الصحة في Measurement Protocol قبل نشرها.
بعد التأكّد من أنّ الأحداث منظَّمة بشكلٍ صحيح، عليك
التحقّق من عملية التنفيذ للتأكّد من استخدام المفاتيح الصحيحة.
يمكنك الاتصال بخادم التحقّق مباشرةً أو استخدام أداة إنشاء الأحداث في "إحصاءات Google". يتيح لك "أداة إنشاء الأحداث" في "إحصاءات Google" إنشاء الأحداث بشكل تفاعلي، ويستخدم خادم التحقّق من Measurement Protocol للقيام بإثبات صحتها.
يوضّح هذا الدليل كيفية إرسال الأحداث إلى خادم التحقّق من Measurement Protocol في "إحصاءات Google 4" وتفسير الردّ.
إرسال الأحداث للتحقّق منها
الفرق الوحيد في طلب الأحداث المُرسَل إلى Measurement Protocol وخادم التحقّق من صحة Measurement Protocol هو عنوان URL.
الخادم | عنوان URL |
---|---|
Measurement Protocol | /mp/collect |
خادم التحقّق من الصحة في Measurement Protocol | /debug/mp/collect |
وتبقى جميع حقول الطلبات الأخرى كما هي. اطّلِع على مرجع بروتوكول للحصول على مزيد من المعلومات حول إنشاء طلب صالح.
يعرض الرمز التالي حدثًا غير صالح يتم إرساله إلى خادم التحقّق في Measurement Protocol:
ردّ التحقّق
في ما يلي استجابة خادم التحقّق من الصحة للحدث السابق:
{
"validationMessages": [
{
"fieldPath": "events",
"description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
"validationCode": "NAME_INVALID"
}
]
}
في ما يلي استجابة خادم التحقّق من طلب لا يتضمّن أي مشاكل في التحقّق:
{
"validationMessages": []
}
الردّ
المفتاح | النوع | الوصف |
---|---|---|
validationMessages |
Array<ValidationMessage> | مصفوفة من رسائل التحقّق |
ValidationMessage
المفتاح | النوع | الوصف |
---|---|---|
fieldPath |
سلسلة | مسار الحقل الذي كان غير صالح. |
description |
سلسلة | وصف للخطأ |
validationCode |
ValidationCode | رمز التحقّق الذي يتوافق مع الخطأ |
ValidationCode
القيمة | الوصف |
---|---|
VALUE_INVALID |
القيمة المقدَّمة fieldPath غير صالحة. يُرجى الاطّلاع على القيود.
|
VALUE_REQUIRED |
لم يتم تقديم قيمة مطلوبة لسمة fieldPath . |
NAME_INVALID |
الاسم الذي تم تقديمه غير صالح. يُرجى الاطّلاع على القيود. |
NAME_RESERVED |
كان الاسم المقدَّم أحد الأسماء المحجوزة. راجِع الأسماء المحجوزة. |
VALUE_OUT_OF_BOUNDS |
القيمة المقدَّمة كبيرة جدًا. يُرجى الاطّلاع على القيود. |
EXCEEDED_MAX_ENTITIES |
كان هناك عدد كبير جدًا من المَعلمات في الطلب. يُرجى الاطّلاع على القيود. |
NAME_DUPLICATED |
تم تقديم الاسم نفسه أكثر من مرة في الطلب. |