رویدادهای پروتکل اندازه گیری را به Google Analytics ارسال کنید

این راهنما توضیح می‌دهد که چگونه می‌توانید رویدادهای جریان برنامه و وب پروتکل اندازه‌گیری 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 : یک شناسه منحصر به فرد برای یک مشتری. این با Firebase app_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 کاراکتر یا کمتر باشد، فقط می‌تواند شامل نویسه‌های الف-عددی و زیرخط باشد و باید با یک نویسه الفبایی شروع شود.
  • مقادیر پارامتر شامل مقادیر پارامتر مورد باید 100 کاراکتر یا کمتر باشد.
  • پارامترهای مورد می توانند حداکثر 10 پارامتر سفارشی داشته باشند.
  • بدنه پست باید کوچکتر از 130 کیلوبایت باشد.
  • انتساب در سطح رویداد از رویدادهای پروتکل اندازه‌گیری حداکثر تا ۶۳ روز پس از آخرین رویداد برچسب‌گذاری آنلاین برای صادرات تبدیل به تبلیغات و سایر ادغام‌های رسانه پشتیبانی می‌شود، حتی اگر پنجره تبدیل رویداد تبدیل بیش از ۶۳ روز باشد. در مقابل، انتساب در سطح رویداد برای برچسب‌گذاری رویدادهای آنلاین برای کل پنجره تبدیل پشتیبانی می‌شود.
  • برای اهداف بازاریابی مجدد، می‌توانید با یک کوکی یا شناسه دستگاه مرتبط، تا چند روز بعد از آخرین رویداد آنلاین به رویدادهای پروتکل اندازه‌گیری بپیوندید:
    • جریان وب: 30 روز
    • پخش برنامه: 42 روز
  • رویدادهای پروتکل اندازه‌گیری برنامه ارسال شده به Google Analytics 4 مخاطبان جستجو در Google Ads را برای کاربران برنامه پر نمی‌کند.