המדריך למפתחים הזה מדגים איך להטמיע מזהה משתמש באמצעות Google Analytics SDK ל-Android v3.x.
סקירה
התכונה User ID מאפשרת למדוד ב-Google Analytics פעילויות שונות של משתמשים במכשירים שונים. למשל, שיוך אינטראקציה עם קמפיין שיווק במכשיר נייד אחד להמרה שמתרחשת במכשיר נייד אחר או בדפדפן.
כאשר מזהי User-ID נשלחים עם היטים של Google Analytics באמצעות השדה userId, הדוחות
ישקפו ספירה מדויקת יותר של משתמשים ייחודיים ויספקו אפשרויות דיווח חדשות על פעולות במכשירים שונים.
מידע נוסף על היתרונות של השימוש ב-User ID.
במדריך הזה מוסבר איך להשתמש בשדה userId וב-Google Analytics SDK ל-Android כדי לשלוח מזהי משתמשים ל-Google Analytics.
דרישות מוקדמות
לפני ששולחים את ה-User ID אל Google Analytics:
- מגדירים את User-ID.
- קוראים את המדיניות בנושא User ID.
- בחומר העזר בנושא תכונות של User ID מוסבר איך פועלת התכונה User ID.
הטמעה
כשמשתמש רשום במערכת של אפליקציית Android שלך, עליך לשלוח באמצעות השדה userId מזהה שמייצג
את המשתמש הזה עם כל ההיטים של Google Analytics, כמו צפיות בדף, אירועים, פירוט עסקאות וכו'.
כדי לשלוח את ה-User ID, מגדירים את השדה userId באמצעות
תחביר אמפרסנד (&) של Measurement Protocol ואת שם הפרמטר
Fields.USER_ID, כמו בדוגמה הבאה:
/**
* An example method called when a user signs in to an authentication system.
*
* @param User user represents a generic User object returned by an authentication system on sign in.
*/
public void onUserSignIn(User user) {
Tracker t = GoogleAnalytics.getInstance(context).getTracker("UA-XXXX-Y");
// You only need to set User ID on a tracker once. By setting it on the tracker, the ID will be
// sent with all subsequent hits.
t.set(Fields.USER_ID, user.getId());
// This hit will be sent with the User ID value and be visible in User-ID-enabled views (profiles).
t.send(MapBuilder
.createEvent("UX", // Event category (required)
"Sign In", // Event action (required)
null, // Event label
null) // Event value
.build()
);
}