סקירה כללית
שליחת נתונים ל-Google Analytics באמצעות כלי מדידה מורכבת משני חלקים פרוטוקול:
- ההעברה – המקום והאופן שבהם נשלחים הנתונים
- המטען הייעודי (payload) – הנתונים שאתם שולחים
במסמך הזה מתואר הפורמט של התעבורה והמטען הייעודי (payload).
תחבורה
נקודת קצה של כתובת URL
שולחים נתונים באמצעות ה-Measurement Protocol על ידי שליחת בקשות HTTP POST נקודת הקצה הבאה:
https://www.google-analytics.com/mp/collect
כדי לשלוח אירוע, צריך לשלוח את בקשת ה-POST
הבאה:
POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>
BODY
של הבקשה. פרטים נוספים זמינים בקטע מטען ייעודי (Payload).
קודי תגובה
Measurement Protocol תמיד יחזיר קוד סטטוס 2xx
אם HTTP
התקבלה בקשה. Measurement Protocol לא מחזיר קוד שגיאה אם
שנתוני המטען הייעודי (Payload) היו שגויים, או שהנתונים במטען הייעודי (Payload) היו שגויים
לא עבר עיבוד על ידי Google Analytics.
מטען ייעודי (payload)
הנתונים נשלחים אל Google Analytics באמצעות נתוני Measurement Protocol בשני שלבים חלקים:
- פרמטרים של שאילתה
- גוף
JSON
POST
פרמטרים של שאילתה
שם פרמטר | תיאור |
---|---|
|
חובה.
כדי ליצור סוד חדש, עוברים לממשק המשתמש של Google Analytics כדי:
אנחנו ממליצים להשאיר אותם פרטיים בארגון שלך. אם המיקום
כשפורסים את Measurement Protocol בצד הלקוח,
מומלץ להחליף |
|
מזהה מדידה. המזהה של מקור נתונים. נמצאו ב-Google
ממשק המשתמש של Analytics בקטע:
אדמין > מקורות נתונים > לבחור את השידור החי > מזהה מדידה |
גוף הפוסט בפורמט JSON
מפתח | סוג | תיאור |
---|---|---|
|
string |
חובה. מזהה באופן ייחודי מופע משתמש של לקוח אינטרנט. אפשר לעיין בקטע שליחת אירוע אל Measurement Protocol. |
|
string |
זה שינוי אופציונלי. מזהה ייחודי של המשתמש. ראה User-ID עבור ניתוח נתונים מפלטפורמות שונות כדי לקבל מידע נוסף על המזהה הזה. |
|
number |
זה שינוי אופציונלי. חותמת זמן של Unix (במיליוניות השנייה) של הזמן לשיוך
עם האירוע. יש להגדיר את האפשרות הזו רק לתיעוד אירועים שקרו
בעבר. אפשר לשנות את הערך הזה דרך
|
|
object |
זה שינוי אופציונלי. מאפייני המשתמשים של המדידה. הצגת משתמש למידע נוסף. |
|
object |
זה שינוי אופציונלי. קביעת הגדרות ההסכמה של הבקשה. מידע נוסף זמין בקטע בנושא הסכמה. |
|
boolean |
זה שינוי אופציונלי. יש להגדיר את הערך true כדי לציין שאין צורך בנתוני המשתמש
יכול לשמש להצגת מודעות בהתאמה אישית.
|
|
array |
חובה. מערך של פריטי אירועים. אפשר לשלוח עד 25 אירועים בכל בקשה. להצגת האירועים לכל האירועים התקינים. |
|
string |
חובה. שם האירוע. להצגת האירועים לכל האפשרויות. |
|
object |
זה שינוי אופציונלי. הפרמטרים של האירוע. להצגת אירועים לפרמטרים המוצעים של כל אירוע. |
הסכמה
המאפיין consent
מגדיר את הסוגים והמצבים של הסכמה.
אם לא מציינים את הערך consent
, מערכת Google Analytics משתמשת בהסכמה
ההגדרות של האינטראקציות אונליין תואמות ללקוח או למופע של האפליקציה.
מפתח | סוג | תיאור |
---|---|---|
|
string |
אופציונלי. מגדיר הסכמה לשליחת נתוני משתמש אירועים ומאפייני משתמש ל-Google למטרות פרסום. התו חייב להיות |
|
string |
אופציונלי. מגדירה הסכמה לפרסום מותאם אישית עבור המשתמש. התו חייב להיות |
פרמטרים מותאמים אישית
בנוסף לפרמטרים שנקבעים מראש, אפשר לכלול התאמה אישית ברמת המשתמש, ברמת האירוע וברמת הפריט פרמטרים במטען ייעודי (payload) של Measurement Protocol.
- אפשר לכלול פרמטרים מותאמים אישית ברמת המשתמש באובייקט
user_properties
של המטען הייעודי (payload). - אפשר לכלול פרמטרים מותאמים אישית ברמת האירוע ב
events[].params
של המטען הייעודי (payload). - אפשר לכלול פרמטרים מותאמים אישית ברמת הפריט בעמודה הזו.
מערך
items
לכל אירוע.
ערכים מומלצים לאירועים מסוימים
לחלק מהאירועים יש פרמטרים מומלצים. כדי לקבל המלצות, אפשר לעיין באירועים לכל האירועים הנתמכים.
שמות שמורים
שמות שמורים של אירועים
שמות האירועים הבאים שמורים ואי אפשר להשתמש בהם:
ad_activeview
ad_click
ad_exposure
ad_query
ad_reward
adunit_exposure
app_clear_data
app_exception
app_install
app_remove
app_store_refund
app_update
app_upgrade
dynamic_link_app_open
dynamic_link_app_update
dynamic_link_first_open
error
firebase_campaign
firebase_in_app_message_action
firebase_in_app_message_dismiss
firebase_in_app_message_impression
first_open
first_visit
in_app_purchase
notification_dismiss
notification_foreground
notification_open
notification_receive
notification_send
os_update
session_start
user_engagement
שמות פרמטרים שמורים
שמות הפרמטרים הבאים שמורים ואי אפשר להשתמש בהם:
firebase_conversion
בנוסף, שמות הפרמטרים לא יכולים להתחיל ב:
_ (underscore)
firebase_
ga_
google_
gtag.
שמות שמורים של מאפייני משתמשים
השמות של מאפייני המשתמשים הבאים שמורים ואי אפשר להשתמש בהם:
first_open_time
first_visit_time
last_deep_link_referrer
user_id
first_open_after_install
בנוסף, שמות של מאפייני משתמשים לא יכולים להתחיל ב:
_ (underscore)
firebase_
ga_
google_