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

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

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

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

אם אתם משתמשים ב-Google Analytics for Firebase iOS SDK, תוכלו למנוע את הבעיה הזו על ידי עדכון ה-iOS SDK לגרסה 10.23.0. אם אתם משתמשים ב-Android SDK, תוכלו למנוע את הבעיה הזו באמצעות הפעולות הבאות:

1. אין להגדיר ערכי ברירת מחדל עבור ad_storage ו-analytics_storage במניפסט של האפליקציה.
2. משביתים את איסוף הנתונים ב-Analytics לפני שמגדירים את מצב ההסכמה של מופע האפליקציה ad_storage ו-analytics_storage.
3. אחרי שמביעים הסכמה לכך, מפעילים מחדש את איסוף הנתונים ב-Analytics כדי שנתוני Analytics לא יאופסו.

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

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

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

iOS Android

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

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

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

• Google Analytics for Firebase SDK

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

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

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

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

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

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

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

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

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

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

עדכון ההסכמה

כדי לעדכן את ערכי ההסכמה אחרי השקת האפליקציה, צריך לבצע קריאה ל-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:

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.