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



בדף הזה מתוארות התכונות שזמינות ב-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 הזה לא זמין ביעד macOS. 
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

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

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

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

Swift

הערה: מוצר Firebase הזה לא זמין ביעד macOS. 
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 (Boolean) לא משפיעה על ההתנהגות של Chrome, והתוצאה זהה למצב שבו FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED לא מוגדר בקובץ Info.plist.

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

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

כדי להתקין את Firebase ללא אפשרות לאיסוף IDFA, צריך להשתמש במפרט המשנה הבא במקום pod 'FirebaseAnalytics':

pod 'FirebaseAnalytics/Core'

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

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

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

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

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

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

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

Google's consent mode API היא הדרך המומלצת להפעלה ולהשבתה של פרסום מותאם אישית.

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

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

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

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

Swift

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

Objective-C

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

Unity

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

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

Swift

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

Objective-C

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

Unity

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

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

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

הצגת שינויים בהגדרות

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