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

הדף הזה מיועד למפתחים שמשתמשים ב-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 או לאחסון מודעות, מערכת 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)

משתמשים בסטטוס הסכמה צריכים לשלוח שני פרמטרים חדשים בנוסף לשמירת קובצי Cookie לצורך הצגת מודעות ולשמירת קובצי Cookie לצורך ניתוח נתונים:

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. מפעילים רישום מפורט ביומן במכשיר.

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

   • ad_storage
   • analytics_storage
   • ad_user_data
   • ad_personalization

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

   ad_storage is granted.