Dokumentation Campaign Campaign Standard – Dokumentation

Änderungen am Push-Benachrichtigungskanal push-upgrade

Last update: Sun Apr 05 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Gilt für:
Campaign Standard

Themen:
Pushen

Erstellt für:

Experte
Admin

Sie können Campaign verwenden, um Push-Benachrichtigungen an Android- und iOS-Geräte zu senden. Dazu benötigt Campaign bestimmte Abonnementdienste. Einige wichtige Änderungen am Android Firebase Cloud Messaging(FCM)-Dienst werden 2024 veröffentlicht und können sich auf Ihre Implementierung von Adobe Campaign auswirken. Ihre Konfiguration der Anmeldedienste für Android-Push-Nachrichten muss möglicherweise aktualisiert werden, um diese Änderung zu unterstützen.

Darüber hinaus empfiehlt Adobe dringend, zur Token-basierten anstatt einer zertifikatbasierten Verbindung zu APNs zu migrieren, weil sie sicherer und skalierbarer ist.

Um einen unterbrechungsfreien Dienst sicherzustellen, müssen Sie Ihre bei Adobe Campaign registrierten Mobile Apps aktualisieren, um die neuesten Authentifizierungsmechanismen für FCM (Android) und APNs (iOS) zu implementieren.

Erfahren Sie mehr über die Konfiguration Ihrer Mobile-App-Zertifikate in Adobe Campaign Standard

Google Android Firebase Cloud Messaging (FCM)-Dienst fcm-push-upgrade

Was hat sich geändert? fcm-changes

Im Rahmen der kontinuierlichen Bemühungen von Google, seine Dienste zu verbessern, werden die veralteten FCM-APIs am 20. Juni 2024 eingestellt. Weitere Informationen zum Firebase Cloud Messaging-HTTP-Protokoll finden Sie in der Dokumentation zu Google Firebase.

Ab Version 24.1 unterstützt Adobe Campaign Standard die HTTP v1-APIs zum Senden von Android-Push-Benachrichtigungen.

Sind Sie betroffen? fcm-impact

Wenn Sie Adobe Campaign Standard bereits zum Senden von Push-Benachrichtigungen verwenden, muss Ihre Implementierung aktualisiert werden.

Die Migration zu den neuesten APIs ist obligatorisch, um Dienstunterbrechungen zu vermeiden.

Wie wird die Aktualisierung durchgeführt? fcm-transition-procedure

Voraussetzungen fcm-transition-prerequisites

Die Unterstützung des HTTP v1-API-Modus wurde in Version 24.1 hinzugefügt. Wenn Ihre Umgebung auf einer älteren Version ausgeführt wird, besteht eine Voraussetzung für diese Änderung darin, Ihre Umgebung auf die neueste Campaign Standard-Version zu aktualisieren.
Die JSON-Datei des Kontos des Firebase Admin SDK-Dienstes ist erforderlich, damit die Mobile App auf HTTP v1 verschoben wird. Wie Sie diese Datei erhalten, erfahren Sie in der Dokumentation zu Google Firebase.
Wenn Sie immer noch diese ältere Version des SDK verwenden, müssen Sie Ihre Implementierung mit dem Adobe Experience Platform SDK aktualisieren. In diesem Artikel erfahren Sie, wie Sie zum Adobe Experience Platform SDK migrieren.
Vergewissern Sie sich, dass die Mobile App-Konfigurationsberechtigung in Adobe Experience Platform Data Collection Mobile festgelegt wurde, bevor Sie die folgenden Schritte ausführen. Weitere Informationen.

Migrationsverfahren fcm-transition-steps

Befolgen Sie die folgenden Schritte, um Ihre Umgebung zu HTTP v1 zu migrieren:

Navigieren Sie zu Administration > Kanäle > Mobile App (AEP SDK).
Wählen Sie die spezifische Mobile App aus, für die das Zertifikat aktualisiert werden muss.
Aktivieren Sie das Kontrollkästchen App-Anmeldeinformationen aktualisieren.
Geben Sie die App-ID (Android-Paketname) aus der Datei build.gradle des Android-Projekts an. Beispiel: com.android.test.testApp. Stellen Sie sicher, dass Sie unterschiedliche IDs für Staging- und Produktionsumgebungen verwenden.
Laden Sie die JSON-Schlüsseldatei mit dem privaten Android-Schlüssel hoch.
Wählen Sie die Schaltfläche Speichern aus.

NOTE

Sobald diese Änderungen angewendet werden, verwenden alle neuen Sendungen von Push-Benachrichtigungen an Android-Geräte die HTTP v1-API. Für bestehende Push-Sendungen, die gerade erneut versucht werden, gestartet sind oder in Verwendung sind, wird weiterhin die (veraltete) HTTP-API verwendet.

Apple iOS-Push-Benachrichtigungsdienst (APNs) apns-push-upgrade

Was hat sich geändert? ios-changes

Wie von Apple empfohlen, sollten Sie Ihre Kommunikation mit dem Apple-Push-Benachrichtigungsdienst (APNs) mithilfe von Stateless-Authentifizierungs-Token sichern.

Token-basierte Authentifizierung bietet eine Möglichkeit der Stateless-Kommunikation mit dem APNs. Stateless-Kommunikation ist schneller als zertifikatbasierte Kommunikation, da hier der APNs nicht das Zertifikat oder andere Informationen zu Ihrem Anbieter-Server nachschlagen muss. Die Verwendung der Token-basierten Authentifizierung bietet noch weitere Vorteile:

Sie können dasselbe Token von mehreren Anbieter-Servern verwenden.
Mit einem einzelnen Token können Sie Benachrichtigungen für alle Apps Ihres Unternehmens verteilen.

Weitere Informationen über Token-basierte Verbindungen zu APNs finden Sie in der Apple Developer-.

Adobe Campaign Standard unterstützt sowohl Token-basierte als auch zertifikatbasierte Verbindungen. Wenn Ihre Implementierung auf einer zertifikatbasierten Verbindung basiert, empfiehlt Adobe dringend, sie durch eine Token-basierte Verbindung zu ersetzen.

Sind Sie betroffen? ios-impact

Wenn Ihre aktuelle Implementierung für die Verbindung mit dem APNs auf zertifikatbasierten Anfragen basiert, sind Sie betroffen. Die Migration zu einer Token-basierten Verbindung wird empfohlen.

Wie wird die Aktualisierung durchgeführt? ios-transition-procedure

Voraussetzungen ios-transition-prerequisites

Die Unterstützung des Modus Token-basierte Authentifizierung wurde in Version 24.1 hinzugefügt. Wenn Ihre Umgebung auf einer älteren Version ausgeführt wird, besteht eine Voraussetzung für diese Änderung darin, Ihre Umgebung auf die neueste Campaign Standard-Version zu aktualisieren.
Sie benötigen einen Signierschlüssel für die APNs-Authentifizierungs-Token, um die Token zu erzeugen, die Ihr Server verwendet. Sie fordern diesen Schlüssel von Ihrem Apple-Entwicklerkonto an, wie in der Apple-Entwicklerdokumentation beschrieben.

Migrationsverfahren ios-transition-steps

Gehen Sie wie folgt vor, um Ihre mobilen iOS-Apps zum Token-basierten Authentifizierungsmodus zu migrieren:

Navigieren Sie zu Administration > Kanäle > Mobile App (AEP SDK).
Wählen Sie die spezifische Mobile App aus, für die das Zertifikat aktualisiert werden muss.
Aktivieren Sie das Kontrollkästchen Anmeldeinformationen der Anwendung aktualisieren.
Geben Sie die App-ID (iOS Paket-ID) an. Sie finden die iOS Paket-ID (App-ID) im primären Ziel Ihrer App in Xcode.
Laden Sie Ihre iOS p8-Zertifikatdatei hoch.
Füllen Sie die APNs-Verbindungseinstellungen Schlüssel-ID und iOS-Team-ID aus.
Klicken Sie auf Speichern.

Ihre iOS-Anwendung wird jetzt zum Token-basierten Authentifizierungsmodus migriert.

Häufig gestellte Fragen push-upgrade-faq

Können wir dieselbe App-ID in der Staging- und Produktionsinstanz beibehalten?

Bei iOS-Mobile-Apps können Sie dieselbe App-ID, d. h. Ihre iOS-App-Paket-ID, sowohl für Staging- als auch für Produktionsumgebungen verwenden. Unter Android sollte die App-ID jedoch für jede Umgebung eindeutig sein. Daher wird vorgeschlagen, „stage“ an die in der Staging-Umgebung erstellte App-ID anzuhängen.

Können wir nur die Android-App migrieren?

Nein, sowohl Android- als auch iOS-Apps müssen entsprechend den oben beschriebenen Schritten migriert werden.

Welche Art von Überprüfung müssen wir nach der Migration durchführen?

Wir empfehlen, alle Ihre Push-bezogenen Anwendungsfälle funktionell zu validieren.

Was ist zu tun, wenn beim Speichern der Mobile App der Fehler „Nicht autorisiert“ angezeigt wird?

Hier scheint es sich um ein Berechtigungsproblem im Zusammenhang mit der Datenerfassung von Adobe Experience Platform zu handeln. Um es zu beheben, müssen Sie Berechtigungen „Mobil“ und „Mobile-App-Konfiguration“ in der Adobe Admin Console hinzufügen, wie im Abschnitt „Voraussetzungen“ dieses Artikels beschrieben.

Sind Änderungen am Mobile-App-Code erforderlich?

Nein, es sind nur konfigurationsbezogene Änderungen in Firebase und dem App-Entwicklerkonto erforderlich. Änderungen in der Mobile App auf Kundenseite sind nicht erforderlich.

Müssen wir das iOS-Zertifikat jedes Jahr aktualisieren?

Nein, nach dieser Migration muss das iOS-Zertifikat nicht jedes Jahr aktualisiert werden.

Was passiert, wenn diese Migration nicht durchgeführt wird?

Die Android-Push-Nachrichten schlagen dann nach dem 20. Juni 2024 gemäß der Benachrichtigung von Google fehl. Weitere Informationen

Können Kunden nach Abschluss der FCMv1-Migration zurück zu FCM migrieren?

Ja, Kundinnen und Kunden können bis zum 20. Juni 2024 zurück zu FCM migrieren. Danach ist die Migrationsoption nicht mehr verfügbar.

Wird die HTTP v1-API-Migration in der Mobile App SDK v4 unterstützt?

Nein, Kundinnen und Kunden müssen zunächst ihre Mobile App zum V5 SDK migrieren und dann mit der oben dargestellten Migration fortfahren. Sie müssen dies vorrangig tun, da sonst ihr Push-Dienst gemäß der Benachrichtigung von Google ab Juni 2024 fehlschlagen wird.

Hat die Änderung in der Staging-Instanz Auswirkungen auf die Produktionsinstanz?

Nein, Änderungen an der Staging-Mobile-App haben keine Auswirkungen auf die Produktionsinstanz.

recommendation-more-help

3ef63344-7f3d-48f9-85ed-02bf569c4fff