رویدادهای وب را با استفاده از پروتکل اندازه گیری به GA4 ارسال کنید

1. مقدمه

آخرین به روز رسانی: 2019-04-30

چیزی که خواهی ساخت

• در این کد لبه، نحوه ارسال رویدادهای خارجی به GA4 با استفاده از پروتکل اندازه گیری را خواهید آموخت.
• این کد لبه فرض می‌کند که شما قبلاً یک صفحه وب یا سایتی با Google Analytics 4 دارید.

چیزی که یاد خواهید گرفت

• مراحل انجام اولین تماس MP
• پارامترهای مورد نیاز برای تماس را درک کنید
• تماس آزمایشی خود را ارسال و تأیید کنید
• برای برقراری تماس یک اسکریپت نمونه در پایتون بسازید

آنچه شما نیاز دارید

• یک وب سایت / صفحه وب
• هر IDE برای ایجاد تغییرات
• حساب GA4
• اختیاری - محیط توسعه پایتون (یا Colab)

2. فیلدهای اجباری را جمع آوری کنید

ایجاد API Secret در GA4

به GA4 بروید و با رفتن به Admin > Data Streams > جریان خود > Measurement Protocol > Create راز API جدید خود را ایجاد کنید.

شما می توانید هر نام مستعاری را ارائه دهید و مقدار مخفی نمایش داده می شود که می توانید از آن در تماس خود استفاده کنید

Client_id را جمع آوری کنید

می توانید از هر یک از روش های زیر برای جمع آوری client_id خود استفاده کنید.

1. جمع آوری از طریق gTag

هر دوی این موارد در زیر به تفصیل توضیح داده شده است

جمع آوری از طریق gTag

شما می توانید client_id خود را از طریق وب سایت خود با استفاده از:

gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
  Do something with clientID)
}

در زیر پیوندهای بیشتری بسته به زیرساخت شما وجود دارد

• gtag.js ('get')

3. ساخت فراخوان

می توانید با استفاده از Event Builder در GA4 یک تماس نمونه بسازید. (برای این کار باید وارد شوید و کوکی ها را فعال کنید). مطمئن شوید که ضامن روی "gtag.js" تنظیم شده است

شما باید فیلدهای زیر را پر کنید

• api_secret - قبلاً در GA4 ایجاد شده است
• meterment_id- برای دریافت این مورد، می توانید به Admin > Data Streams > جریان خود را انتخاب کنید. باید به صورت زیر نمایش داده شود

• client_id - شما قبلاً این مقدار را بازیابی کرده اید
• user_id اجباری نیست. فعلا می توانید آن را خالی بگذارید
• دسته - این مورد را از منوی کشویی به «سفارشی» تغییر دهید و نام رویداد دلخواه خود را در آن قرار دهید (از هیچ رویداد جمع‌آوری شده خودکار استفاده نکنید). در اینجا ما از "test_from_codelab" استفاده می کنیم

به صورت اختیاری، همچنین می‌توانید با کلیک بر روی دکمه‌های زیر، پارامترهای رویداد و/یا ویژگی‌های کاربر را ارائه دهید

هنگامی که همه چیز را پر کردید، باید چیزی شبیه به این را ببینید، با یک دکمه برای "تأیید رویداد"

هنگامی که به این مورد رسیدید، روی "VALIDATE EVENT" کلیک کنید، دکمه ای که با رنگ نارنجی مشخص شده است. باید پیام زیر را نشان دهد که مشخص می کند رویداد معتبر است و اکنون دکمه "ارسال به GA" را خواهید دید. در این مرحله، اگر رویداد نامعتبر ظاهر شود، ابزار دقیقاً فیلد مشکلی را به شما می‌گوید و می‌توانید آن را برطرف کرده و دوباره امتحان کنید.

اکنون می توانید روی دکمه کلیک کنید و باید یک رویداد آزمایشی را به GA4 ارسال کند

4. اعتبار سنجی رویدادها در GA4

پس از ارسال رویداد، می توانید به حساب GA4 خود بروید و Realtime را بررسی کنید. باید ببینید که این رویداد از راه می رسد

ممکن است حدود 24 ساعت طول بکشد تا رویدادها از نمای بیدرنگ به برگه گزارش رویدادهای واقعی منتشر شوند، بنابراین اگر فوراً این مورد را در گزارش رویداد معمولی مشاهده نکردید، نگران نباشید!

5. ساخت اسکریپت پایتون

اکنون که آن را آزمایش کرده‌اید، می‌توانید فراخوانی API و بار رویداد را بررسی کنید تا معماری مشابهی در پایتون (یا به هر زبان دلخواه شما) بسازید که می‌تواند این تماس را انجام دهد. سپس می توانید این را در فرکانس مورد نظر خود برنامه ریزی کرده و آن را عملیاتی کنید. برای این بخش، می توانید از هر IDE مورد نظر خود که از پایتون پشتیبانی می کند استفاده کنید یا فقط از یک نوت بوک Google Colab استفاده کنید که نیازی به نصب بر روی دستگاه شما ندارد.

با مراجعه به GA4 Event Builder، خواهید دید که نقطه پایانی مانند زیر است

POST /mp/collect?measurement_id=XXXX&api_secret=XXXX 
HTTP/1.1
Host: www.google-analytics.com

محموله رویداد به شرح زیر بود

{
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}

با استفاده از چیزی شبیه به این می توانید این را به پایتون ترجمه کنید

import requests
import json
url = "https://www.google-analytics.com/mp/collect?measurement_id=XXXX&api_secret=XXXX"
payload = {
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)

هنگامی که این را با مقادیر مناسب اجرا کردید، باید به طور مشابه رویداد را در زمان واقعی در GA4 مشاهده کنید.

6. تبریک می گویم

تبریک می‌گوییم، شما با موفقیت از پروتکل اندازه‌گیری در GA4 استفاده کردید. اکنون می توانید معماری راه حل های قدرتمندی بسازید تا داده های معنی دار بیشتری را به Google Analytics ارسال کنید و تجزیه و تحلیل بازاریابی و کسب و کار خود را بهبود بخشید. برای استفاده حداکثری از این، ما همچنین اتصال به Google Ads و وارد کردن این رویدادها را به عنوان تبدیل پیشنهاد می‌کنیم.

تو یاد گرفتی

• نحوه جمع آوری متغیرهای مناسب برای برقراری تماس MP
• نحوه ارسال و اعتبارسنجی رویدادهای آزمایشی
• چگونه یک اسکریپت برای ارسال تماس MP بسازیم

اسناد مرجع

• پروتکل اندازه گیری - مرجع
• پروتکل اندازه گیری GA4 - سازنده رویداد
• پروتکل اندازه گیری - نمای کلی