این راهنما توضیح میدهد که چگونه میتوانید رویدادهای جریان برنامه و وب پروتکل اندازهگیری Google Analytics را به سرور Google Analytics ارسال کنید تا بتوانید رویدادهای پروتکل اندازهگیری را در گزارشهای Google Analytics خود مشاهده کنید.
پلتفرمی را که می خواهید در این راهنما ببینید انتخاب کنید:
فرمت درخواست
پروتکل اندازه گیری Google Analytics 4 فقط از درخواست های HTTP POST
پشتیبانی می کند.
برای ارسال رویداد از فرمت زیر استفاده کنید:
POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>
شما باید موارد زیر را در URL درخواست ارائه دهید:
api_secret
: API SECRET ایجاد شده در رابط کاربری Google Analytics.برای ایجاد یک راز جدید، به Admin > Data Streams > جریان خود > Measurement Protocol > Create را انتخاب کنید.
measurement_id
: شناسه اندازهگیری مرتبط با یک جریان، که در رابط کاربری Google Analytics در زیر Admin > Data Streams > جریان خود را انتخاب کنید > Measurement ID یافت میشود.measurement_id
شناسه جریان شما نیست.
برای مرجع کامل به پارامترهای پرس و جو مراجعه کنید.
شما باید موارد زیر را در بدنه درخواست ارائه دهید:
-
client_id
: یک شناسه منحصر به فرد برای یک مشتری. این با Firebaseapp_instance_id
متفاوت است. از gtag.js('get') استفاده کنید.
user_id
: اختیاری. یک شناسه منحصر به فرد برای یک کاربر. فقط می تواند شامل کاراکترهای utf-8 باشد. برای اطلاعات بیشتر در مورد این شناسه ، برای تجزیه و تحلیل بین پلتفرم، User-ID را ببینید.consent
: اختیاری با نحوه تنظیم تنظیمات رضایت آشنا شوید.events
: مجموعه ای از آیتم های رویداد. می توانید چندین رویداد را در یک درخواست قرار دهید.برای اینکه فعالیت کاربر در گزارشهایی مانند Realtime نمایش داده شود،
engagement_time_msec
وsession_id
باید به عنوان بخشی ازparams
یکevent
ارائه شوند. پارامترengagement_time_msec
باید زمان تعامل رویداد را بر حسب میلی ثانیه منعکس کند.در اینجا یک مثال است:
{
"client_id": "123456.7654321",
"events": [
{
"name": "campaign_details",
"params": {
"campaign_id": "google_1234",
"campaign": "Summer_fun",
"source": "google",
"medium": "cpc",
"term": "summer+travel",
"content": "logolink",
"session_id": "123",
"engagement_time_msec": "100"
}
}
]
}
در حالی که session_start
یک نام رویداد رزرو شده است، ایجاد یک session_id
جدید یک جلسه جدید بدون نیاز به ارسال session_start
ایجاد می کند. نحوه شمارش جلسات را درک کنید.
آن را امتحان کنید
در اینجا نمونهای وجود دارد که میتوانید از آن برای ارسال رویداد tutorial_begin
به سرور Google Analytics خود استفاده کنید:
const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
method: "POST",
body: JSON.stringify({
client_id: 'XXXXXXXXXX.YYYYYYYYYY',
events: [{
name: 'tutorial_begin',
params: {},
}]
})
});
محدودیت ها
محدودیتهای زیر برای ارسال رویدادهای پروتکل اندازهگیری به Google Analytics اعمال میشود:
- درخواست ها می توانند حداکثر 25 رویداد داشته باشند.
- رویدادها می توانند حداکثر 25 پارامتر داشته باشند.
- رویدادها می توانند حداکثر 25 ویژگی کاربر داشته باشند.
- نام ویژگی های کاربر باید 24 کاراکتر یا کمتر باشد.
- مقادیر ویژگی کاربر باید 36 کاراکتر یا کمتر باشد.
- نام رویدادها باید 40 نویسه یا کمتر باشد، فقط میتوانند شامل نویسههای الف-عددی و زیرخط باشند و باید با یک نویسه الفبا شروع شوند.
- نام پارامترها شامل پارامترهای آیتم باید 40 کاراکتر یا کمتر باشد، فقط میتواند شامل نویسههای الف-عددی و زیرخط باشد و باید با یک نویسه الفبایی شروع شود.
- مقادیر پارامتر شامل مقادیر پارامتر آیتم باید برای یک ویژگی استاندارد Google Analytics 4 100 نویسه یا کمتر و برای ویژگی Google Analytics 360 500 نویسه یا کمتر باشد.
- پارامترهای مورد می توانند حداکثر 10 پارامتر سفارشی داشته باشند.
- بدنه پست باید کمتر از 130 کیلوبایت باشد.
- انتساب در سطح رویداد از رویدادهای پروتکل اندازهگیری حداکثر تا ۶۳ روز پس از آخرین رویداد برچسبگذاری آنلاین برای صادرات تبدیل به تبلیغات و سایر ادغامهای رسانه پشتیبانی میشود، حتی اگر پنجره تبدیل رویداد تبدیل بیش از ۶۳ روز باشد. در مقابل، انتساب در سطح رویداد برای برچسبگذاری رویدادهای آنلاین برای کل پنجره تبدیل پشتیبانی میشود.
- برای اهداف بازاریابی مجدد، میتوانید با یک کوکی یا شناسه دستگاه مرتبط، تا چند روز بعد از آخرین رویداد آنلاین به رویدادهای پروتکل اندازهگیری بپیوندید:
- جریان وب: 30 روز
- پخش برنامه: 42 روز
- رویدادهای پروتکل اندازهگیری برنامه ارسال شده به Google Analytics 4 مخاطبان جستجو در Google Ads را برای کاربران برنامه پر نمیکند.