איך מגדירים איסוף נתונים ושימוש בהם ב-Analytics

בחירת פלטפורמה: iOS+ Android


בדף הזה מתוארות התכונות של Google Analytics שמאפשרות לכם לשלוט באיסוף הנתונים של Analytics ובשימוש בהם.

השבתת איסוף הנתונים של Analytics

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

השבתה זמנית של האיסוף

אם רוצים להשבית באופן זמני את האיסוף של Analytics, למשל כדי לקבל הסכמה ממשתמש הקצה לפני איסוף הנתונים, אפשר להגדיר את הערך של FIREBASE_ANALYTICS_COLLECTION_ENABLED ל-NO (בוליאני) בקובץ Info.plist של האפליקציה. לדוגמה, כך זה נראה ב-XML של המקור:

<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key><false/>

כדי להפעיל מחדש את האיסוף, למשל אחרי שמשתמש קצה נותן הסכמה, צריך להפעיל את השיטה setAnalyticsCollectionEnabled של המכונה Analytics. לדוגמה:

Swift

הערה: מוצר Firebase הזה לא זמין ביעד watchOS. 
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

הערה: מוצר Firebase הזה לא זמין ביעד watchOS. 
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

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

Swift

הערה: מוצר Firebase הזה לא זמין ביעד watchOS. 
Analytics.setAnalyticsCollectionEnabled(false)

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

הערך שמוגדר באמצעות השיטה setAnalyticsCollectionEnabled נשמר בכל ההפעלות של האפליקציה ומבטל את הערך של FIREBASE_ANALYTICS_COLLECTION_ENABLED בקובץ Info.plist של האפליקציה. אחרי שמגדירים ערך ל-setAnalyticsCollectionEnabled, איסוף הנתונים ב-Analytics נשאר במצב הזה עד שקוראים שוב ל-setAnalyticsCollectionEnabled, גם אם המשתמש סוגר את האפליקציה ופותח אותה מחדש.

השבתה סופית של האיסוף

אם אתם צריכים להשבית את איסוף הנתונים של Analytics באופן סופי בגרסה של האפליקציה, הגדירו את FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED כ-YES (בוליאני) בקובץ Info.plist של האפליקציה. הגדרה של FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED לערך YES (בוליאני) מקבלת עדיפות על פני כל הערכים של FIREBASE_ANALYTICS_COLLECTION_ENABLED בקובץ Info.plist של האפליקציה, וגם על פני כל הערכים שהוגדרו באמצעות setAnalyticsCollectionEnabled.

כדי להפעיל מחדש את האיסוף, צריך להסיר את FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED מה-Info.plist. אם מגדירים את FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED כ-NO (בוליאני), אין לזה השפעה וההתנהגות זהה למצב שבו FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED לא מוגדר בקובץ Info.plist.

השבתת האיסוף של IDFA

אם התקנתם את המודול FirebaseAnalytics באפליקציה דרך SPM או CocoaPods ואתם רוצים להשבית את איסוף ה-IDFA (מזהה הפרסום של המכשיר) באפליקציה ל-Apple, ודאו שמסגרת AdSupport לא כלולה באפליקציה.

כדי להתקין את Firebase בלי יכולת לאסוף IDFA, משתמשים בקוד הבא במקום ביחסי התלות של FirebaseAnalytics:

Swift Package Manager

  .target(
    name: "MyTargetName",
    dependencies: [
      .product(name: "FirebaseAnalyticsCore", package: "Firebase"),
      // ...
    ]
  ),

CocoaPods

pod 'FirebaseAnalytics/Core'

מידע נוסף על IDFA זמין במסמכי התיעוד של Apple:

השבתת האיסוף של נתוני IDFV

כדי להשבית את האיסוף של IDFV (מזהה לספק) באפליקציה ל-Apple, צריך להגדיר את הערך של GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED כ-NO (בוליאני) בקובץ Info.plist של האפליקציה.

איך שולטים באיסוף הנתונים לצורך פרסום מותאם אישית

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

אתם יכולים לקבוע באופן פרוגרמטי אם נתוני Analytics של משתמש ישמשו לפרסום מותאם אישית באמצעות אחת מהאפשרויות הבאות:

השבתת תכונות של פרסום מותאם אישית באמצעות מאפיין משתמש

ה-API להפעלת סטטוס הסכמה של Google הוא הדרך המומלצת להפעיל ולהשבית פרסום מותאם אישית.

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

כדי להשבית את ההתנהגות של פרסום מותאם אישית כברירת מחדל, צריך להגדיר את הערך של GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS ל-NO (בוליאני) בקובץ Info.plist של האפליקציה.

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

אם אתם משתמשים בפרמטר AnalyticsUserPropertyAllowAdPersonalizationSignals כדי לשלוט בהתאמה האישית של המודעות, אתם יכולים להפעיל מחדש את ההתאמה האישית של המודעות באמצעות השיטה setUserProperty, כמו שמוצג בהמשך:

Swift

הערה: מוצר Firebase הזה לא זמין ביעד watchOS. 
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Objective-C

הערה: מוצר Firebase הזה לא זמין ביעד watchOS. 
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);

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

Swift

הערה: מוצר Firebase הזה לא זמין ביעד watchOS. 
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

הערה: מוצר Firebase הזה לא זמין ביעד watchOS. 
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

אישור ההגדרות

כשמשביתים את האותות להתאמה אישית של מודעות עבור משתמש מסוים באמצעות אחד מהמנגנונים שהוגדרו למעלה, חבילות האירועים הבאות שיתועדו מהמכשיר של המשתמש יכילו מאפיין משתמש בשם non_personalized_ads עם הערך 1, כדי לציין שהאירועים בחבילה הזו לא זמינים לפרסום מותאם אישית. השבתת הפרסום המותאם אישית לא משפיעה על השימוש בנתונים למטרות מדידה, כולל דיווח ושיוך (Attribution).

איך רואים את השינויים בהגדרות

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