שליחת אירועים באתר ל-GA4 באמצעות Measurement Protocol

1. מבוא

עדכון אחרון: 30 באפריל 2019

מה תפַתחו

  • ב-Codelab הזה תלמדו איך לשלוח אירועים חיצוניים ל-GA4 באמצעות Measurement Protocol.
  • פלטפורמת ה-Codelab הזו יוצאת מנקודת הנחה שכבר יש לכם דף אינטרנט או אתר ש-Google Analytics 4 מוטמע בו.

מה תלמדו

  • השלבים לביצוע השיחה הראשונה בשימוש ב-MP
  • הסבר על הפרמטרים הנדרשים לשיחה
  • שליחה ואימות של שיחת הבדיקה
  • כדי לבצע את הקריאה, צריך ליצור סקריפט לדוגמה ב-Python

מה צריך להכין

  • אתר/דף אינטרנט
  • כל סביבת פיתוח משולבת (IDE) לצורך ביצוע שינויים
  • חשבון GA4
  • אופציונלי – סביבת פיתוח Python (או Colab)

2. צריך לאסוף את שדות החובה

יצירת API Secret ב-GA4

כדי לעבור אל GA4 וליצור את ה-API Secret החדש, עוברים לקטע 'ניהול' > מקורות נתונים > בחרו את השידור שלכם > Measurement Protocol > הוספת פרטי חיוב

8dee89e850ae90bb.png

d0be19d8112435a2.png

de5a80a1445d3a14.png

אפשר להזין כל כינוי שרוצים, והערך הסודי יוצג, ותוכלו להשתמש בו בשיחה

איסוף client_id

אפשר להשתמש בכל אחת מהשיטות הבאות כדי לאסוף את הפרמטר client_id.

  1. איסוף באמצעות gTag

שני המדדים האלה מוסברים בפירוט בהמשך

איסוף באמצעות gTag

אפשר לאחזר את הפרמטר client_id דרך האתר באמצעות :

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

בהמשך מופיעים קישורים נוספים, בהתאם לתשתית שלך.

3. בניית השיחה

תוכלו ליצור קריאה לדוגמה באמצעות הכלי ליצירת אירועים ב-GA4. (לשם כך צריך להתחבר ולהפעיל קובצי Cookie). מוודאים שהמתג מוגדר כ-"gtag.js"

b904d2a053eb7817.png

עליך למלא את השדות הבאים

  • api_secret – כבר נוצר מוקדם יותר ב-GA4
  • מדידה_id- כדי לקבל את זה, אפשר לעבור לקטע 'אדמין' > מקורות נתונים > לבחור את השידור שלכם . השם אמור להיות מוצג כך:

d362992ff592c675.png

  • client_id - כבר אחזרת את הערך הזה
  • הפרמטר user_id אינו חובה. אפשר להשאיר את השדה ריק בינתיים
  • קטגוריה – שינוי ל"מותאם אישית" מהתפריט הנפתח, ומוסיפים שם אירוע כלשהו (אל תשתמשו באירוע שנאסף באופן אוטומטי). כאן נשתמש ב-"test_from_codelab"

cf580a708bb0a8a2.png

אפשר גם לספק פרמטרים של אירועים או מאפייני משתמש על ידי לחיצה על הלחצנים הבאים

da59bb982f6f906a.png

אחרי שממלאים את כל הפרטים, אמור להופיע משהו כזה עם לחצן 'אימות האירוע'

31f720d550906298.png

בשלב הזה, צריך ללחוץ על 'אימות אירוע' , הלחצן שמודגש בכתום. בהודעה אמורה להופיע ההודעה הבאה, שמציינת שהאירוע חוקי. יופיע הלחצן 'שליחה אל GA'. בשלב הזה, אם האירוע נמצא כלא חוקי, הכלי יציין מה השדה המדויק שבו יש בעיה ותוכלו לתקן אותה ולנסות שוב.

1d63d1e067c46294.png

עכשיו אפשר ללחוץ על הלחצן, והוא אמור לשלוח אירוע בדיקה ל-GA4

4. אימות אירועים ב-GA4

אחרי ששולחים את האירוע, אפשר לעבור לחשבון GA4 ולבדוק את הדוח 'זמן אמת'. האירוע אמור להופיע

7b9e9a0f74b64757.png

ייתכן שיחלפו כ-24 שעות עד שהאירועים יועברו מהתצוגה בזמן אמת לכרטיסיית הדיווח על האירועים בפועל, כך שאין צורך לדאוג אם לא רואים את זה מיד בדיווח על האירועים הרגיל!

5. פיתוח סקריפט Python

עכשיו, אחרי שבדקתם את זה, אתם יכולים לבחון את הקריאה ל-API ואת המטען הייעודי של האירועים כדי ליצור ארכיטקטורה דומה ב-Python (או בכל שפה שתבחרו) שיכולה לבצע את הקריאה הזו. אחר כך תוכלו לתזמן את זה בתדירות הרצויה ולהפעיל אותה. בחלק הזה, אפשר להשתמש בכל סביבת פיתוח משולבת (IDE) לבחירתכם שתומכת ב-Python או פשוט להשתמש ב-notebook של Google Colab שלא מחייב התקנה במכשיר

בחזרה לכלי ליצירת אירועים ב-GA4, נקודת הקצה תופיע בהמשך

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

המטען הייעודי (Payload) של האירוע היה כפי שמפורט בהמשך

{
  "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. מזל טוב

מזל טוב, השתמשת בהצלחה ב-Measurement Protocol ב-GA4. עכשיו אתם יכולים ליצור ארכיטקטורות פתרונות מתקדמות כדי לשלוח נתונים משמעותיים יותר ל-Google Analytics ולשפר את ניתוח הנתונים של השיווק והעסק. כדי להפיק את המקסימום מהתהליך הזה, מומלץ גם להתחבר ל-Google Ads ולייבא את האירועים האלה כהמרות.

למדת

  • איך לאסוף את המשתנים הנכונים כדי לבצע קריאות ל-MP
  • איך שולחים ומאמתים אירועי בדיקה
  • איך לבנות סקריפט לשליחת קריאות ל-MP

מסמכי עזר