איך מגדירים איסוף נתונים ושימוש בהם ב-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 לחשבון פרסום או הפעלתם שילוב מודעות באופן אחר, או הבעתם הסכמה לשיתוף נתונים, יכול להיות שנתוני 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, יכול להיות שיחלפו כמה דקות עד שהם יפורסמו באפליקציה. אם האפליקציה זמינה, תהליך הפריסה המלא עשוי להימשך עד שעה.