للمساعدة في مكافحة المحتوى غير المرغوب فيه، يمكنك إلغاء api_secret. تأكَّد من أنّapi_secret الذي تستخدمه لا يزال صالحًا. من الممكن أن يكون
مستخدم آخر لديه إذن الوصول إلى البث قد أبطل إذن الوصول إليه عن طريق
خطأ.
api_secret حسّاسة لحالة الأحرف. تحقَّق جيدًا من أنّ الرمز api_secret في واجهة مستخدم
"إحصاءات Google" هو تمامًا مطابقًا للرمز الذي تستخدمه في
الرمز.
لا تستخدِم advertising_id.
advertising_id غير متوافق كمعرِّف جهاز صالح. استخدِم app_instance_id إذا كنت تستخدم Firebase وclient_id إذا كنت تستخدم gtag.js.
أرقام تعريف غير صالحة
بما أنّ Measurement Protocol يتيح استخدام المعرّفات من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google لبرنامج
Firebase" وgtag.js، تأكَّد من استخدام المعرّف الصحيح. تتغيّر الأرقام التعريفية التي يجب
استخدامها استنادًا إلى ما إذا كنت تستخدِم حزمة تطوير البرامج (SDK) لأداة "إحصاءات Google لبرنامج Firebase"
أو gtag.js. في ما يلي مخطّط تفصيلي للمعرّفات التي يجب استخدامها:
حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google لبرنامج Firebase"
إذا كنت تستخدِم حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google لبرنامج Firebase"، يجب استخدام الأرقام التعريفية التالية:
firebase_app_id - أدرِج هذا المعرّف في مَعلمات طلب البحث. يحدِّد هذا المعرّف تطبيقك على Firebase بشكلٍ فريد. وسيحصل جميع مستخدمي
تطبيقك على firebase_app_id نفسه. يمكن العثور عليه في وحدة تحكُّم Firebase
ضمن: إعدادات المشروع > الإعدادات العامة > تطبيقاتك > رقم تعريف التطبيق
app_instance_id - يجب تضمين هذا المعرّف في نص طلب POST. يحدِّد هذا الرمز التعريفي بشكلٍ فريد عملية تثبيت معيّنة لتطبيق Firebase. وستكون هذه القيمة مختلفة لكل عملية تثبيت من عمليات تثبيت تطبيقك. في ما يلي طُرق طلب هذه القيمة لكل منصة Firebase:
firebase_instance_id - يجب عدم تضمين هذا المعرّف في طلبك.
يُستخدَم هذا المعرّف لتحديد مثيل معيّن من التطبيق، ولكنه
خاص بخدمة Firebase. ويُستخدَم هذا الإجراء للمهام، مثل رسائل FCM.
gtag.js
إذا كنت تستخدِم gtag.js، يجب استخدام المعرّفات التالية:
measurement_id - أدرِج هذا المعرّف في مَعلمات طلب البحث. يحدّد هذا المعرّف مصدر بيانات بشكلٍ فريد. سيحصل جميع مستخدمي
موقعك الإلكتروني على measurement_id نفسه. يمكن العثور عليه في
واجهة مستخدِم "إحصاءات Google" ضمن: المشرف > مصادر البيانات > اختيار مصدر بياناتك > رقم تعريف القياس
client_id - يجب تضمين هذا المعرّف في نص طلب POST. يحدِّد هذا المعرّف
بشكل فريد مثيل مستخدم معيّن لأحد عملاء الويب. ستكون هذه القيمة
مختلفة لكل مستخدم من مستخدمي تطبيقك. اطّلِع على هذه الأمثلة
لمعرفة كيفية استرداد هذه القيمة.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis guide helps troubleshoot common Google Analytics 4 Measurement Protocol implementation errors, focusing on missing events and invalid user/device IDs.\u003c/p\u003e\n"],["\u003cp\u003eIf events aren't appearing, ensure your \u003ccode\u003eapi_secret\u003c/code\u003e is correct, valid, accurately copied, and you're using the appropriate device identifier (\u003ccode\u003eapp_instance_id\u003c/code\u003e or \u003ccode\u003eclient_id\u003c/code\u003e, not \u003ccode\u003eadvertising_id\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eWhen using the Measurement Protocol, select the correct IDs based on whether you're implementing via Firebase or gtag.js, as outlined in the guide.\u003c/p\u003e\n"],["\u003cp\u003eFor Firebase, utilize \u003ccode\u003efirebase_app_id\u003c/code\u003e and \u003ccode\u003eapp_instance_id\u003c/code\u003e, avoiding \u003ccode\u003efirebase_instance_id\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eFor gtag.js, use \u003ccode\u003emeasurement_id\u003c/code\u003e and \u003ccode\u003eclient_id\u003c/code\u003e for proper event tracking.\u003c/p\u003e\n"]]],["To resolve event visibility issues in Google Analytics, verify the correct `api_secret` is used, valid, and copied accurately, and avoid using `advertising_id`. For Firebase, use `firebase_app_id` in query parameters and `app_instance_id` in the POST body; retrieve `app_instance_id` using the appropriate platform's method. For gtag.js, utilize `measurement_id` in query parameters and `client_id` in the POST body. Both `client_id` and `app_instance_id` should differ for each user.\n"],null,["# Troubleshooting\n\nThis guide outlines common troubleshooting steps to fix common implementation\nerrors.\n\nNo events\n---------\n\nIf your events aren't showing up in Google Analytics, there are a few common\nissues you should look for.\n\nFirst choose your client: \nFirebase gtag.js\n\n\u003cbr /\u003e\n\n- Are you using the correct [api_secret](/analytics/devguides/collection/protocol/ga4/reference#api_secret)?\n\n Check that you're using the `api_secret` for the right stream. If you set up\n the measurement protocol for multiple streams, each stream will have its own\n secret.\n- Is your [api_secret](/analytics/devguides/collection/protocol/ga4/reference#api_secret) still valid?\n\n In order to help combat spam, you're able to revoke `api_secret`s. Make sure\n that the `api_secret` you are using is still valid. It's possible that\n another user with access to your stream may have revoked access to it by\n mistake.\n- Is your [api_secret](/analytics/devguides/collection/protocol/ga4/reference#api_secret) copied correctly?\n\n `api_secret` is case-sensitive. Double check that the `api_secret` in the\n Google Analytics UI is *exactly* the same as the one you're using in your\n code.\n- Don't use `advertising_id`.\n\n `advertising_id` is not supported as a valid device identifier. Use\n `app_instance_id` if you're using Firebase and `client_id` if you're using\n gtag.js.\n\nInvalid IDs\n-----------\n\nSince the Measurement Procotol supports IDs from the Google Analytics for\nFirebase SDK and gtag.js, make sure you use the right ID. **The IDs you should\nuse changes depending on whether you are using the Google Analytics for Firebase\nSDK or gtag.js.** The following outlines which IDs you should be using:\n\n**Google Analytics for Firebase SDK**\n\nIf you're using the Google Analytics for Firebase SDK the IDs you *should* use\nare:\n\n- [`firebase_app_id`](/analytics/devguides/collection/protocol/ga4/reference?client_type=firebase#firebase_app_id) - Include this ID in the query parameters for the request. This ID uniquely identifies your Firebase App. All users of your app will have the same `firebase_app_id`. Found in the Firebase console under: \n **Project Settings** \\\u003e **General** \\\u003e **Your Apps** \\\u003e **App ID**\n- [`app_instance_id`](/analytics/devguides/collection/protocol/ga4/reference?client_type=firebase#app_instance_id) - Include this ID in the POST body for the request. This\n ID uniquely identifies a given installation of a Firebase App. This value\n will be different for every installation of your app. The methods to request\n this value for each Firebase platform are as follows:\n\n - [Android - getAppInstanceId()](https://firebase.google.com/docs/reference/android/com/google/firebase/analytics/FirebaseAnalytics#public-taskstring-getappinstanceid)\n - [Kotlin - getAppInstanceId()](https://firebase.google.com/docs/reference/kotlin/com/google/firebase/analytics/FirebaseAnalytics#getappinstanceid)\n - [Swift - appInstanceID()](https://firebase.google.com/docs/reference/swift/firebaseanalytics/api/reference/Classes/Analytics#appinstanceid)\n - [Objective-C - appInstanceID](https://firebase.google.com/docs/reference/ios/firebaseanalytics/api/reference/Classes/FIRAnalytics#+appinstanceid)\n - [C++ - GetAnalyticsInstanceId()](https://firebase.google.com/docs/reference/cpp/namespace/firebase/analytics#getanalyticsinstanceid)\n - [Unity - GetAnalyticsInstanceIdAsync()](https://firebase.google.com/docs/reference/unity/class/firebase/analytics/firebase-analytics#getanalyticsinstanceidasync)\n\nYou should *not* use the following:\n\n- `firebase_instance_id` - This ID *should not* be included in your request. This ID is used for identifiying a given instance of the app, but is Firebase specific. It's used for tasks such as FCM messages.\n\n**gtag.js**\n\nIf you're using gtag.js, the IDs you *should* use are:\n\n- [`measurement_id`](/analytics/devguides/collection/protocol/ga4/reference?client_type=gtag#measurement_id) - Include this ID in the query parameters for the request. This ID uniquely identifies a Data Stream. All users of your website will have the same `measurement_id`. Found in the Google Analytics UI under: \n **Admin** \\\u003e **Data Streams** \\\u003e **choose your stream** \\\u003e **Measurement ID**\n- [`client_id`](/analytics/devguides/collection/protocol/ga4/reference?client_type=gtag#client_id) - Include this ID in the POST body for the request. This ID uniquely identifies a given user instance of a web client. This value will be different for every user of your app. See [these examples](/gtagjs/reference/api#get) for how to retrieve this value.\n\nServer-side tagging events missing\n----------------------------------\n\nA [Server-side Tag Manager installation with a Measurement Protocol\nclient](/tag-platform/tag-manager/server-side/send-data#server-to-server_apps) lets you send events in the Measurement Protocol *format* to a\ncontainer. The container then sends those events to Google Analytics using the\nsame mechanism as all other SGTM events.\n| **Note:** It *doesn't* send those events to the Measurement Protocol endpoint, and therefore doesn't support all the features of the Measurement Protocol endpoint, such as deriving [geographic and device information](/analytics/devguides/collection/protocol/ga4#geo_device) from tagging events.\n\nIf you want all the features of the Measurement Protocol, send events directly to the\nMeasurement Protocol instead of your container."]]
