חומר עזר בנושא Measurement Protocol

סקירה כללית

שליחת נתונים ל-Google Analytics באמצעות כלי מדידה מורכבת משני חלקים פרוטוקול:

  1. ההעברה – המקום והאופן שבהם נשלחים הנתונים
  2. המטען הייעודי (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>

קודי תגובה

Measurement Protocol תמיד יחזיר קוד סטטוס 2xx אם HTTP התקבלה בקשה. Measurement Protocol לא מחזיר קוד שגיאה אם שנתוני המטען הייעודי (Payload) היו שגויים, או שהנתונים במטען הייעודי (Payload) היו שגויים לא עבר עיבוד על ידי Google Analytics.

מטען ייעודי (payload)

הנתונים נשלחים אל Google Analytics באמצעות נתוני Measurement Protocol בשני שלבים חלקים:

  1. פרמטרים של שאילתה
  2. גוף JSON POST

פרמטרים של שאילתה

שם פרמטר תיאור

api_secret

חובה. API Secret שנוצר באמצעות ממשק המשתמש של Google Analytics.

כדי ליצור סוד חדש, עוברים לממשק המשתמש של Google Analytics כדי:
אדמין > מקורות נתונים > לבחור את השידור החי &gt; Measurement Protocol > יצירה

אנחנו ממליצים להשאיר אותם פרטיים בארגון שלך. אם המיקום כשפורסים את Measurement Protocol בצד הלקוח, מומלץ להחליף api_secret באופן קבוע כדי למנוע ספאם מוגזם.

גוף הפוסט בפורמט JSON

מפתח סוג תיאור

user_id

 string

זה שינוי אופציונלי. מזהה ייחודי של המשתמש. ראה User-ID עבור ניתוח נתונים מפלטפורמות שונות כדי לקבל מידע נוסף על המזהה הזה.

timestamp_micros

 number

זה שינוי אופציונלי. חותמת זמן של Unix (במיליוניות השנייה) של הזמן לשיוך עם האירוע. יש להגדיר את האפשרות הזו רק לתיעוד אירועים שקרו בעבר. אפשר לשנות את הערך הזה דרך user_property או חותמות זמן של אירועים. אפשר ליצור תאריך לאחור של אירועים עד 3 ימים קלנדריים בהתאם לאזור הזמן של הנכס.

user_properties

 object זה שינוי אופציונלי. מאפייני המשתמשים של המדידה. הצגת משתמש למידע נוסף.
object זה שינוי אופציונלי. קביעת הגדרות ההסכמה של הבקשה. מידע נוסף זמין בקטע בנושא הסכמה.

non_personalized_ads

 boolean זה שינוי אופציונלי. יש להגדיר את הערך true כדי לציין שאין צורך בנתוני המשתמש יכול לשמש להצגת מודעות בהתאמה אישית.

events[]

 array חובה. מערך של פריטי אירועים. אפשר לשלוח עד 25 אירועים בכל בקשה. להצגת האירועים לכל האירועים התקינים.

events[].name

 string חובה. שם האירוע. להצגת האירועים לכל האפשרויות.

events[].params

 object זה שינוי אופציונלי. הפרמטרים של האירוע. להצגת אירועים לפרמטרים המוצעים של כל אירוע.

המאפיין consent מגדיר את הסוגים והמצבים של הסכמה. אם לא מציינים את הערך consent, מערכת Google Analytics משתמשת בהסכמה ההגדרות של האינטראקציות אונליין תואמות ללקוח או למופע של האפליקציה.

מפתח סוג תיאור

ad_user_data

 string

אופציונלי. מגדיר הסכמה לשליחת נתוני משתמש אירועים ומאפייני משתמש ל-Google למטרות פרסום.

התו חייב להיות GRANTED או DENIED.

ad_personalization

 string

אופציונלי. מגדירה הסכמה לפרסום מותאם אישית עבור המשתמש.

התו חייב להיות GRANTED או DENIED.

פרמטרים מותאמים אישית

בנוסף לפרמטרים שנקבעים מראש, אפשר לכלול התאמה אישית ברמת המשתמש, ברמת האירוע וברמת הפריט פרמטרים במטען ייעודי (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_