عیب یابی

این راهنما به تشریح مراحل رایج عیب یابی برای رفع خطاهای رایج پیاده سازی می پردازد.

هیچ رویدادی وجود ندارد

اگر رویدادهای شما در Google Analytics نمایش داده نمی‌شوند، چند مشکل رایج وجود دارد که باید به دنبال آن باشید.

ابتدا مشتری خود را انتخاب کنید:

• آیا از api_secret درست استفاده می کنید؟

  بررسی کنید که از api_secret برای جریان مناسب استفاده می‌کنید. اگر پروتکل اندازه گیری را برای چندین جریان تنظیم کنید، هر جریان راز خاص خود را خواهد داشت.

• آیا api_secret شما هنوز معتبر است؟

  به منظور کمک به مبارزه با هرزنامه ها، می توانید api_secret s را باطل کنید. مطمئن شوید که api_secret که استفاده می‌کنید هنوز معتبر است. این امکان وجود دارد که کاربر دیگری با دسترسی به جریان شما به اشتباه دسترسی به آن را لغو کرده باشد.

• آیا api_secret شما به درستی کپی شده است؟

  api_secret به حروف بزرگ و کوچک حساس است. دوباره بررسی کنید که api_secret در رابط کاربری گوگل آنالیتیکس دقیقاً همان چیزی است که در کد خود استفاده می کنید.

• از advertising_id استفاده نکنید.

  advertising_id به عنوان یک شناسه معتبر دستگاه پشتیبانی نمی شود. اگر از Firebase استفاده می کنید از app_instance_id و اگر از gtag.js استفاده می کنید client_id استفاده کنید.

شناسه های نامعتبر

از آنجایی که Measurement Procotol از شناسه های Google Analytics برای Firebase SDK و gtag.js پشتیبانی می کند، مطمئن شوید که از شناسه مناسب استفاده می کنید. شناسه هایی که باید استفاده کنید بسته به اینکه از Google Analytics برای Firebase SDK یا gtag.js استفاده می کنید تغییر می کند. موارد زیر نشان می دهد که از کدام شناسه هایی باید استفاده کنید:

Google Analytics برای Firebase SDK

اگر از Google Analytics برای Firebase SDK استفاده می کنید، شناسه هایی که باید استفاده کنید عبارتند از:

• firebase_app_id - این شناسه را در پارامترهای پرس و جو برای درخواست قرار دهید. این شناسه برنامه Firebase شما را به طور منحصربه‌فرد شناسایی می‌کند. همه کاربران برنامه شما firebase_app_id یکسان خواهند داشت. در کنسول Firebase در زیر یافت شد:
  تنظیمات پروژه > عمومی > برنامه های شما > شناسه برنامه

• app_instance_id - این شناسه را در بدنه POST برای درخواست وارد کنید. این شناسه به طور منحصربه‌فرد یک نصب معین از یک برنامه Firebase را شناسایی می‌کند. این مقدار برای هر نصب برنامه شما متفاوت خواهد بود. روش های درخواست این مقدار برای هر پلتفرم Firebase به شرح زیر است:

  • Android - getAppInstanceId()
  • Kotlin - getAppInstanceId()
  • Swift - appInstanceID()
  • Objective-C - appInstanceID
  • C++ - GetAnalyticsInstanceId()
  • Unity - GetAnalyticsInstanceIdAsync()

شما نباید از موارد زیر استفاده کنید:

• firebase_instance_id - این شناسه نباید در درخواست شما گنجانده شود. این شناسه برای شناسایی یک نمونه معین از برنامه استفاده می شود، اما مخصوص Firebase است. برای کارهایی مانند پیام های FCM استفاده می شود.

gtag.js

اگر از gtag.js استفاده می کنید، شناسه هایی که باید استفاده کنید عبارتند از:

• measurement_id - این شناسه را در پارامترهای پرس و جو برای درخواست قرار دهید. این شناسه به طور منحصر به فرد یک جریان داده را شناسایی می کند. همه کاربران وب‌سایت شما measurement_id یکسان خواهند داشت. در رابط کاربری Google Analytics در زیر یافت می شود:
  Admin > Data Streams > جریان خود را انتخاب کنید > Measurement ID
• client_id - این شناسه را در بدنه POST برای درخواست قرار دهید. این شناسه به طور منحصربفرد یک نمونه کاربر مشخص از یک سرویس گیرنده وب را شناسایی می کند. این مقدار برای هر کاربر برنامه شما متفاوت خواهد بود. برای نحوه بازیابی این مقدار به این مثال ها مراجعه کنید.