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

1. מבוא

העדכון האחרון: 2019-04-30

מה תפַתחו

  • ב-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
  • ‫measurement_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

המטען הייעודי של האירוע היה כפי שמוצג בהמשך

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

אפשר לתרגם את זה ל-Python באמצעות קוד כמו זה

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

מאמרי עזרה