اختيار المنصّة:
لا يعرِض Measurement Protocol في "إحصاءات Google 4" رموز أخطاء HTTP
، حتى إذا كان أحد الأحداث مكتوبًا بشكلٍ غير صحيح أو لا يتضمّن المَعلمات المطلوبة. للتأكّد من صلاحية الأحداث، يجب اختبارها مقارنةً بخادم التحقّق من صحة Measurement Protocol قبل نشرها في مرحلة الإنتاج.
بعد التحقّق من تنظيم الأحداث بشكل صحيح، عليك التحقّق من عملية التنفيذ للتأكّد من استخدام المفاتيح الصحيحة.
يمكنك طلب خادم التحقّق مباشرةً، أو استخدام أداة إنشاء الأحداث في "إحصاءات Google 4". تتيح لك "أداة إنشاء الأحداث" في "إحصاءات Google 4" إنشاء أحداث بشكل تفاعلي، واستخدام خادم التحقّق من صحة Measurement Protocol للتحقّق من صحتها.
يصف هذا الدليل كيفية إرسال الأحداث إلى Measurement Protocol لخادم التحقّق في "إحصاءات Google 4" وتفسير الاستجابة.
إرسال الأحداث للتحقّق من صحتها
الاختلاف الوحيد في طلب الأحداث التي يتم إرسالها إلى Measurement Protocol وخادم التحقق من Measurement Protocol هو عنوان URL.
الخادم | عنوان URL |
---|---|
Measurement Protocol | /mp/collect |
خادم التحقُّق من بروتوكول Measurement Protocol | /debug/mp/collect |
جميع حقول الطلب الأخرى متطابقة. راجِع مرجع البروتوكول للاطّلاع على التفاصيل الكاملة حول إنشاء طلب صالح.
يعرض الرمز التالي حدثًا غير صالح يتم إرساله إلى خادم التحقق من صحة Measurement Protocol:
const firebase_app_id = `X:XX:XX:XX`;
const api_secret = `<secret_value>`;
fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
method: "POST",
body: JSON.stringify({
app_instance_id: 'app_instance_id',
events: [{
// Event names must start with an alphabetic character.
name: '_badEventName',
params: {},
}]
})
});
التحقق من صحة الرد
إليك رد خادم التحقّق على الحدث السابق:
{
"validationMessages": [
{
"fieldPath": "events",
"description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
"validationCode": "NAME_INVALID"
}
]
}
الإجابة
المفتاح | النوع | الوصف |
---|---|---|
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 |
تم تقديم الاسم نفسه أكثر من مرة في الطلب. |