אירועים מומלצים ואירועים מותאמים אישית ב-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 כדי לבדוק את המטען הייעודי (payload) שלכם לאיתור שגיאות מסוג fast-fail לפני ששולחים נתוני ייצור. בקטע שליחת אירועים מפורטות דרישות השדות ודוגמאות קוד.

  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.

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