Dokumentation Campaign Campaign Standard – Dokumentation

Änderungen am Push-Benachrichtigungskanal push-upgrade

Last update: Tue Jun 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

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 verä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 HTTP-Protokoll von Firebase Cloud Messaging finden Sie in der Google Firebase-Dokumentation.

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 erfolgt die Aktualisierung? 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 Classic-Version zu aktualisieren.
Die JSON-Datei des Kontos des Firebase Admin SDK-Dienstes ist erforderlich, damit die Mobile App auf HTTP v1 verschoben wird. In der Dokumentation zu Google Firebase erfahren Sie, wie Sie diese Datei erhalten.
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.
Klicken Sie auf die Schaltfläche Speichern.

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 verä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.

Erfahren Sie mehr über Token-basierte Verbindungen zum APNs im Apple-Entwickler-Handbuch.

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 erfolgt die Aktualisierung? 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 über Ihr Apple-Entwicklerkonto an, wie im Apple-Entwickler-Handbuch 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

Kann dieselbe App-ID in der Staging- und Produktionsinstanz verwendet werden?

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.

Ist es möglich, nur die Android-App zu 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 kann getan werden, 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 im Code der Mobile App 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 Kundinnen und Kunden nach Abschluss der FCMv1-Migration zu FCM zurückkehren?

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 Migration der HTTP v1-API von der SDK V4-Mobile-App 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 auf 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