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

۱. مقدمه

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

آنچه خواهید ساخت

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

آنچه یاد خواهید گرفت

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

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

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

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

ایجاد API Secret در GA4

به GA4 بروید و با رفتن به Admin > Data Streams > select your stream > 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('دریافت')

۳. ایجاد فراخوان

شما می‌توانید با استفاده از سازنده رویداد در GA4 یک فراخوانی نمونه ایجاد کنید. (این کار مستلزم ورود به سیستم و فعال بودن کوکی‌ها است). مطمئن شوید که گزینه روی "gtag.js" تنظیم شده است.

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

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

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

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

وقتی همه چیز را پر کردید، باید چیزی شبیه به این را ببینید، به همراه دکمه‌ای برای «اعتبارسنجی رویداد»

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

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

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

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

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

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

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

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

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 مشاهده کنید.

۶. تبریک

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

یاد گرفتی.

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

اسناد مرجع

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