אירועים מומלצים ואירועים מותאמים אישית ב-Google Analytics

אתם יכולים להשתמש ב-Data Manager API כדי לשלוח אירועים מומלצים ואירועים מותאמים אישית ב-Google Analytics.

שליחת אירועים מומלצים ואירועים בהתאמה אישית

אם אתם משדרגים מ-Google Analytics Measurement Protocol, תוכלו לקרוא את ההוראות במאמר שדרוג מ-Measurement Protocol ל-Data Manager API.

סקירה כללית של תהליך העבודה

כדי לשלוח נתוני אירועים באמצעות Data Manager API:

  1. הכנת היעדים: מגדירים את האובייקטים של Destination בשדה destinations של בקשת ההטמעה כדי לציין את חשבון היעד ואת יעד ההמרה או האירוע. פרטים נוספים על הכנת יעדים

  2. הכנת נתוני האירועים והמזהים: מאכלסים את השדות של Event בפרטי האירועים ובמזהים הנדרשים (כמו מזהים של קליקים על מודעות, לקוחות או מופעי אפליקציות). אם אתם כוללים פרטים ליצירת קשר עם המשתמשים ב-userData, אתם צריכים לנרמל את המזהים ולגבב אותם באמצעות SHA-256 בהתאם להנחיות הפורמט, ואתם יכולים גם להצפין אותם. פרטים נוספים מופיעים במאמר בנושא הכנת נתוני אירועים.

  3. יוצרים ושולחים את בקשת ההטמעה: שולחים בקשת events.ingest שמכילה את destinations, את רשומות Event ואת encryptionInfo אם הצפנתם את userData. מומלץ להשתמש ב-validateOnly: true כדי לבדוק את מטען הנתונים שלכם לאיתור שגיאות שגורמות לביטול מהיר של העיבוד לפני ששולחים נתוני ייצור. בקטע שליחת אירועים מפורטות דרישות השדות ודוגמאות קוד.

  4. בדיקת דוח האבחון: מאחזרים את דוח האבחון של העיבוד האסינכרוני ובודקים את סטטוס ההטמעה באמצעות requestStatus.retrieve.

תרחישים לדוגמה

הנה כמה תרחישי שימוש לשליחת אירועים מומלצים ומותאמים אישית באמצעות Data Manager API:

  • קישור בין התנהגות אונליין להתנהגות אופליין.

  • למדוד אינטראקציות בצד הלקוח ובצד השרת

  • לשלוח אירועים שמתרחשים מחוץ לאינטראקציה הרגילה של המשתמש, כמו המרות אופליין.

  • שליחת אירועים ממכשירים ומאפליקציות שבהם אי אפשר להפעיל איסוף אוטומטי, כמו קיוסקים ושעונים.

פרטים שהמשתמשים סיפקו

אתם יכולים לשלוח נתוני לקוחות מאינטראקציה ישירה, כמו כתובות אימייל מגובבות, מספרי טלפון וכתובות פיזיות, בשדה userData של Event. כך אפשר לשפר את מעקב ההמרות, השיוך (Attribution) ויצירת הקהלים ב-Google Analytics.

כששולחים פרטים שהמשתמשים סיפקו, חשוב לזכור את הנקודות הבאות:

  • נשלחים עם אירועים: ב-Data Manager API, פרטים שהמשתמשים סיפקו צריכים להישלח כחלק מ-Event. העלאות עצמאיות ללא אירוע לא נתמכות.

  • פורמט וגיבוב: לפני שמעלים מזהים אישיים (כמו כתובת אימייל, מספר טלפון, שם וכתובת פיזית), צריך לנרמל ולגבב אותם באמצעות SHA-256. שדות אחרים (כמו עיר, מדינה או מחוז, מיקוד וקוד מדינה) עוברים נרמול אבל לא גיבוב. כדי לעמוד בדרישות הספציפיות, צריך לפעול לפי ההנחיות במדריך הגדרת הפורמט של נתוני המשתמשים.

  • הצפנה: אתם יכולים להצפין את נתוני המשתמשים המגובבים.

  • ‫User-ID: מומלץ לספק את userId לצד userData בכל פעם שיש מזהה משתמש עקבי.

  • הטמעה: במאמר הוספת פרטים שהמשתמשים סיפקו מוסבר איך ליצור בקשות.

שיקולים לגבי שילוב

כשמשתמשים ב-Data Manager API, חשוב לזכור את הנקודות הבאות.

רימרקטינג

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

בנוסף, אתם יכולים לשלוח פרטים שהמשתמשים סיפקו כדי לאפשר התאמה לקהלים מאינטראקציה ישירה.

מזהי פרסום

מערכת Google Analytics משלבת באופן אוטומטי מזהי פרסום (כמו GBRAID או WBRAID) שנאספים במהלך אינטראקציות אונליין עם אירועים של Data Manager API באמצעות clientId או appInstanceId.

הגדרות פרטיות

מערכת Google Analytics מצטרפת לאירועים של Data Manager API עם אינטראקציות אונליין באמצעות clientId או appInstanceId כדי לאמץ את הגדרות הפרטיות של המשתמשים, כמו 'מודעות בלי התאמה אישית' ו'הגבלת מעקב אחרי ביצועים של מודעות'.

אתם יכולים גם לציין את הגדרות ההסכמה מהמשתמש ישירות בכל אירוע באמצעות האובייקט consent.

מידע גיאוגרפי ומידע על המכשיר

מערכת Google Analytics מצטרפת באופן אוטומטי לנתונים הגיאוגרפיים ולנתוני המכשיר העדכניים ביותר מתיוג עם אירועים של Data Manager API באמצעות clientId או appInstanceId. כך האירועים של Data Manager API יופיעו בדוחות שכוללים מאפיינים גיאוגרפיים ומאפייני מכשירים.

אם אתם רוצים שאירוע ב-Data Manager API ישקף מידע גיאוגרפי ומידע על מכשירים מסשן ספציפי במקום המידע העדכני ביותר לגבי clientId או appInstanceId, צריך לכלול רשומה ב-additionalEventParameters עם parameterName שמוגדר כ-session_id ו-value שמוגדר כמזהה של הסשן הספציפי, ולשלוח את האירוע תוך 24 שעות מתחילת הסשן.

אתם יכולים לספק מידע גיאוגרפי ומידע על המכשיר לאירועים באמצעות Data Manager API.

שרת-אל-שרת מלא

אפשר לשלוח אירועים ל-Google Analytics רק באמצעות Data Manager API, אבל יכול להיות שיהיו זמינים רק דוחות חלקיים. המטרה של Data Manager API היא להוסיף נתונים לאירועים קיימים שנאספו באמצעות gtag, ‏Tag Manager או Firebase. חלק מהשמות של האירועים והפרמטרים שמורים לשימוש באמצעות איסוף אוטומטי, ואי אפשר לשלוח אותם דרך Data Manager API.

יצירה או שינוי של שמות אירועים

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

הבא
שליחת אירועים