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

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

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

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

iOS Android

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

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

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

• Google Analytics for Firebase SDK

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

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

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

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

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

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

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

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

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. שומרים את השינויים. בשלב הבא, מטמיעים את המנגנון לעדכון ערכי ההסכמה.

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

<meta-data android:name="google_analytics_default_allow_analytics_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_user_data" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="true" />

עדכון ההסכמה

כדי לעדכן את ערכי ההסכמה אחרי השקת האפליקציה, צריך להפעיל את השיטה setConsent.

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

אם משתמש מבטל את ההסכמה שניתנה לו לשימוש ב-Analytics או באחסון מודעות, מערכת Google Analytics מוחקת את כל מאפייני המשתמש, כולל הסכמה ל-ad_personalization. כדי לשמר את הבחירה של המשתמשים בנושא פרטיות להתאמה אישית של מודעות, צריך לשחזר את הערך הקודם להתאמה אישית של מודעות באמצעות setConsent (Kotlin+KTX | Java) .

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

Java

// Set consent types.
Map<ConsentType, ConsentStatus> consentMap = new EnumMap<>(ConsentType.class);
consentMap.put(ConsentType.ANALYTICS_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_USER_DATA, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_PERSONALIZATION, ConsentStatus.GRANTED);

mFirebaseAnalytics.setConsent(consentMap);

Kotlin

Firebase.analytics.setConsent {
  analyticsStorage(ConsentStatus.GRANTED)
  adStorage(ConsentStatus.GRANTED)
  adUserData(ConsentStatus.GRANTED)
  adPersonalization(ConsentStatus.GRANTED)
}