عیب یابی

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

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

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

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

Firebase gtag.js

• آیا از 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 استفاده کنید.

• آیا از firebase_app_id صحیح استفاده می کنید؟

  مطمئن شوید که از شناسه برنامه Firebase استفاده می کنید. این مقدار در کنسول Firebase در زیر یافت می شود: تنظیمات پروژه > عمومی > برنامه های شما > شناسه برنامه .

  firebase_app_id با app_instance_id متفاوت است.

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

  مطمئن شوید که از شناسه‌ای استفاده می‌کنید که مخصوص نصب یک برنامه Firebase است. این مقدار باید از طریق Google Analytics برای Firebase SDK بازیابی شود.

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

  app_instance_id با firebase_app_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 برای درخواست قرار دهید. این شناسه به طور منحصربفرد یک نمونه کاربر مشخص از یک سرویس گیرنده وب را شناسایی می کند. این مقدار برای هر کاربر برنامه شما متفاوت خواهد بود. برای نحوه بازیابی این مقدار به این مثال ها مراجعه کنید.

رویدادهای برچسب‌گذاری سمت سرور وجود ندارد

نصب مدیریت برچسب سمت سرور با مشتری پروتکل اندازه گیری به شما امکان می دهد رویدادها را در قالب پروتکل اندازه گیری به یک ظرف ارسال کنید. سپس کانتینر آن رویدادها را با استفاده از مکانیزم مشابه سایر رویدادهای SGTM به Google Analytics ارسال می کند.

توجه: آن رویدادها را به نقطه پایانی پروتکل اندازه‌گیری ارسال نمی‌کند ، و بنابراین از همه ویژگی‌های نقطه پایانی پروتکل اندازه‌گیری، مانند استخراج اطلاعات جغرافیایی و دستگاه از برچسب‌گذاری رویدادها، پشتیبانی نمی‌کند.

اگر تمام ویژگی‌های پروتکل اندازه‌گیری را می‌خواهید، رویدادها را مستقیماً به جای ظرف خود به پروتکل اندازه‌گیری ارسال کنید.