Konfigurowanie trybu uzyskiwania zgody w aplikacjach

Ta strona jest przeznaczona dla deweloperów, którzy używają w swojej aplikacji pakietu SDK Google Analytics dla Firebase i chcą zintegrować tryb uzyskiwania zgody. Wprowadzenie do trybu uzyskiwania zgody znajdziesz w Przegląd trybu uzyskiwania zgody.

Google Analytics udostępnia tryb uzyskiwania zgody, który pozwala dostosować działanie pakietu SDK na podstawie stanu zgody użytkowników. Tryb uzyskiwania zgody możesz wdrożyć w sposób podstawowy lub zaawansowany. Jeśli nie masz pewności, czy wdrożyć podstawowy czy zaawansowany tryb uzyskiwania zgody, dowiedz się więcej o różnicach między tymi trybami i zapoznaj się z wytycznymi swojej firmy.

Zanim zaczniesz

Zanim zaczniesz zarządzać zgodą użytkowników, musisz wdrożyć:

  • Pakiet SDK Google Analytics dla Firebase

  • baner z ustawieniami zgody na przetwarzanie danych, który umożliwia uzyskiwanie zgody użytkowników;

Aby skonfigurować tryb uzyskiwania zgody, musisz:

  1. Ustaw domyślny stan zgody użytkownika

Domyślnie nie są ustawione żadne wartości trybu uzyskiwania zgody. Aby ustawić domyślny stan zgody użytkownika w aplikacji:

  1. Otwórz plik info.plist aplikacji.

  2. Dodaj pary klucz-wartość trybu uzyskiwania zgody. Klucz opisuje rodzaj zgody, a wartość wskazuje stan zgody użytkownika. Wartości mogą być równe true, co oznacza, że użytkownik wyraził zgodę, lub false, co oznacza, że użytkownik nie wyraził zgody.

    Zgodnie z aktualizacjami trybu uzyskiwania zgody w przypadku ruchu w Europejskim Obszarze Gospodarczym (EOG) można ustawić wartość eu_consent_policy dla parametrów ad_user_data i ad_personalization, co oznacza, że zgoda jest odrzucana tylko w przypadku użytkowników z regionów objętych polityką w zakresie zgody użytkownika z UE.

    Ustaw te wartości:

    • 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. Zapisz zmiany. Następnie wdróż mechanizm aktualizowania wartości zgody.

Aby na przykład domyślnie ustawić stan „Przyznano” dla wszystkich parametrów:

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

Aby zaktualizować wartości zgody po uruchomieniu aplikacji, wywołaj metodę setConsent.

Wartość ustawiona przez metodę setConsent zastępuje ustawienie domyślne i jest zachowywana podczas wykonywania aplikacji. Wartość pozostaje w tym stanie do momentu ponownego wywołania funkcji setConsent, nawet jeśli użytkownik zamknie i ponownie otworzy aplikację. Funkcja setConsent aktualizuje tylko określone przez Ciebie parametry.

Jeśli użytkownik wycofa wcześniej udzieloną zgodę na przechowywanie danych Analytics lub danych reklamowych, Google Analytics usunie wszystkie właściwości użytkownika, w tym zgodę na ad_personalization. Aby zachować wybór użytkownika dotyczący zgody na personalizację reklam, przywróć poprzednią wartość personalizacji reklam za pomocą kodu setConsent (Swift | Obj-C) .

Poniższy przykład pokazuje, jak metoda setConsent aktualizuje różne wartości zgody na granted:

Swift

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

Objective-C

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

Jeśli użytkownik zdecyduje się wycofać zgodę, zaktualizuj odpowiednio stany zgody

W ramach stałego budowania ekosystemu reklamy cyfrowej zapewniającego ochronę prywatności zaostrzamy egzekwowanie polityki w zakresie zgody użytkownika z UE.

Dowiedz się więcej o aktualizacjach trybu uzyskiwania zgody w przypadku ruchu w Europejskim Obszarze Gospodarczym.

Użytkownicy trybu uzyskiwania zgody muszą wysyłać 2 nowe parametry oprócz parametrów dotyczących pamięci na potrzeby reklam i pamięci na potrzeby analityki:

  1. Zaktualizuj plik Info.plist aplikacji, aby zawierał:

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

  2. Zaktualizuj wywołania zgody, aby uwzględniały parametry danych użytkownika na potrzeby wyświetlania reklam i personalizacji reklam:

    Swift

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

    Objective-C

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

Aby sprawdzić, czy ustawienia uzyskiwania zgody działają zgodnie z oczekiwaniami, otwórz konsolę debugowania Xcode w swojej aplikacji.

Wykonaj te czynności:

  1. Włącz logowanie szczegółowe na urządzeniu.

  2. W konsoli debugowania Xcode poszukaj:

    • ad_storage
    • analytics_storage
    • ad_user_data
    • ad_personalization

    Jeśli na przykład masz włączone przechowywanie danych reklamowych, zobaczysz ten komunikat:

    ad_storage is granted.