שליחה – iOS SDK

במאמר הזה נסביר איך לנהל את שליחת הנתונים ל-Google Analytics באמצעות Google Analytics SDK ל-iOS v2.

סקירה

ב-Google Analytics SDK ל-iOS, נתונים שנאספים כמו צפיות במסך או אירועים נשמרים באופן מקומי בתור, לפני שהם נשלחים לשרתים של Google Analytics. התהליך שבו קטעי הנתונים האלה (שנקראים כאן 'היטים') נשלחים מה-SDK ל-Google Analytics, נקרא שליחה.

השליחה היא ייחודית לספריות האוספים לנייד, ונועדה להקל על האתגרים של גישה לא אמינה לרשת וחיי סוללה מוגבלים.

יש שני סוגים של שילוח:

  • שליחה תקופתית – שליחת היטים באופן אוטומטי במרווחי זמן קבועים שציינתם.
  • שליחה ידנית – שלח היטים באופן ידני כדי לשלוח נתונים כשנוח לך, לדוגמה כשיש חיבור HTTP קיים.

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

שליחה תקופתית

כשהאפליקציה אוספת נתוני GA, הנתונים האלה מתווספים לרשימת 'הבאים בתור' ונשלחים מדי פעם ל-Google Analytics. שליחה תקופתית יכולה להתרחש גם כשהאפליקציה פועלת בחזית או ברקע.

זמן ברירת המחדל לשליחה הוא 2 דקות. ניתן לך להוסיף מרווח זמן משלך בשניות על ידי קריאה ל-setDispatchPeriod:(NSTimeInterval), כמו בדוגמה הבאה:

[[GAI sharedInstance] setDispatchPeriod:60];

הגדרת ערך שלילי תשבית את השליחה התקופתית, מה שיחייב להשתמש בשליחה ידנית אם תרצו לשלוח נתונים ל-Google Analytics. מצד שני, אם מגדירים את הערך 0, כל התאמה תישלח באופן מיידי אם יש חיבור לרשת.

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

אם משתמש מאבד את הגישה לרשת או סוגר את האפליקציה בזמן שעדיין יש היטים שממתינים לשליחה, האותות האלה נשמרים באחסון המקומי. הם יישלחו בפעם הבאה שהאפליקציה תפעל ובפעם הבאה שתתבצע קריאה.

שליחה ידנית

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

ניתן לשלוח התאמות באופן ידני על ידי קריאה ל-dispatch כפי שמתואר בהמשך:

[[GAI sharedTracker] dispatch];