Obsługa iOS 14

Usługi Firebase, których dotyczy problem

Pakiety SDK Firebase nie mają dostępu do identyfikatora IDFA, ale niektóre z nich są zintegrowane z Google Analytics co może wiązać się z dostępem do tego identyfikatora.

W tabeli poniżej znajdziesz listę usług Firebase dostępnych na platformach Apple oraz opis wpływu braku dostępu do identyfikatora IDFA na działanie każdej z nich.

^{1 Firebase AI Logic nazywała się wcześniej "Vertex AI in Firebase".}

Integracje Firebase, których dotyczy problem

W tabeli poniżej znajdziesz listę usług zintegrowanych z Firebase, na które wpływa brak dostępu do identyfikatora IDFA.

Prośba o zgodę na śledzenie w aplikacji w systemie iOS 14

Jeśli chcesz, aby Twoja aplikacja na platformę Apple miała dostęp do identyfikatora IDFA, możesz dodać do niej platformę App Tracking Transparency firmy Apple i poprosić o zgodę na śledzenie użytkowników lub dostęp do ich identyfikatora IDFA.

Wiele aplikacji przed poproszeniem o zgodę wyświetla ekran wprowadzający lub wyjaśniający. Na ekranie wyjaśniającym możesz informować użytkowników o tym, jak Twoja aplikacja wykorzystuje identyfikator IDFA, zanim poprosisz o dostęp do niego.

Jeśli jesteś wydawcą aplikacji AdMob lub Ad Managera, rozważ użycie Funding Choices, które automatycznie obsługuje uzyskiwanie zgody na wyświetlanie reklam spersonalizowanych oraz na śledzenie użytkownika zgodnie z wytycznymi Apple. Więcej informacji znajdziesz na stronie AdMob Zgoda i wiadomości dla użytkowników.

W tym przewodniku znajdziesz rozwiązanie, które wykorzystuje Firebase In-App Messaging do tworzenia i wyświetlania ekranu wyjaśniającego przed poproszeniem o zgodę na śledzenie za pomocą platformy App Tracking Transparency.

Dodawanie In-App Messaging do aplikacji

Postępuj zgodnie z instrukcjami, aby dodać In-App Messaging do aplikacji na platformę Apple.

Obsługa odrzucania wiadomości w aplikacji

Najpierw unikaj wyświetlania ekranu wyjaśniającego na urządzeniach, które nie mogą wyświetlać okna dialogowego zgody, np. na urządzeniach z systemem iOS 13. Upewnij się, że ten kod jest wykonywany natychmiast po FirebaseApp.configure().

if NSClassFromString("ATTrackingManager") == nil {
  // Avoid showing the App Tracking Transparency explainer if the
  // framework is not linked.
  InAppMessaging.inAppMessaging().messageDisplaySuppressed = true
}

Zaimplementuj protokół InAppMessagingDisplayDelegate, aby obsługiwać zdarzenia, gdy użytkownik odrzuci ekran wyjaśniający. Jeśli użytkownik kliknie OK, wyświetl komunikat systemowy za pomocą platformy App Tracking Transparency.

// The InAppMessaging delegate must be assigned before events can be handled.
InAppMessaging.inAppMessaging().delegate = self

func messageClicked(_ inAppMessage: InAppMessagingDisplayMessage,
                    with action: InAppMessagingAction) {
  switch action.actionText {
  case "OK":
    ATTrackingManager.requestTrackingAuthorization { status in
      switch status {
      case .authorized:
        // Optionally, log an event when the user accepts.
        Analytics.logEvent("tracking_authorized", parameters: nil)
      case _:
        // Optionally, log an event here with the rejected value.
      }
    }
  case _:
    // do nothing
  }
}

Tworzenie kampanii In-App Messaging

Gdy kod znajdzie się w Twojej aplikacji, utwórz wiadomość w aplikacji w Firebase konsoli.

1. W konsoli Firebase, utwórz nową kampanię In-App Messaging.
2. Wypełnij wiadomości w aplikacji odpowiednią treścią i ustaw, aby były wywoływane przez zdarzenie app_launch.
3. W sekcji Kierowanie upewnij się, że kampania jest kierowana tylko na najnowszą wersję aplikacji i nowsze.

Wygląd ekranu wyjaśniającego możesz dostosować, postępując zgodnie z instrukcjami w In-App Messaging dokumentacji.

Opcjonalnie: testowanie A/B różnych ekranów wyjaśniających

In-App Messaging ma wbudowaną integrację z Firebase A/B Testing, której możesz używać do eksperymentowania z różnymi ekranami wyjaśniającymi.

Firebase A/B Testing automatycznie tworzy grupy eksperymentalne i pomaga wizualizować interakcje użytkowników z różnymi wariantami aplikacji.

Rejestrowanie uprawnień do śledzenia w aplikacji

Jeśli podczas obsługi odpowiedzi na prośbę o zgodę na śledzenie w aplikacji nie zarejestrowano zdarzenia Google Analytics, musisz to zrobić, aby mierzyć zmiany odsetka odpowiedzi podczas przeprowadzania eksperymentu A/B.

ATTrackingManager.requestTrackingAuthorization { status in
  switch status {
  case .authorized:
    // Optionally, log an event when the user accepts.
    Analytics.logEvent("tracking_authorized", parameters: nil)
  case _:
    // Optionally, log an event here with the rejected value.
  }
}

Tworzenie nowego zdarzenia konwersji

W sekcji konsoli, otwórz menu Konwersje, a następnie dodaj nowe zdarzenie konwersji o takiej samej nazwie jak zdarzenie zarejestrowane za pomocą przykładowego kodu powyżej.AnalyticsFirebase

Tworzenie nowego eksperymentu

W menu konsoli In-App Messaging kliknij Nowy eksperyment, a następnie postępuj zgodnie z instrukcjami na wyświetlonych ekranach.

Więcej informacji o tym, jak monitorować eksperyment i wdrażać skuteczny wariant, znajdziesz w Firebase A/B Testingdokumentacji.