اختر نظامك الأساسي:
لا تعرِض Measurement Protocol في "إحصاءات Google"
رموز الخطأ HTTP
، حتى إذا كان الحدث مكتوبًا بشكلٍ غير صحيح أو غير متوفّر
المعلَمات. وللتأكّد من صلاحية الأحداث، عليك اختبارها في ضوء
خادم التحقق من Measurement Protocol قبل نشرها في قناة الإصدار العلني.
بعد أن تتحقّق من تنظيم الأحداث بشكل صحيح، ينبغي أن
التحقق من عملية التنفيذ للتأكّد من استخدام المفاتيح الصحيحة.
ويمكنك استدعاء خادم التحقق من الصحة مباشرةً أو استخدام إحصاءات Google أداة إنشاء الأحداث: تتيح لك أداة إنشاء الأحداث في "إحصاءات Google" التفاعل مع وإنشاء الأحداث، واستخدام خادم التحقق من صحة Measurement Protocol والتحقق من صحتها.
يوضِّح هذا الدليل كيفية إرسال الأحداث إلى Measurement Protocol في Google. خادم التحقق من "إحصاءات 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 |
المصفوفة<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 |
تم تقديم الاسم نفسه أكثر من مرة في الطلب. |