نصب تگ اندازهگیری
تگ ادپیکس یک قطعه کد کوتاه است که بالای هر صفحه سایت مینشیند و رویدادها را به دارایی شما میفرستد. یک بار نصبش کنید، بعد فقط داده میخوانید.
تگ چه کاری میکند#
تگ سه کار انجام میدهد و بس. یک فایل کوچک جاوااسکریپت را از CDN میگیرد، یک بار ap('init', …) را با شناسه اندازهگیری دارایی شما صدا میزند، و از آن لحظه به بعد هر بازدید صفحه و هر رویدادی که خودتان تعریف کردهاید را در دستههای کوچک به گیرنده ادپیکس میفرستد.
init به تنهایی اولین page_view را میفرستد و قلاب History را برای سایتهای تک صفحهای هم نصب میکند. این یعنی برای شمردن بازدید صفحه لازم نیست هیچ دستور دیگری بنویسید — و نباید بنویسید.
اگر کنار init یک ap('page') دستی هم بگذارید، هر بارگذاری صفحه دو بار شمرده میشود. همین یک خط اضافه، ریشه شمارش چندبرابری بود که در ADR-0072 برطرف شد. قطعه کدی که کنسول امروز میسازد این خط را ندارد؛ اگر نسخه قدیمی تری روی سایت شماست، آن را با نسخه تازه جایگزین کنید.
قطعه کد را از کجا بردارید#
قطعه کد به ازای هر جریان داده ساخته میشود، چون شناسه اندازهگیری متعلق به جریان است نه به حساب. هیچ وقت آن را از یک مستند، یک تیکت یا سایت دیگری کپی نکنید.
کشویی که باز میشود «دستورالعمل نصب» نام دارد. بلوک اصلی زیر عنوان «نصب دستی» و با نشان «توصیه شده» میآید، درست زیرش «شناسه اندازهگیری» همان جریان نوشته شده، و بالای کشو دکمه «آزمایش نصب» است. اگر برای این جریان بسته دروازه تگ ساخته باشید، یک زبانه دوم هم برای قطعه کد فرستپارتی اضافه میشود؛ زبانه «تگ مستقیم» همچنان مسیر اصلی نصب است.
صفحه «نصب تگ» در «مدیریت» همین قطعه کد را نشان میدهد، اما آن را از اولین جریان داده دارایی میسازد. اگر دارایی چند جریان دارد، مرجع همان کشوی خود جریان است. اگر چند دارایی یا چند دامنه دارید، برای هر کدام جداگانه این کار را تکرار کنید.
کجای صفحه بگذارید#
بلوک را تا جایی که میتوانید بالای <head> بگذارید — پیش از هر اسکریپت سنگین دیگری. هرچه دیرتر اجرا شود، بازدیدکنندگانی که سریع صفحه را میبندند از دست میروند.
اگر سایت شما چند قالب دارد (صفحه اصلی، پنل کاربری، صفحه پرداخت)، تگ باید در همه آنها باشد. یک قالب جامانده یعنی یک بخش کاملا نامرئی در گزارشها.
اگر تگ هم در قالب سایت و هم در گوگل تگ منیجر (یا هم مستقیم و هم از دروازه تگ) نصب باشد، همان صفحه دو نسخه از اسکریپت را بالا میآورد. گیرنده و تراکر امروز بیشتر این حالت را خنثی میکنند، ولی درستش این است که فقط یک مسیر نصب داشته باشید.
اجزای قطعه کد#
بلوکی که کپی میکنید سه تکه دارد. لازم نیست دستکاری شان کنید، ولی خوب است بدانید هرکدام چیست.
| بخش | مقدار نمونه | چه میکند |
|---|---|---|
id |
AP-XXXXXXXXXX |
شناسه اندازهگیری جریان. هویت سایت شما همین است؛ هم روی آدرس اسکریپت میآید و هم به init داده میشود. |
v |
4 |
نسخه تگ. کلید کش است؛ با تغییر مهم در تراکر بالا میرود و مرورگرها نسخه تازه را میگیرند. |
endpoint |
https://collect.adpix.net |
مقصد ارسال رویدادها. اگر دروازه تگ فرستپارتی را روشن کرده باشید، این مقدار دامنه خودتان میشود. |
بعد از نصب، چه چیزی اختیاری است#
بازدید صفحه از همان لحظه شمرده میشود. دو دستور دیگر هست که هر وقت خواستید اضافه کنید — هیچ کدام برای شروع لازم نیستند.
ap('track', 'signup_completed', { plan: 'pro' });
ap('identify', 'user_8421', { email: 'ali@example.com' });
track یک رویداد دلخواه با هر خصیصه ای که بدهید میسازد. identify بازدیدکننده ناشناس را به یک کاربر واقعی وصل میکند و رویدادهای پیش از ورودش را هم به همان کاربر میچسباند. جزئیاتش در چطور ادپیکس بازدیدکننده ها را شناسایی میکند آمده است.
نصب را تایید کنید#
بعد از انتشار، صفحه را با کش خالی باز کنید — Ctrl + Shift + R روی ویندوز و لینوکس، Cmd + Shift + R روی مک — و سپس در کنسول سراغ «وضعیت زنده» بروید. بازدید خودتان باید ظرف چند ثانیه دیده شود.
جواب قطعی تر، دکمه «آزمایش نصب» در همان کشوی دستورالعمل نصب است: ادپیکس میگوید در ۳۰ دقیقه گذشته رویدادی از دامنه این جریان رسیده یا نه، و اگر رسیده باشد وضعیت جریان «تاییدشده» ذخیره میشود.
اگر چیزی ندیدید، پیش از هر کار دیگری این سه مورد را بررسی کنید:
- آیا قطعه کد واقعا در سورس صفحه منتشرشده هست، یا فقط در محیط توسعه؟
- آیا شناسه اندازهگیری همان چیزی است که «مشاهده دستورالعمل نصب تگ» نشان میدهد؟
- آیا بنر رضایت، دسته «آماری» را رد کرده است؟ در حالت انتخاب صریح، تا وقتی کاربر رضایت ندهد رویدادی ثبت نمیشود.
ترتیب کامل بررسی در تایید رسیدن داده آمده و مسیر کامل عیب یابی در هیچ داده ای نمیرسد.
پرسشهای پرتکرار#
قطعه کد را کجا پیدا کنم؟
در کنسول، «مدیریت» ← «جریانهای داده» ← جریان خود را باز کنید ← «مشاهده دستورالعمل نصب تگ». همان کشو، قطعه کد را با شناسه اندازهگیری همان جریان میسازد. هیچ جای دیگری آن را کپی نکنید.
تگ را مستقیم در کد سایت بگذارم یا از گوگل تگ منیجر؟
هر دو کار میکند. مستقیم در قالب سایت دقیق ترین است، چون قطعه کد واقعا بالای صفحه اجرا میشود. اگر از تگ منیجر استفاده میکنید، تگ را روی تریگر «All Pages» بگذارید و مطمئن شوید نسخه دیگری از تگ به صورت دستی هم در قالب نمانده باشد.
نصب تگ روی سرعت سایت اثر میگذارد؟
بارگذاری با async انجام میشود، پس رندر صفحه را بلوکه نمیکند. فایل tracker روی CDN است و بین همه سایتها مشترک و قابل کش است؛ شناسه دارایی در زمان اجرا به آن داده میشود، پس فایل جداگانه ای برای هر سایت ساخته نمیشود.
اگر شناسه اندازهگیری را اشتباه بگذارم چه میشود؟
رویدادها ارسال میشوند ولی به دارایی شما نمیرسند. در «وضعیت زنده» چیزی نمیبینید. شناسه را با همان چیزی که زیر قطعه کد، جلوی «شناسه اندازهگیری» نوشته شده مقایسه کنید؛ این شناسه با AP- شروع میشود.
ممنون — بازخورد شما به بهتر شدن مستندات کمک میکند.