מדידת קמפיינים – iOS SDK

במסמך הזה מפורטת סקירה כללית של מדידת קמפיינים ומקורות תנועה באמצעות Google Analytics SDK ל-iOS v3.

סקירה

מדידה של קמפיינים ב-Google Analytics מאפשרת לשייך קמפיינים ומקורות תנועה לפעילות המשתמשים באפליקציה שלך. האפשרויות הבאות זמינות לשיוך של קמפיינים ומקורות תנועה ב-Google Analytics SDK ל-iOS:

מדידת קמפיינים להתקנת אפליקציות ב-iOS - אפשר לראות אילו קמפיינים מאפליקציות אחרות מפנים משתמשים ל-iTunes כדי להוריד את האפליקציה שלך ל-iOS.
שיוך כללי של קמפיינים ומקורות תנועה - אפשר לראות אילו קמפיינים או גורמים מפנים מפעילים את האפליקציה אחרי ההתקנה שלה.

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

פרמטרים בקמפיינים

פרמטרים של קמפיינים משמשים להעברת מידע על מקורות התנועה ועל הקמפיינים שמביאים משתמשים לאפליקציה שלך.

הטבלה הבאה מכילה את הפרמטרים הזמינים של קמפיין, שניתן להשתמש בהם במדידה כללית של הקמפיין:

פרמטר	תיאור	דוגמאות
`utm_campaign`	שם הקמפיין; משמש לניתוח של מילות מפתח כדי לזהות קידום מכירות של מוצר ספציפי או קמפיין אסטרטגי	`utm_campaign=spring_sale`
`utm_source`	מקור הקמפיין; משמש לזיהוי מנוע חיפוש, ניוזלטר או מקור אחר	`utm_source=google`
`utm_medium`	אמצעי ההגעה לאתר בקמפיין; משמש לזיהוי אמצעי הגעה לאתר, כמו אימייל או עלות לקליק (CPC)	`utm_medium=cpc`
`utm_term`	מונח של קמפיין; משמש לחיפוש בתשלום כדי לספק את מילות המפתח למודעות	`utm_term=running+shoes`
`utm_content`	תוכן הקמפיין. משמש לבדיקות A/B ולמודעות שמטורגטות לפי תוכן כדי להבדיל בין מודעות או קישורים שמפנים לאותה כתובת URL	`utm_content=logolink` `utm_content=textlink`
`gclid`	פרמטר התיוג האוטומטי של Google Ads; משמש למדידת מודעות. הערך הזה נוצר באופן דינמי ואין לשנות אותו אף פעם.

שיוך כללי של קמפיינים ומקורות תנועה

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

הדרך הקלה ביותר לשלוח נתוני קמפיינים היא באמצעות [GAIDictionaryBuilder setCampaignParametersFromUrl:urlString]. urlString הוא מחרוזת שמייצגת כתובת URL שעשויה להכיל פרמטרים של קמפיין ב-Google Analytics. שימו לב שבדוגמאות הבאות, נתוני הקמפיין לא מוגדרים ישירות בכלי המעקב, כי יש לשלוח אותם רק פעם אחת:

/*
 * MyAppDelegate.m
 *
 * An example of how to implement campaign and referral attribution.
 * If no Google Analytics campaign parameters are set in the referring URL,
 * use the hostname as a referrer instead.
 */

// For iOS 9.0 and later
- (BOOL)application:(UIApplication *)app openURL:(nonnull NSURL *)url
            options:(nonnull NSDictionary<NSString *,id> *)options {

// For iOS versions prior to 9.0
//- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url
//  sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {

  NSString *urlString = [url absoluteString];

  id<GAITracker> tracker = [[GAI sharedInstance] trackerWithName:@"tracker"
                                                      trackingId:@"UA-XXXX-Y"];

  // setCampaignParametersFromUrl: parses Google Analytics campaign ("UTM")
  // parameters from a string url into a Map that can be set on a Tracker.
  GAIDictionaryBuilder *hitParams = [[GAIDictionaryBuilder alloc] init];

  // Set campaign data on the map, not the tracker directly because it only
  // needs to be sent once.
  [hitParams setCampaignParametersFromUrl:urlString];

  // Campaign source is the only required campaign field. If previous call
  // did not set a campaign source, use the hostname as a referrer instead.
  if(![hitParams get:kGAICampaignSource] && [url host].length !=0) {
    // Set campaign data on the map, not the tracker.
    [hitParams set:@"referrer" forKey:kGAICampaignMedium];
    [hitParams set:[url host] forKey:kGAICampaignSource];
  }

  NSDictionary *hitParamsDict = [hitParams build];

  // A screen name is required for a screen view.
  [tracker set:kGAIScreenName value:@"screen name"];

  // Previous V3 SDK versions.
  // [tracker send:[[[GAIDictionaryBuilder createAppView] setAll:hitParamsDict] build]];

  // SDK Version 3.08 and up.
  [tracker send:[[[GAIDictionaryBuilder createScreenView] setAll:hitParamsDict] build]];

לחלופין, אם יש לכם פרטי קמפיין בפורמט שאינו פרמטרים של קמפיין ב-Google Analytics, אפשר להגדיר אותם בפורמט NSDictionary ולשלוח אותם באופן ידני:

// Assumes at least one tracker has already been initialized.
id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];

// Note that it's not necessary to set kGAICampaignKeyword for this email campaign.
NSDictionary *campaignData = [NSDictionary dictionaryWithObjectsAndKeys:
    @"email", kGAICampaignSource,
    @"email_marketing", kGAICampaignMedium,
    @"summer_campaign", kGAICampaignName,
    @"email_variation1", kGAICampaignContent, nil];

// A screen name is required for a screen view.
[tracker set:kGAIScreenName value:@"screen name"];

// Note that the campaign data is set on the Dictionary, not the tracker.
// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] setAll:campaignData] build]];

// SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] setAll:campaignData] build]];

מדידה של קמפיין להתקנות ב-iOS

Google Analytics כולל תמיכה מובנית במדידת קמפיינים להתקנות ב-iOS ברשתות פופולריות, וניתן ליצור כתובות אתרים מותאמות אישית לכל רשת נוספת.

על מנת להפעיל מדידת קמפיינים להתקנת אפליקציות ב-iOS, ניתן להשתמש בכלי ליצירת כתובות URL למעקב אחר קמפיינים ב-iOS שבהמשך כדי ליצור כתובות יעד למודעות שמפנות את המשתמשים ל-App Store. כדי שמעקב אחר קמפיינים ב-iOS יפעל, עליכם להטמיע את Google Analytics באפליקציה ל-iOS, להפעיל את איסוף ה-IDFA ולעקוב אחרי אירוע אחד או יותר או צפייה במסך אחת או יותר באפליקציה. תצטרכו להוסיף לאפליקציה מסגרת נוספת אם תרצו להשתמש ב מדידה אוטומטית של קמפיינים להתקנת iAd.

אבחון בניהול עצמי למעקב המרות ב-iOS

אם אתם לא רואים המרות של קמפיינים ל-iOS, בצעו את השלבים הבאים כדי לפתור את הבעיה:

איך לוודא שהמעקב אחר קמפיינים ל-iOS מופעל
איך מוודאים שמזהה האפליקציה תואם
איך מוודאים שה-IDFA נשלח על ידי Google Analytics SDK
עיון בדוח הדמוגרפיה כדי לוודא שה-IDFA נשלח
מוודאים שכתובות ה-URL למעקב בקמפיינים ל-iOS נכונות

שלב 1: מוודאים שהמעקב אחר קמפיינים ל-iOS מופעל

כדי לוודא שהמעקב אחר קמפיינים ב-iOS מופעל בנכס היעד:

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

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

שלב 2: מוודאים שמזהה האפליקציה תואם

כדי לשייך בצורה נכונה קמפיין עם נתוני אפליקציה, כתובת ה-URL למעקב אחרי קמפיין ל-iOS וההטמעה של מעקב אחר אפליקציות צריכה להשתמש באותו מזהה אפליקציה. כדי לזהות את App ID של אפליקציה שאחריה אתם עוקבים כרגע, צרו דוח מותאם אישית בממשק האינטרנט של Google Analytics, עם מזהה אפליקציה כמאפיין ו סשנים כמדד.

כשיוצרים קליק כתובת URL למעקב אחר קמפיין ל-iOS, צריך להשתמש במזהה האפליקציה שמופיע בדוח בהתאמה אישית.

יצירת דוח בהתאמה אישית

שלב 3: מוודאים שה-SDK של Google Analytics שולח את ה-IDFA

Google Analytics משתמש ב-Identifier for Advertiser (IDFA) בתור אחד מהמפתחות לצירוף קליקים בנייד להיטים של Google Analytics. עליכם לוודא ש:

האפליקציה שלך משתמשת ב-Google Analytics SDK ל-iOS גרסה 3.10 או גבוהה יותר.
אם משתמשים בהורדת ה-SDK העצמאי:
- האפליקציה שלך מקושרת אל libAdIdAccess.a כחלק מגרסת Google Analytics ל-iOS.
- האפליקציה שלך מקושרת אל AdSupport.framework.
אם משתמשים ב-CocoaPods כדי להתקין ולנהל יחסי תלות, צריך להוסיף את GoogleIDFASupport Cocoapod לקובץ ה-Podfile:
```
pod 'GoogleIDFASupport'
```
הפעלת את איסוף ה-IDFA בכל מכשיר מעקב:
```
tracker.allowIDFACollection = YES;
```
אם אפשר, כדאי להשתמש באפליקציה לשרת proxy לניפוי באגים כדי להציג בקשות HTTP ולוודא שה-IDFA נכלל.

שלב 4: עיינו בדוח הדמוגרפיה כדי לוודא שה-IDFA נשלח

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

דוח בהתאמה אישית

שלב 5: מוודאים שכתובות ה-URL למעקב אחר קמפיין ל-iOS נכונות

בעזרת הכלי ליצירת כתובות URL למעקב אחר קמפיינים ל-iOS מוודאים שכתובות ה-URL למעקב אחרי קמפיינים ל-iOS נכונות.

כשבוחרים באפשרות Custom לרשת המודעות, חשוב להתייעץ עם הרשת הזו כדי לוודא שהיא תומכת במעקב אחר מזהי מכשירים ספציפיים באמצעות כתובות URL להפניה אוטומטית. אם היא לא תכיל, לא תראו נתונים בדיווח של Google Analytics.

הכלי ליצירת כתובות URL למעקב אחר קמפיינים ל-iOS

אפשר להשתמש בכלי שלמטה כדי ליצור כתובות URL למדידת המקור של התקנות של אפליקציות ל-iOS.

חשוב: כתובות ה-URL למעקב של Google AdMob מחייבות פרמטר &hash=md5. הכלי ליצירת כתובות URL ל-iOS מוסיף את הפרמטר הזה באופן אוטומטי. אם יוצרים את כתובות ה-URL באופן ידני, צריך להוסיף את הפרמטר הזה כדי שהמעקב אחרי ההתקנות של AdMob ב-iOS יפעל בצורה תקינה. אם בוחרים רשתות מודעות אחרות מלבד AdMob, לא נדרש הפרמטר &hash=md5.