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

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