איך מגדירים איסוף נתונים ושימוש בהם ב-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. לדוגמה:

Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

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

Analytics.setAnalyticsCollectionEnabled(false)

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

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

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

כדי להתקין את Firebase בלי יכולת לאיסוף IDFA, צריך להשתמש ב-subspec הבא במקום ב-pod 'Firebase/Analytics':

pod 'Firebase/AnalyticsWithoutAdIdSupport'

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

• פרטיות המשתמשים והשימוש בנתונים
• שקיפות לגבי המעקב אחר אפליקציות

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

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

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

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

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

• מומלץ: מפעילים או משביתים באופן דינמי את ההתאמה האישית של המודעות בהתאם לבחירת ההסכמה של המשתמש. מטמיעים את consent mode API של Google.

• להפעיל או להשבית התאמה אישית של מודעות ברמת המשתמש: שליטה בהתאמה אישית של מודעות כמאפיין משתמש.

• מפעילים או משביתים את ההתאמה האישית של המודעות ברמת נכס Analytics: משביתים את ההתאמה האישית של המודעות לפי אזור גיאוגרפי בנכס Analytics.

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

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

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

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

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

Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

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

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

Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

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

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

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

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

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