אתם יכולים להשתמש ב-Data Manager API כדי לשלוח אירועים מומלצים ואירועים מותאמים אישית ב-Google Analytics.
שליחת אירועים מומלצים ואירועים בהתאמה אישית
אם אתם משדרגים מ-Google Analytics Measurement Protocol, אתם יכולים לקרוא את ההוראות במאמר שדרוג מ-Measurement Protocol ל-Data Manager API.
סקירה כללית של תהליך העבודה
כדי לשלוח נתוני אירועים באמצעות Data Manager API:
הכנת היעדים: מגדירים את האובייקטים של
Destinationבשדהdestinationsשל בקשת ההטמעה כדי לציין את חשבון היעד ואת יעד ההמרה או האירוע. פרטים נוספים זמינים במאמר הכנת יעדים.הכנת נתוני אירועים ומזהים: יוצרים כל
Eventוכוללים את כל השדות והמזהים הנדרשים. מנרמלים ומגבבים באמצעות SHA-256 את פרטי הקשר של המשתמשים ב-userDataבהתאם להנחיות הפורמט, ואם רוצים, מצפינים אותם. פרטים נוספים זמינים במאמר הכנת נתוני אירועים.יוצרים ושולחים את בקשת ההטמעה: שולחים בקשת
events.ingestשמכילה את ה-destinations, רשומותEventו-encryptionInfoאם הצפנתם אתuserData. כדאי להשתמש ב-validateOnly: trueכדי לבדוק את המטען הייעודי (payload) שלכם לאיתור שגיאות מסוג fast-fail לפני שאתם שולחים נתוני ייצור. בקטע שליחת אירועים מפורטות דרישות השדות ודוגמאות קוד.בדיקת סטטוס הבקשה והאבחון: בודקים את סטטוס העיבוד האסינכרוני ובוחנים את האבחון באמצעות
requestStatus.retrieve.
תרחישים לדוגמה
הנה כמה תרחישים לדוגמה שבהם אפשר לשלוח אירועים מומלצים ואירועים בהתאמה אישית באמצעות Data Manager API:
קישור בין התנהגות אונליין להתנהגות אופליין.
למדוד אינטראקציות בצד הלקוח ובצד השרת
לשלוח אירועים שמתרחשים מחוץ לאינטראקציה הרגילה של המשתמש, כמו המרות אופליין.
לשלוח אירועים ממכשירים ומאפליקציות שבהם איסוף אוטומטי לא זמין, כמו קיוסקים ושעונים.
פרטים שהמשתמשים סיפקו
אתם יכולים לשלוח נתוני לקוחות מאינטראקציה ישירה, כמו כתובות אימייל, מספרי טלפון וכתובות פיזיות שעברו גיבוב, בשדה 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.