این راهنما مراحل عیبیابی رایج را برای رفع خطاهای پیادهسازی رایج تشریح میکند.
هیچ رویدادی وجود ندارد
اگر رویدادهای شما در گوگل آنالیتیکس نمایش داده نمیشوند، چند مشکل رایج وجود دارد که باید به دنبال آنها باشید.
ابتدا مشتری خود را انتخاب کنید:
آیا از api_secret درست استفاده میکنید؟
بررسی کنید که از
api_secretبرای جریان درست استفاده میکنید. اگر پروتکل اندازهگیری را برای چندین جریان تنظیم کنید، هر جریان رمز مخصوص به خود را خواهد داشت.آیا api_secret شما هنوز معتبر است؟
برای کمک به مبارزه با هرزنامه، میتوانید
api_secretها را لغو کنید. مطمئن شوید که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 بازیابی شود.
- اندروید - getAppInstanceId()
- کاتلین - getAppInstanceId()
- سویفت - appInstanceID()
- Objective-C - شناسه appInstance
- سی پلاس پلاس - GetAnalyticsInstanceId()
- یونیتی - GetAnalyticsInstanceIdAsync()
app_instance_idباfirebase_app_idمتفاوت است.
شناسههای نامعتبر
از آنجایی که پروتکل اندازهگیری از شناسههای Google Analytics برای Firebase SDK و gtag.js پشتیبانی میکند، مطمئن شوید که از شناسه صحیح استفاده میکنید. شناسههایی که باید استفاده کنید بسته به اینکه از Google Analytics برای Firebase SDK یا gtag.js استفاده میکنید، تغییر میکنند. در ادامه، شناسههایی که باید استفاده کنید، شرح داده شده است:
گوگل آنالیتیکس برای فایربیس SDK
اگر از Google Analytics for Firebase SDK استفاده میکنید، شناسههایی که باید استفاده کنید عبارتند از:
-
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یکسانی خواهند داشت. در رابط کاربری گوگل آنالیتیکس در مسیر زیر یافت میشود:
مدیریت > جریانهای داده > جریان خود را انتخاب کنید > شناسه اندازهگیری -
client_id- این شناسه را در بدنه POST درخواست قرار دهید. این شناسه به طور منحصر به فرد یک نمونه کاربر از یک کلاینت وب را مشخص میکند. این مقدار برای هر کاربر برنامه شما متفاوت خواهد بود. برای نحوه بازیابی این مقدار، به این مثالها مراجعه کنید.
رویدادهای برچسبگذاری سمت سرور وجود ندارند
نصب Tag Manager سمت سرور با یک کلاینت Measurement Protocol به شما امکان میدهد رویدادها را در قالب Measurement Protocol به یک کانتینر ارسال کنید. سپس کانتینر آن رویدادها را با استفاده از همان مکانیزمی که سایر رویدادهای SGTM استفاده میکنند، به Google Analytics ارسال میکند.
اگر میخواهید از تمام ویژگیهای پروتکل اندازهگیری بهرهمند شوید، رویدادها را مستقیماً به جای کانتینر خود به پروتکل اندازهگیری ارسال کنید.