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

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

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

סטטוס הסכמה מתקדם סטטוס הסכמה בסיסי

iOS Android

חשוב: סטטוס ההסכמה לאפליקציות עודכן ב-30 באוקטובר 2023, ועכשיו הוא כולל שני פרמטרים נוספים. אם אתם כבר משתמשים בסטטוס הסכמה, אתם צריכים לשדרג לגרסה 2 של סטטוס ההסכמה. מידע נוסף על העדכונים של Google בסטטוס ההסכמה לגבי תנועה באזור הכלכלי האירופי (EEA)

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

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

• ‫Google Analytics for Firebase SDK

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

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

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

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

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:

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)

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