איך מגדירים איסוף נתונים ושימוש בהם ב-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 (מזהה הספק) באפליקציית אפל, צריך להגדיר את הערך של GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED ל-NO (בוליאני) בקובץ Info.plist של האפליקציה.

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

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

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

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

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

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

כדי להשבית כברירת מחדל את ההתנהגות של פרסום בהתאמה אישית, צריך להגדיר את הערך של GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS ל-NO (Boolean) בקובץ 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, יכול להיות שיחלפו כמה דקות עד שהם יוטמעו באפליקציה. אם האפליקציה פעילה, תהליך ההטמעה המלא עשוי להימשך עד שעה.