این سند نحوه ارسال داده ها به Google Analytics را با استفاده از پروتکل اندازه گیری توضیح می دهد.
بررسی اجمالی
2 بخش برای ارسال داده ها به Google Analytics با استفاده از پروتکل اندازه گیری وجود دارد:
- حمل و نقل - به کجا و چگونه داده ها را ارسال می کنید
- محموله - داده هایی که ارسال می کنید
این سند نحوه قالب بندی هر دو را شرح می دهد.
حمل و نقل
نقطه پایان URL
شما داده ها را با استفاده از پروتکل اندازه گیری با درخواست HTTP به نقطه پایانی زیر ارسال می کنید:
https://www.google-analytics.com/collect
همه داده ها باید به طور ایمن با پروتکل HTTPS ارسال شوند.
می توانید داده ها را با استفاده از درخواست های POST یا GET ارسال کنید.
با استفاده از POST
توصیه میکنیم دادهها را از طریق POST ارسال کنید، زیرا این امکان را برای بار بزرگتری فراهم میکند. هنگام استفاده از POST، درخواست HTTP زیر را صادر کنید:
User-Agent: user_agent_string POST https://www.google-analytics.com/collect payload_data
جایی که:
- user_agent_string – یک رشته عامل کاربر قالببندی شده است که برای محاسبه ابعاد زیر استفاده میشود: مرورگر، پلتفرم و قابلیتهای موبایل.
اگر این مقدار تنظیم نشود، داده های بالا محاسبه نمی شوند.
- payload_data –
BODY
درخواست پست. بدنه باید دقیقاً شامل 1 بار رمزگذاری شده URI باشد و نباید بیشتر از 8192 بایت باشد. - آدرس IP - به طور ضمنی در درخواست HTTP ارسال می شود و برای محاسبه تمام ابعاد جغرافیایی / شبکه در Google Analytics استفاده می شود.
گرفتن
برای محیطهایی که نمیتوانید دادههای POST ارسال کنید، میتوانید درخواستهای HTTP GET را به همان نقطه پایانی ارسال کنید:
GET /collect?payload_data HTTP/1.1 Host: https://www.google-analytics.com User-Agent: user_agent_string
جایی که داده های محموله به عنوان پارامترهای پرس و جو فرار از URI ارسال می شود. طول کل URL رمزگذاری شده نباید بیشتر از 8000 بایت باشد.
شکستن حافظه پنهان
در برخی محیطها، مانند مرورگرها، درخواستهای HTTP GET ممکن است ذخیره شوند. هنگامی که یک درخواست در حافظه پنهان ذخیره می شود، درخواست های بعدی ممکن است از حافظه پنهان بازیابی شوند و به Google Analytics ارسال نشوند. برای عبور از حافظه نهان، پروتکل اندازه گیری یک پارامتر خاص ( z
) ارائه می کند که می تواند با یک عدد تصادفی تنظیم شود. این تضمین میکند که تمام درخواستهای پروتکل اندازهگیری منحصربهفرد هستند و درخواستهای بعدی از حافظه پنهان بازیابی نمیشوند.
هنگامی که از حافظه پنهان استفاده می کنید، ما به شدت توصیه می کنیم این پارامتر را به عنوان آخرین پارامتر در بارگذاری اضافه کنید.
https://www.google-analytics.com/collect?payload_data&z=123456
کدهای پاسخ
اگر درخواست HTTP دریافت شود، پروتکل اندازه گیری یک کد وضعیت 2xx
را برمی گرداند. اگر دادههای محموله نادرست باشد، یا اگر دادههای موجود در بار نادرست باشد یا توسط Google Analytics پردازش نشده باشد، پروتکل اندازهگیری کد خطایی را باز نمیگرداند.
اگر کد وضعیت 2xx
دریافت نکردید، نباید درخواست را دوباره امتحان کنید. درعوض، باید هرگونه خطا در درخواست HTTP خود را متوقف و تصحیح کنید.
داده های بار
تمام داده های جمع آوری شده توسط Google Analytics با استفاده از پروتکل اندازه گیری به عنوان یک بار ارسال می شود. payload شبیه یک رشته جستجوی URL است که در آن هر پارامتر دارای یک کلید و مقدار است، با یک کاراکتر =
از هم جدا می شود و هر جفت با یک کاراکتر &
محدود می شود. مثلا:
key1=val1&key2=val2
هر بار دارای قوانینی است که بر آنها حاکم است: مقادیر مورد نیاز، رمزگذاری URI، پارامترهایی که می توانند با هم ارسال شوند و طول پارامتر. همچنین هر پارامتر دارای نوع خاصی است که به فرمت خاصی نیاز دارد. بخش های زیر این قوانین را بررسی می کند.
برای فهرست کامل تمام پارامترهایی که می توانید با استفاده از پروتکل اندازه گیری ارسال کنید، مرجع پارامتر را بخوانید.
مقادیر مورد نیاز برای همه بازدیدها
پارامترهای زیر باید در هر محموله باشد:
نام | پارامتر | مثال | شرح |
---|---|---|---|
نسخه پروتکل | v | v= 1 | نسخه پروتکل مقدار باید 1 باشد. |
شناسه پیگیری | tid | tid= UA-123456-1 | شناسه ای که تشخیص می دهد به کدام ویژگی Google Analytics داده ارسال شود. |
شناسه مشتری | cid | cid= xxxxx | یک شناسه منحصر به فرد برای یک کاربر خاص. |
نوع را بزنید | t | t= pageview | نوع تعامل جمع آوری شده برای یک کاربر خاص. |
Client ID
و دادههای Hit Type
مقادیری هستند که مستقیماً به مدل داده Google Analytics نگاشت میشوند. اگر میخواهید کاربر 5555
را که به /pageA
، /pageB
و /pageC
رفته است ردیابی کنید، 3 بار زیر را ارسال میکنید:
v=1&tid=UA-123456-1&cid=5555&t=pageview&dp=%2FpageA v=1&tid=UA-123456-1&cid=5555&t=pageview&dp=%2FpageB v=1&tid=UA-123456-1&cid=5555&t=pageview&dp=%2FpageC
توجه داشته باشید که /
به %2F
کدگذاری شده است.
مقادیر رمزگذاری URL
همه مقادیر ارسال شده به Google Analytics باید UTF-8 و URL Encoded باشند. برای ارسال کلید dp
با مقدار /my page €
، ابتدا باید مطمئن شوید که این کد UTF-8 است، سپس url رمزگذاری شده است و در نتیجه رشته نهایی ایجاد می شود:
dp=%2Fmy%20page%20%E2%82%AC
اگر هر یک از کاراکترها به اشتباه کدگذاری شده باشد، با نویسه جایگزین یونیکد xFFFD
جایگزین می شود.
مقادیر مورد نیاز برای انواع ضربه های خاص
برخی از پارامترها ممکن است فقط با انواع ضربه خاص ارسال شوند. برای مثال، نوع ضربه pageview
مستلزم آن است که پارامتر Page Path ( dp
) نیز تنظیم شود. مرجع پارامتر توصیف می کند که کدام پارامتر برای کدام نوع ضربه مورد نیاز است.
حداکثر طول
برخی از مقادیر متنی در پروتکل اندازه گیری حداکثر طول مشخصی بر حسب بایت دارند. به عنوان مثال، فیلد ارجاع دهنده سند dr
دارای حداکثر طول 2048 بایت است. اگر هر یک از مقادیر بیشتر از حداکثر طول باشد، به طور خودکار کوتاه می شوند. اگر یک کاراکتر چند بایتی از حداکثر طول بیشتر شود، کل کاراکتر کوتاه می شود.
انواع داده های پشتیبانی شده
هر فیلد داده در پروتکل اندازه گیری به نوع خاصی تعلق دارد که هر کدام قوانین اعتبار سنجی خاص خود را دارد. اگر هر یک از مقادیر پارامتر با قوانین اعتبارسنجی مطابقت نداشته باشد، آن پارامتر خاص نادیده گرفته می شود و توسط Google Analytics پردازش نمی شود. تمام پارامترهای دیگر به طور معمول پردازش می شوند.
پروتکل اندازه گیری از انواع داده های زیر پشتیبانی می کند:
توجه داشته باشید که فیلدهای داده فردی ممکن است محدودیت های خاص خود را داشته باشند. برای فهرست کامل تمام فیلدهای داده و انواع پذیرفته شده به مرجع فیلد مراجعه کنید.
متن
برای نمایش رشته ها استفاده می شود. پردازش اضافی در فیلدهای متنی انجام می شود. همه کاراکترهای فضای خالی اصلی و انتهایی حذف می شوند. اجرای داخلی دو یا چند کاراکتر فضای خالی (شامل فاصله، تب، خطوط جدید و غیره) به یک کاراکتر فاصله کاهش مییابد. این تبدیل قبل از هر گونه کوتاهی روی متن خام اعمال می شود. مثلا:
Hello World
خواهد شد:
Hello World
واحد پول
برای نشان دادن ارزش کل یک ارز استفاده می شود. نقطه اعشار به عنوان جداکننده بین کل و بخش کسری ارز استفاده می شود. دقت تا 6 رقم اعشار است. موارد زیر برای یک فیلد ارز معتبر است:
1000.000001
پس از ارسال مقدار به Google Analytics، تمام متن تا اولین رقم، کاراکتر -
یا .
کاراکتر (اعشاری). بنابراین:
$-55.00
خواهد شد:
-55.00
بولی
برای تعیین درست یا نادرست بودن یک مقدار استفاده می شود. مقادیر معتبر عبارتند از:
-
1
- درست است -
0
- نادرست
عدد صحیح
برای نمایش یک عدد صحیح استفاده می شود. مقدار به عنوان یک int64 امضا شده ذخیره می شود
عدد
برای نمایش یک عدد صحیح یا یک عدد ممیز شناور استفاده می شود.
،این سند نحوه ارسال داده ها به Google Analytics را با استفاده از پروتکل اندازه گیری توضیح می دهد.
بررسی اجمالی
2 بخش برای ارسال داده ها به Google Analytics با استفاده از پروتکل اندازه گیری وجود دارد:
- حمل و نقل - به کجا و چگونه داده ها را ارسال می کنید
- محموله - داده هایی که ارسال می کنید
این سند نحوه قالب بندی هر دو را شرح می دهد.
حمل و نقل
نقطه پایان URL
شما داده ها را با استفاده از پروتکل اندازه گیری با درخواست HTTP به نقطه پایانی زیر ارسال می کنید:
https://www.google-analytics.com/collect
همه داده ها باید به طور ایمن با پروتکل HTTPS ارسال شوند.
می توانید داده ها را با استفاده از درخواست های POST یا GET ارسال کنید.
با استفاده از POST
توصیه میکنیم دادهها را از طریق POST ارسال کنید، زیرا این امکان را برای بار بزرگتری فراهم میکند. هنگام استفاده از POST، درخواست HTTP زیر را صادر کنید:
User-Agent: user_agent_string POST https://www.google-analytics.com/collect payload_data
جایی که:
- user_agent_string – یک رشته عامل کاربر قالببندی شده است که برای محاسبه ابعاد زیر استفاده میشود: مرورگر، پلتفرم و قابلیتهای موبایل.
اگر این مقدار تنظیم نشود، داده های بالا محاسبه نمی شوند.
- payload_data –
BODY
درخواست پست. بدنه باید دقیقاً شامل 1 بار رمزگذاری شده URI باشد و نباید بیشتر از 8192 بایت باشد. - آدرس IP - به طور ضمنی در درخواست HTTP ارسال می شود و برای محاسبه تمام ابعاد جغرافیایی / شبکه در Google Analytics استفاده می شود.
گرفتن
برای محیطهایی که نمیتوانید دادههای POST ارسال کنید، میتوانید درخواستهای HTTP GET را به همان نقطه پایانی ارسال کنید:
GET /collect?payload_data HTTP/1.1 Host: https://www.google-analytics.com User-Agent: user_agent_string
جایی که داده های محموله به عنوان پارامترهای پرس و جو فرار از URI ارسال می شود. طول کل URL رمزگذاری شده نباید بیشتر از 8000 بایت باشد.
شکستن حافظه پنهان
در برخی محیطها، مانند مرورگرها، درخواستهای HTTP GET ممکن است ذخیره شوند. هنگامی که یک درخواست در حافظه پنهان ذخیره می شود، درخواست های بعدی ممکن است از حافظه پنهان بازیابی شوند و به Google Analytics ارسال نشوند. برای عبور از حافظه نهان، پروتکل اندازه گیری یک پارامتر خاص ( z
) ارائه می کند که می تواند با یک عدد تصادفی تنظیم شود. این تضمین میکند که تمام درخواستهای پروتکل اندازهگیری منحصربهفرد هستند و درخواستهای بعدی از حافظه پنهان بازیابی نمیشوند.
هنگامی که از حافظه پنهان استفاده می کنید، ما به شدت توصیه می کنیم این پارامتر را به عنوان آخرین پارامتر در بارگذاری اضافه کنید.
https://www.google-analytics.com/collect?payload_data&z=123456
کدهای پاسخ
اگر درخواست HTTP دریافت شود، پروتکل اندازه گیری یک کد وضعیت 2xx
را برمی گرداند. اگر دادههای محموله نادرست باشد، یا اگر دادههای موجود در بار نادرست باشد یا توسط Google Analytics پردازش نشده باشد، پروتکل اندازهگیری کد خطایی را باز نمیگرداند.
اگر کد وضعیت 2xx
دریافت نکردید، نباید درخواست را دوباره امتحان کنید. درعوض، باید هرگونه خطا در درخواست HTTP خود را متوقف و تصحیح کنید.
داده های بار
تمام داده های جمع آوری شده توسط Google Analytics با استفاده از پروتکل اندازه گیری به عنوان یک بار ارسال می شود. payload شبیه یک رشته جستجوی URL است که در آن هر پارامتر دارای یک کلید و مقدار است، با یک کاراکتر =
از هم جدا می شود و هر جفت با یک کاراکتر &
محدود می شود. مثلا:
key1=val1&key2=val2
هر بار دارای قوانینی است که بر آنها حاکم است: مقادیر مورد نیاز، رمزگذاری URI، پارامترهایی که می توانند با هم ارسال شوند و طول پارامتر. همچنین هر پارامتر دارای نوع خاصی است که به فرمت خاصی نیاز دارد. بخش های زیر این قوانین را بررسی می کند.
برای فهرست کامل تمام پارامترهایی که می توانید با استفاده از پروتکل اندازه گیری ارسال کنید، مرجع پارامتر را بخوانید.
مقادیر مورد نیاز برای همه بازدیدها
پارامترهای زیر باید در هر محموله باشد:
نام | پارامتر | مثال | شرح |
---|---|---|---|
نسخه پروتکل | v | v= 1 | نسخه پروتکل مقدار باید 1 باشد. |
شناسه پیگیری | tid | tid= UA-123456-1 | شناسه ای که تشخیص می دهد به کدام ویژگی Google Analytics داده ارسال شود. |
شناسه مشتری | cid | cid= xxxxx | یک شناسه منحصر به فرد برای یک کاربر خاص. |
نوع را بزنید | t | t= pageview | نوع تعامل جمع آوری شده برای یک کاربر خاص. |
Client ID
و دادههای Hit Type
مقادیری هستند که مستقیماً به مدل داده Google Analytics نگاشت میشوند. اگر میخواهید کاربر 5555
را که به /pageA
، /pageB
و /pageC
رفته است ردیابی کنید، 3 بار زیر را ارسال میکنید:
v=1&tid=UA-123456-1&cid=5555&t=pageview&dp=%2FpageA v=1&tid=UA-123456-1&cid=5555&t=pageview&dp=%2FpageB v=1&tid=UA-123456-1&cid=5555&t=pageview&dp=%2FpageC
توجه داشته باشید که /
به %2F
کدگذاری شده است.
مقادیر رمزگذاری URL
همه مقادیر ارسال شده به Google Analytics باید UTF-8 و URL Encoded باشند. برای ارسال کلید dp
با مقدار /my page €
، ابتدا باید مطمئن شوید که این کد UTF-8 است، سپس url رمزگذاری شده است و در نتیجه رشته نهایی ایجاد می شود:
dp=%2Fmy%20page%20%E2%82%AC
اگر هر یک از کاراکترها به اشتباه کدگذاری شده باشد، با نویسه جایگزین یونیکد xFFFD
جایگزین می شود.
مقادیر مورد نیاز برای انواع ضربه های خاص
برخی از پارامترها ممکن است فقط با انواع ضربه خاص ارسال شوند. برای مثال، نوع ضربه pageview
مستلزم آن است که پارامتر Page Path ( dp
) نیز تنظیم شود. مرجع پارامتر توصیف می کند که کدام پارامتر برای کدام نوع ضربه مورد نیاز است.
حداکثر طول
برخی از مقادیر متنی در پروتکل اندازه گیری حداکثر طول مشخصی بر حسب بایت دارند. به عنوان مثال، فیلد ارجاع دهنده سند dr
دارای حداکثر طول 2048 بایت است. اگر هر یک از مقادیر بیشتر از حداکثر طول باشد، به طور خودکار کوتاه می شوند. اگر یک کاراکتر چند بایتی از حداکثر طول بیشتر شود، کل کاراکتر کوتاه می شود.
انواع داده های پشتیبانی شده
هر فیلد داده در پروتکل اندازه گیری به نوع خاصی تعلق دارد که هر کدام قوانین اعتبار سنجی خاص خود را دارد. اگر هر یک از مقادیر پارامتر با قوانین اعتبارسنجی مطابقت نداشته باشد، آن پارامتر خاص نادیده گرفته می شود و توسط Google Analytics پردازش نمی شود. تمام پارامترهای دیگر به طور معمول پردازش می شوند.
پروتکل اندازه گیری از انواع داده های زیر پشتیبانی می کند:
توجه داشته باشید که فیلدهای داده فردی ممکن است محدودیت های خاص خود را داشته باشند. برای فهرست کامل تمام فیلدهای داده و انواع پذیرفته شده به مرجع فیلد مراجعه کنید.
متن
برای نمایش رشته ها استفاده می شود. پردازش اضافی در فیلدهای متنی انجام می شود. همه کاراکترهای فضای خالی اصلی و انتهایی حذف می شوند. اجرای داخلی دو یا چند کاراکتر فضای خالی (شامل فاصله، تب، خطوط جدید و غیره) به یک کاراکتر فاصله کاهش مییابد. این تبدیل قبل از هر گونه کوتاهی روی متن خام اعمال می شود. مثلا:
Hello World
خواهد شد:
Hello World
واحد پول
برای نشان دادن ارزش کل یک ارز استفاده می شود. نقطه اعشار به عنوان جداکننده بین کل و بخش کسری ارز استفاده می شود. دقت تا 6 رقم اعشار است. موارد زیر برای یک فیلد ارز معتبر است:
1000.000001
پس از ارسال مقدار به Google Analytics، تمام متن تا اولین رقم، کاراکتر -
یا .
کاراکتر (اعشاری). بنابراین:
$-55.00
خواهد شد:
-55.00
بولی
برای تعیین درست یا نادرست بودن یک مقدار استفاده می شود. مقادیر معتبر عبارتند از:
-
1
- درست است -
0
- نادرست
عدد صحیح
برای نشان دادن یک عدد صحیح استفاده می شود. مقدار به عنوان یک int64 امضا شده ذخیره می شود
عدد
برای نمایش یک عدد صحیح یا یک عدد ممیز شناور استفاده می شود.
،این سند نحوه ارسال داده ها به Google Analytics را با استفاده از پروتکل اندازه گیری توضیح می دهد.
بررسی اجمالی
2 بخش برای ارسال داده ها به Google Analytics با استفاده از پروتکل اندازه گیری وجود دارد:
- حمل و نقل - به کجا و چگونه داده ها را ارسال می کنید
- محموله - داده هایی که ارسال می کنید
این سند نحوه قالب بندی هر دو را شرح می دهد.
حمل و نقل
نقطه پایان URL
شما داده ها را با استفاده از پروتکل اندازه گیری با درخواست HTTP به نقطه پایانی زیر ارسال می کنید:
https://www.google-analytics.com/collect
همه داده ها باید به طور ایمن با پروتکل HTTPS ارسال شوند.
می توانید داده ها را با استفاده از درخواست های POST یا GET ارسال کنید.
با استفاده از POST
توصیه میکنیم دادهها را از طریق POST ارسال کنید، زیرا این امکان را برای بار بزرگتری فراهم میکند. هنگام استفاده از POST، درخواست HTTP زیر را صادر کنید:
User-Agent: user_agent_string POST https://www.google-analytics.com/collect payload_data
جایی که:
- user_agent_string – یک رشته عامل کاربر قالببندی شده است که برای محاسبه ابعاد زیر استفاده میشود: مرورگر، پلتفرم و قابلیتهای موبایل.
اگر این مقدار تنظیم نشود، داده های بالا محاسبه نمی شوند.
- payload_data –
BODY
درخواست پست. بدنه باید دقیقاً شامل 1 بار رمزگذاری شده URI باشد و نباید بیشتر از 8192 بایت باشد. - آدرس IP - به طور ضمنی در درخواست HTTP ارسال می شود و برای محاسبه تمام ابعاد جغرافیایی / شبکه در Google Analytics استفاده می شود.
گرفتن
برای محیطهایی که نمیتوانید دادههای POST ارسال کنید، میتوانید درخواستهای HTTP GET را به همان نقطه پایانی ارسال کنید:
GET /collect?payload_data HTTP/1.1 Host: https://www.google-analytics.com User-Agent: user_agent_string
جایی که داده های محموله به عنوان پارامترهای پرس و جو فرار از URI ارسال می شود. طول کل URL رمزگذاری شده نباید بیشتر از 8000 بایت باشد.
شکستن کش
در برخی محیطها، مانند مرورگرها، درخواستهای HTTP GET ممکن است ذخیره شوند. هنگامی که یک درخواست در حافظه پنهان ذخیره می شود، درخواست های بعدی ممکن است از حافظه پنهان بازیابی شوند و به Google Analytics ارسال نشوند. برای عبور از حافظه نهان، پروتکل اندازه گیری یک پارامتر خاص ( z
) ارائه می کند که می تواند با یک عدد تصادفی تنظیم شود. این تضمین میکند که تمام درخواستهای پروتکل اندازهگیری منحصربهفرد هستند و درخواستهای بعدی از حافظه پنهان بازیابی نمیشوند.
هنگامی که از حافظه پنهان استفاده می کنید، ما به شدت توصیه می کنیم این پارامتر را به عنوان آخرین پارامتر در بارگذاری اضافه کنید.
https://www.google-analytics.com/collect?payload_data&z=123456
کدهای پاسخ
اگر درخواست HTTP دریافت شود، پروتکل اندازه گیری یک کد وضعیت 2xx
را برمی گرداند. اگر دادههای محموله نادرست باشد، یا اگر دادههای موجود در بار نادرست باشد یا توسط Google Analytics پردازش نشده باشد، پروتکل اندازهگیری کد خطایی را باز نمیگرداند.
اگر کد وضعیت 2xx
دریافت نکردید، نباید درخواست را دوباره امتحان کنید. درعوض، باید هرگونه خطا در درخواست HTTP خود را متوقف و تصحیح کنید.
داده های بار
تمام داده های جمع آوری شده توسط Google Analytics با استفاده از پروتکل اندازه گیری به عنوان یک بار ارسال می شود. payload شبیه یک رشته جستجوی URL است که در آن هر پارامتر دارای یک کلید و مقدار است، با یک کاراکتر =
از هم جدا می شود و هر جفت با یک کاراکتر &
محدود می شود. مثلا:
key1=val1&key2=val2
هر بار دارای قوانینی است که بر آنها حاکم است: مقادیر مورد نیاز، رمزگذاری URI، پارامترهایی که می توانند با هم ارسال شوند و طول پارامتر. همچنین هر پارامتر دارای نوع خاصی است که به فرمت خاصی نیاز دارد. بخش های زیر این قوانین را بررسی می کند.
برای فهرست کامل تمام پارامترهایی که می توانید با استفاده از پروتکل اندازه گیری ارسال کنید، مرجع پارامتر را بخوانید.
مقادیر مورد نیاز برای همه بازدیدها
پارامترهای زیر باید در هر محموله باشد:
نام | پارامتر | مثال | شرح |
---|---|---|---|
نسخه پروتکل | v | v= 1 | نسخه پروتکل مقدار باید 1 باشد. |
شناسه پیگیری | tid | tid= UA-123456-1 | شناسه ای که تشخیص می دهد به کدام ویژگی Google Analytics داده ارسال شود. |
شناسه مشتری | cid | cid= xxxxx | یک شناسه منحصر به فرد برای یک کاربر خاص. |
نوع را بزنید | t | t= pageview | نوع تعامل جمع آوری شده برای یک کاربر خاص. |
Client ID
و دادههای Hit Type
مقادیری هستند که مستقیماً به مدل داده Google Analytics نگاشت میشوند. اگر میخواهید کاربر 5555
را که به /pageA
، /pageB
و /pageC
رفته است ردیابی کنید، 3 بار زیر را ارسال میکنید:
v=1&tid=UA-123456-1&cid=5555&t=pageview&dp=%2FpageA v=1&tid=UA-123456-1&cid=5555&t=pageview&dp=%2FpageB v=1&tid=UA-123456-1&cid=5555&t=pageview&dp=%2FpageC
توجه داشته باشید که /
به %2F
کدگذاری شده است.
مقادیر رمزگذاری URL
همه مقادیر ارسال شده به Google Analytics باید UTF-8 و URL Encoded باشند. برای ارسال کلید dp
با مقدار /my page €
، ابتدا باید مطمئن شوید که این کد UTF-8 است، سپس url رمزگذاری شده است و در نتیجه رشته نهایی ایجاد می شود:
dp=%2Fmy%20page%20%E2%82%AC
اگر هر یک از کاراکترها به اشتباه کدگذاری شده باشد، با نویسه جایگزین یونیکد xFFFD
جایگزین می شود.
مقادیر مورد نیاز برای انواع ضربه های خاص
برخی از پارامترها ممکن است فقط با انواع ضربه خاص ارسال شوند. برای مثال، نوع ضربه pageview
مستلزم آن است که پارامتر Page Path ( dp
) نیز تنظیم شود. مرجع پارامتر توصیف می کند که کدام پارامتر برای کدام نوع ضربه مورد نیاز است.
حداکثر طول
برخی از مقادیر متنی در پروتکل اندازه گیری حداکثر طول مشخصی بر حسب بایت دارند. به عنوان مثال، فیلد ارجاع دهنده سند dr
دارای حداکثر طول 2048 بایت است. اگر هر یک از مقادیر بیشتر از حداکثر طول باشد، به طور خودکار کوتاه می شوند. اگر یک کاراکتر چند بایتی از حداکثر طول بیشتر شود، کل کاراکتر کوتاه می شود.
انواع داده های پشتیبانی شده
هر فیلد داده در پروتکل اندازه گیری به نوع خاصی تعلق دارد که هر کدام قوانین اعتبار سنجی خاص خود را دارد. اگر هر یک از مقادیر پارامتر با قوانین اعتبارسنجی مطابقت نداشته باشد، آن پارامتر خاص نادیده گرفته می شود و توسط Google Analytics پردازش نمی شود. تمام پارامترهای دیگر به طور معمول پردازش می شوند.
پروتکل اندازه گیری از انواع داده های زیر پشتیبانی می کند:
توجه داشته باشید که فیلدهای داده فردی ممکن است محدودیت های خاص خود را داشته باشند. برای فهرست کامل تمام فیلدهای داده و انواع پذیرفته شده به مرجع فیلد مراجعه کنید.
متن
برای نمایش رشته ها استفاده می شود. پردازش اضافی در فیلدهای متنی انجام می شود. همه کاراکترهای فضای خالی اصلی و انتهایی حذف می شوند. اجرای داخلی دو یا چند کاراکتر فضای خالی (شامل فاصله، تب، خطوط جدید و غیره) به یک کاراکتر فاصله کاهش مییابد. این تبدیل قبل از هر گونه کوتاهی روی متن خام اعمال می شود. مثلا:
Hello World
خواهد شد:
Hello World
واحد پول
برای نشان دادن ارزش کل یک ارز استفاده می شود. نقطه اعشار به عنوان جداکننده بین کل و بخش کسری ارز استفاده می شود. دقت تا 6 رقم اعشار است. موارد زیر برای یک فیلد ارز معتبر است:
1000.000001
پس از ارسال مقدار به Google Analytics، تمام متن تا اولین رقم، کاراکتر -
یا .
کاراکتر (اعشاری). بنابراین:
$-55.00
خواهد شد:
-55.00
بولی
برای تعیین درست یا نادرست بودن یک مقدار استفاده می شود. مقادیر معتبر عبارتند از:
-
1
- درست است -
0
- نادرست
عدد صحیح
برای نمایش یک عدد صحیح استفاده می شود. مقدار به عنوان یک int64 امضا شده ذخیره می شود
عدد
برای نمایش یک عدد صحیح یا یک عدد ممیز شناور استفاده می شود.