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

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

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