הדף הזה מיועד למפתחים שמשתמשים ב-Google Analytics for Firebase SDK באפליקציה שלהם ורוצים לשלב את סטטוס ההסכמה. לקבלת מבוא לסטטוס ההסכמה, כדאי לקרוא את הסקירה הכללית על סטטוס ההסכמה.
ב-Google Analytics יש סטטוס הסכמה שמאפשר לשנות את אופן הפעולה של ה-SDK בהתאם לסטטוס ההסכמה של המשתמשים. אפשר להטמיע את סטטוס ההסכמה באופן בסיסי או מתקדם. לא בטוחים אם להטמיע את סטטוס ההסכמה הבסיסי או המתקדם
לפני שמתחילים
כדי לנהל את הסכמת המשתמשים, צריך להטמיע את:
- Google Analytics for Firebase SDK
באנר של הגדרות הסכמה כדי לתעד את הסכמת המשתמש
הגדרה של סטטוס הסכמה
כדי להגדיר סטטוס הסכמה:
הגדרת מצב ההסכמה שמוגדר כברירת מחדל
כברירת מחדל, לא מוגדרים ערכים לסטטוס הסכמה. כדי להגדיר את מצב ההסכמה שמוגדר כברירת מחדל באפליקציה:
- פתחו את הקובץ info.plist של האפליקציה.
מוסיפים את צמדי המפתח/ערך של סטטוס ההסכמה. המפתח מתאר את סוג ההסכמה והערך מציין את מצב ההסכמה. הערכים יכולים להיות
true
, כלומר, ההסכמה אושרה, אוfalse
. המשמעות היא שההסכמה נדחתה. מגדירים את ההגדרות הבאות:GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE
GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE
GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA
GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS
שומרים את השינויים. בשלב הבא, צריך להטמיע את המנגנון לעדכון ערכי ההסכמה.
לדוגמה, כדי להגדיר כברירת מחדל את כל אישורי ההסכמה לכל הפרמטרים:
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>
עדכון ההסכמה
כדי לעדכן את ערכי ההסכמה אחרי השקת האפליקציה, צריך לבצע קריאה ל-method setConsent
.
הערך שנקבע בשיטה setConsent
מבטל את הגדרת ברירת המחדל וממשיך לפעול בכל ההפעלות של האפליקציה. הערך יישאר במצב הזה עד שתתבצע קריאה שוב ל-setConsent
, גם אם המשתמש סוגר את האפליקציה ופתח אותה מחדש.
הפרמטר setConsent
מעדכן רק את הפרמטרים שצוינו.
אם משתמש מבטל את ההסכמה שנתנו בעבר ל-Analytics או לאחסון מודעות, מערכת Google Analytics מוחקת את כל מאפייני המשתמשים, כולל ההסכמה ל-
ad_personalization
. כדי לשמר את אפשרות ההסכמה של המשתמש להתאמה אישית של מודעות, צריך לשחזר את הערך הקודם של ההתאמה האישית של המודעות באמצעותsetConsent
(Swift | Obj-C) .
בדוגמה הבאה מוצגת השיטה setConsent
שמעדכנת את ערכי ההסכמה השונים ל-granted
:
Swift
Analytics.setConsent([
.analyticsStorage: .granted,
.adStorage: .granted,
.adUserData: .granted,
.adPersonalization: .granted,
])
Objective-C
[FIRAnalytics setConsent:@{
FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
FIRConsentTypeAdStorage : FIRConsentStatusGranted,
FIRConsentTypeAdUserData : FIRConsentStatusGranted,
FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];
אם המשתמש מחליט לבטל את ההסכמה, חשוב לעדכן את הצהרות ההסכמה בהתאם
שדרוג לגרסה 2 של סטטוס ההסכמה
כחלק מהמחויבות המתמשכת של Google לסביבה עסקית של פרסום בדיגיטל ללא פגיעה בפרטיות, אנחנו מגבירים את האכיפה של מדיניות Google בנושא הסכמת משתמשים באיחוד האירופי.
למידע נוסף על העדכונים של Google לגבי סטטוס ההסכמה לתנועה באזור הכלכלי האירופי (EEA).
המשתמשים בתכונה 'סטטוס הסכמה' צריכים לשלוח שני פרמטרים חדשים, בנוסף לאחסון מודעות ולאחסון ב-Analytics:
צריך לעדכן את קובץ info.plist של האפליקציה, כך שיכלול את הפרטים הבאים:
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/> <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>
מעדכנים את הקריאות לבקשת הסכמה כך שיכללו את הפרמטרים של נתוני המשתמשים במודעות וההתאמה האישית של המודעות:
Swift
Analytics.setConsent([ .analyticsStorage: .granted, .adStorage: .granted, .adUserData: .granted, .adPersonalization: .granted, ])
Objective-C
[FIRAnalytics setConsent:@{ FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted, FIRConsentTypeAdStorage : FIRConsentStatusGranted, FIRConsentTypeAdUserData : FIRConsentStatusGranted, FIRConsentTypeAdPersonalization : FIRConsentStatusGranted, }];
אימות הגדרות ההסכמה
כדי לוודא שהגדרות ההסכמה פועלות כמצופה, אפשר להיכנס למסוף ניפוי הבאגים של Xcode של האפליקציה.
כך עושים זאת:
- להפעיל רישום מפורט ביומן במכשיר.
במסוף ניפוי הבאגים של Xcode, מחפשים את:
ad_storage
analytics_storage
ad_user_data
ad_personalization
לדוגמה, אם אחסון מודעות מופעל, תראה את ההודעה הבאה:
ad_storage is granted.