הגדרת סטטוס הסכמה באפליקציות

הדף הזה מיועד למפתחים שמשתמשים ב-Google Analytics for Firebase SDK באפליקציה שלהם ורוצים לשלב את סטטוס ההסכמה. להיכרות עם סקירת סטטוס הסכמה, קראו את המאמר.

ב-Google Analytics יש סטטוס הסכמה שמאפשר לכם לשנות את אופן הפעולה של ה-SDK בהתאם לסטטוס ההסכמה של המשתמשים. אפשר להטמיע את סטטוס ההסכמה בגרסה בסיסית או מתקדמת. אם אתם לא בטוחים אם כדאי להטמיע סטטוס הסכמה בסיסי או מתקדם, תוכלו לקרוא מידע נוסף על ההבדלים בין סטטוס הסכמה בסיסי לסטטוס הסכמה מתקדם ולבדוק את ההנחיות של החברה שלכם.

לפני שמתחילים

כדי לנהל את הסכמת המשתמשים, צריך להטמיע:

• ‫Google Analytics for Firebase SDK

• באנר הגדרות הסכמה כדי לתעד את הסכמת המשתמשים

הגדרה של סטטוס הסכמה

כדי להגדיר סטטוס הסכמה, צריך:

1. הגדרת מצב הסכמה כברירת מחדל

הגדרת מצב ההסכמה שיוגדר כברירת מחדל

כברירת מחדל, לא מוגדרים ערכים של סטטוס ההסכמה. כדי להגדיר את מצב ההסכמה שיוגדר כברירת מחדל באפליקציה:

1. פותחים את הקובץ info.plist של האפליקציה.

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

3. שומרים את השינויים. לאחר מכן, מטמיעים את המנגנון לעדכון ערכי ההסכמה.

לדוגמה, כדי להגדיר כברירת מחדל את ההסכמה לכל הפרמטרים:

<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.

הערך שמוגדר באמצעות השיטה setConsent מבטל את הגדרת ברירת המחדל ונשמר בין הפעלות של האפליקציה. הערך נשאר במצב הזה עד שמפעילים שוב את setConsent, גם אם משתמש סוגר את האפליקציה ופותח אותה מחדש. setConsent מעדכן רק את הפרמטרים שאתם מציינים.

אם משתמש מבטל את ההסכמה שנתן בעבר לאחסון נתונים ב-Analytics או ב-Ad, ‏ Google Analytics מוחק את כל מאפייני המשתמש, כולל ההסכמה לad_personalization. כדי לשמור את בחירת ההסכמה של המשתמש להתאמה אישית של מודעות, צריך לשחזר את הערך הקודם של ההסכמה להתאמה אישית של מודעות באמצעות setConsent (Swift | Obj-C) .

בדוגמה הבאה מוצג עדכון של ערכי ההסכמה השונים ל-granted באמצעות השיטה setConsent:

Analytics.setConsent([
  .analyticsStorage: .granted,
  .adStorage: .granted,
  .adUserData: .granted,
  .adPersonalization: .granted,
])

[FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdUserData : FIRConsentStatusGranted,
  FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

אם משתמש מחליט לבטל את ההסכמה שלו, חשוב לעדכן את מצבי ההסכמה בהתאם

שדרוג לגרסה 2 של סטטוס ההסכמה

כחלק מהמחויבות המתמשכת של Google ליצירת סביבת פרסום בדיגיטל ששומרת על הפרטיות, אנחנו מגבירים את האכיפה של מדיניות Google בנושא הסכמת משתמשים באיחוד האירופי.

מידע נוסף על העדכונים של Google בסטטוס ההסכמה לגבי תנועה באזור הכלכלי האירופי (EEA)

משתמשים בסטטוס הסכמה צריכים לשלוח שני פרמטרים חדשים בנוסף לפרמטרים ad_storage ו-analytics_storage:

1. מעדכנים את קובץ Info.plist של האפליקציה ומוסיפים לו:

   <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
   <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>
   

2. מעדכנים את הקריאות להסכמה כך שיכללו את הפרמטרים של נתוני משתמשים במודעות והתאמה אישית של מודעות:

   Swift

   Analytics.setConsent([
   .analyticsStorage: .granted,
   .adStorage: .granted,
   .adUserData: .granted,
   .adPersonalization: .granted,
   ])
   

   Objective-C

   [FIRAnalytics setConsent:@{
     FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
     FIRConsentTypeAdStorage : FIRConsentStatusGranted,
     FIRConsentTypeAdUserData : FIRConsentStatusGranted,
     FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
   }];
   

אימות הגדרות ההסכמה

כדי לוודא שהגדרות ההסכמה פועלות כמצופה, אפשר לעיין במסוף ניפוי הבאגים של Xcode עבור האפליקציה.

כך עושים את זה:

1. מפעילים את הרישום המפורט (verbose) ביומן במכשיר.

2. במסוף לניפוי באגים ב-Xcode, מחפשים את:

   • ad_storage
   • analytics_storage
   • ad_user_data
   • ad_personalization

   לדוגמה, אם אחסון נתוני הפרסום מופעל, תוצג ההודעה הבאה:

   ad_storage is granted.