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

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