משתמשים ב-Data Manager API כדי לשלוח אירועים מומלצים ואירועים מותאמים אישית של Google Analytics.
פרטים נוספים מופיעים במאמר בנושא שליחת אירועים.
אם אתם משדרגים מ-Google Analytics Measurement Protocol, תוכלו לקרוא את ההוראות במאמר שדרוג מ-Measurement Protocol ל-Data Manager API.
תרחישים לדוגמה
הנה כמה תרחישי שימוש לשליחת אירועים מומלצים ומותאמים אישית באמצעות Data Manager API:
קישור בין התנהגות אונליין להתנהגות אופליין.
למדוד אינטראקציות בצד הלקוח ובצד השרת
לשלוח אירועים שמתרחשים מחוץ לאינטראקציה הרגילה של המשתמש, כמו המרות אופליין.
שליחת אירועים ממכשירים ומאפליקציות שבהם אי אפשר להפעיל איסוף אוטומטי, כמו קיוסקים ושעונים.
פרטים שהמשתמשים סיפקו
אתם יכולים לשלוח נתוני לקוחות מאינטראקציה ישירה (First-Party), כמו כתובות אימייל מגובבות, מספרי טלפון וכתובות פיזיות, בשדה userData של Event. השימוש בפתרון הזה עוזר לשפר את מעקב ההמרות, השיוך (Attribution) ויצירת הקהלים ב-Google Analytics.
כששולחים פרטים שהמשתמשים סיפקו, חשוב לזכור את הנקודות הבאות:
נשלחים עם אירועים: ב-Data Manager API, פרטים שהמשתמשים סיפקו צריכים להישלח כחלק מ-
Event. העלאות עצמאיות ללא אירוע לא נתמכות.פורמט וגיבוב: לפני ההעלאה, צריך לנרמל ולגבב מזהים אישיים (כמו כתובת אימייל, מספר טלפון, שם וכתובת) באמצעות SHA-256. שדות אחרים (כמו עיר, מדינה או מחוז, מיקוד וקוד מדינה) עוברים נרמול אבל לא גיבוב. כדי לעמוד בדרישות הספציפיות, צריך לפעול לפי המדריך בנושא פורמט נתוני משתמשים.
הצפנה: אתם יכולים להצפין את נתוני המשתמשים המגובבים.
מזהה משתמש: מומלץ לספק את
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.