הדף הזה מיועד למפתחים שמשתמשים ב-Google Analytics for Firebase SDK באפליקציה שלהם ורוצים לשלב את סטטוס ההסכמה. למבוא לסטטוס ההסכמה, תוכלו לקרוא את המאמר סקירה כללית של סטטוס ההסכמה.
ב-Google Analytics יש סטטוס הסכמה כדי לשנות את אופן הפעולה של ה-SDK בהתאם לסטטוס ההסכמה של המשתמשים. אפשר להטמיע את סטטוס ההסכמה בשיטה בסיסית או מתקדמת. אם אתם לא בטוחים אם להטמיע את סטטוס ההסכמה הבסיסי או המתקדם, מומלץ לקרוא על סטטוס הסכמה בסיסי לעומת סטטוס הסכמה מתקדם ולבדוק את ההנחיות של החברה.
לפני שמתחילים
כדי לנהל את הסכמת המשתמשים, צריך להטמיע:
- Google Analytics for Firebase SDK
באנר של הגדרות הסכמה לתיעוד הסכמה של המשתמש
הגדרה של סטטוס הסכמה
כדי להגדיר את סטטוס ההסכמה, צריך:
הגדרת מצב ברירת המחדל להסכמה
כברירת מחדל, לא מוגדרים ערכים של סטטוס הסכמה. כדי להגדיר את מצב ברירת המחדל להסכמה באפליקציה:
- פותחים את הקובץ info.plist של האפליקציה.
מוסיפים את צמדי מפתח/ערך של סטטוס ההסכמה. המפתח מתאר את סוג ההסכמה והערך מציין את מצב ההסכמה. הערכים יכולים להיות
true
, כלומר אם התקבלה הסכמה, אוfalse
– המשמעות היא שההסכמה נדחתה.בהתאם לעדכונים של סטטוס ההסכמה לגבי תנועה באזור הכלכלי האירופי (EEA), אפשר להגדיר את הערך
eu_consent_policy
ל-ad_user_data
ול-ad_personalization
, כלומר ההסכמה תידחה רק למשתמשים באזורים שכפופים למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי.מגדירים את האפשרויות הבאות:
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/>
עדכון ההסכמה
כדי לעדכן את ערכי ההסכמה אחרי השקת האפליקציה, צריך להפעיל את השיטה setConsent
.
הערך שנקבע על ידי ה-method 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)
משתמשים בסטטוס הסכמה צריכים לשלוח שני פרמטרים חדשים, בנוסף לאחסון מודעות ולאחסון ניתוח נתונים:
יש לעדכן את קובץ 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.