Unterstützung von iOS 14

Mit iOS 14.5 schreibt Apple vor, dass Entwickler die Einwilligung des Nutzers über das App Tracking Transparency-Framework (ATT) einholen müssen, um ihn zu tracken oder auf die Werbe-ID (IDFA) seines Geräts zuzugreifen. Weitere Informationen finden Sie in der Dokumentation von Apple zu User Privacy and Data Use und App Tracking Transparency.

Betroffene Firebase-Produkte

Firebase-SDKs greifen nicht auf die IDFA zu. Einige haben jedoch Integrationen mit Google Analytics, die den Zugriff auf die IDFA beinhalten können.

In der Tabelle unten sind die Firebase-Produkte aufgeführt, die auf Apple-Plattformen verfügbar sind. Außerdem wird beschrieben, wie sich die Funktionalität der einzelnen Produkte auswirkt, wenn die IDFA nicht zugänglich ist.

^{1 Firebase AI Logic hieß früher „Vertex AI in Firebase“.}

Betroffene Firebase-Integrationen

In der folgenden Tabelle sind Firebase-integrierte Produkte aufgeführt, die betroffen sind, wenn die IDFA nicht verfügbar ist.

Berechtigung zum App-Tracking unter iOS 14 anfordern

Wenn Ihre Apple-Anwendung auf die IDFA zugreifen soll, können Sie das App Tracking Transparency-Framework von Apple in Ihre App einfügen und die Berechtigung zum Tracking oder zum Zugriff auf die IDFA Ihrer Nutzer anfordern.

Viele Anwendungen zeigen vor dem Anfordern von Berechtigungen ein Infofeld an. So können Sie Nutzern mehr Informationen dazu bieten, wie in Ihrer App die IDFA verwendet wird, bevor Sie den Zugriff anfordern.

Wenn Sie AdMob- oder Ad Manager-App-Publisher sind, sollten Sie Funding Choices verwenden. Damit wird automatisch die Einwilligung für die Bereitstellung personalisierter Werbung sowie die Einwilligung für das Tracking des Nutzers gemäß den Apple-Richtlinien eingeholt. Weitere Informationen finden Sie auf der Seite AdMob Einwilligung mit Nutzernachrichten.

Im folgenden Leitfaden wird eine Lösung mit Firebase In-App Messaging beschrieben, mit der Sie vor dem Anfordern des Tracking-Zugriffs über App Tracking Transparency einen Infobildschirm erstellen und anzeigen können.

In-App Messaging in Ihre App einbinden

Folgen Sie der Anleitung unter In-App Messaging zu meiner Apple-Anwendung hinzufügen.

Schließen von In-App-Nachrichten verarbeiten

Zuerst sollten Sie vermeiden, den Erklärungsbildschirm auf Geräten anzuzeigen, auf denen der Einwilligungsdialog nicht präsentiert werden kann, z. B. auf Geräten mit iOS 13. Achten Sie darauf, dass dieser Code unmittelbar nach FirebaseApp.configure() ausgeführt wird.

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

Implementieren Sie das InAppMessagingDisplayDelegate-Protokoll, um Ereignisse zu verarbeiten, wenn der Nutzer den Erklärungsbildschirm schließt. Wenn der Nutzer auf „OK“ tippt, zeigen Sie die Systemaufforderung über das App Tracking Transparency-Framework an.

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

In-App Messaging-Kampagne erstellen

Sobald der Code in Ihrer App eingefügt ist, können Sie in der Firebase-Konsole eine In-App-Nachricht erstellen.

1. Erstellen Sie in der Firebase-Konsole eine neue In-App Messaging-Kampagne.
2. Füllen Sie die In-App-Nachrichten mit den gewünschten Inhalten und legen Sie fest, dass die Nachricht beim Ereignis app_launch ausgelöst werden soll.
3. Achten Sie darauf, dass im Bereich Targeting nur die neueste Version Ihrer App und höher als Zielvorhaben für die Kampagne festgelegt ist.

Sie können das Aussehen des Erklärungsbildschirms anpassen, indem Sie der Anleitung in der In-App Messaging-Dokumentation folgen.

Optional: A/B-Test verschiedener Erklärungsbildschirme

In-App Messaging ist in Firebase A/B Testing integriert. Damit können Sie verschiedene Erklärungsbildschirme testen.

Firebase A/B Testing erstellt automatisch Testgruppen und hilft Ihnen, die Interaktion von Nutzern mit verschiedenen Varianten Ihrer Anwendung zu visualisieren.

App-Tracking-Berechtigungen aufzeichnen

Wenn Sie beim Verarbeiten der Antwort auf die Berechtigungsanfrage für das App-Tracking kein Google Analytics-Ereignis protokolliert haben, müssen Sie das tun, um Änderungen bei der Antwortrate bei einem A/B-Test zu erfassen.

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.
  }
}

Neues Conversion-Ereignis erstellen

Rufen Sie in der Firebase-Konsole den Bereich Analytics auf, gehen Sie zum Menü Conversions und fügen Sie ein neues Conversion-Ereignis mit demselben Namen wie das Ereignis hinzu, das mit dem oben stehenden Beispielcode protokolliert wurde.

Neuen Test erstellen

Klicken Sie in der Console im In-App Messaging-Menü auf Neuer Test und folgen Sie der Anleitung auf den angezeigten Bildschirmen.

• Achten Sie darauf, dass im Bereich Targeting nur die neueste Version Ihrer App und höher als Zielvorhaben für die Kampagne festgelegt ist.
• Wählen Sie im Bereich Zielvorhaben das Conversion-Ereignis aus, das Sie mit dem Beispielcode oben erstellt haben, sowie alle anderen Messwerte, die Sie erfassen möchten.

Nachdem Sie Ihren Test veröffentlicht haben, müssen erst einmal Daten erhoben werden, bevor aussagekräftige Ergebnisse erzielt werden können.

In der Firebase A/B Testing-Dokumentation finden Sie Informationen dazu, wie Sie einen Test überwachen und eine erfolgreiche Variante einführen.