Push Notification Channel-ändringar push-upgrade

Du kan använda Campaign för att skicka push-meddelanden på Android- och iOS-enheter. För att kunna göra detta förlitar sig Campaign på specifika prenumerationstjänster. Vissa viktiga ändringar av tjänsten Android Firebase Cloud Messaging (FCM) släpps 2024 och kan påverka din Adobe Campaign-implementering. Din prenumerationstjänstkonfiguration för push-meddelanden för Android kan behöva uppdateras för att den här ändringen ska fungera.

Dessutom rekommenderar Adobe att du går över till den tokenbaserade anslutningen till APN:er i stället för en certifikatbaserad anslutning, som är säkrare och mer skalbar.

För att säkerställa oavbruten service måste du uppgradera dina mobilappar som registrerats hos Adobe Campaign så att de innehåller de senaste autentiseringsmekanismerna för FCM (Android) och APN (iOS).

Läs mer om hur du konfigurerar certifikat för mobilprogram i Adobe Campaign Standard

Tjänsten Google Android Firebase Cloud Messaging (FCM) fcm-push-upgrade

Vad har ändrats? fcm-changes

Som en del av Google kontinuerliga arbete med att förbättra sina tjänster kommer de äldre FCM-API:erna att upphöra på 20 juni 2024. Läs mer om HTTP-protokollet för Firebase Cloud Messaging i Google Firebase-dokumentation.

Startar 24.1-utgåvan, stöder Adobe Campaign Standard HTTP v1-API:erna för att skicka push-meddelanden för Android.

Påverkas du? fcm-impact

Om du redan använder Adobe Campaign Standard för att skicka push-meddelanden måste implementeringen uppdateras.

Övergång till de senaste API:erna är obligatoriskt för att undvika att tjänster störs.

Hur uppdaterar jag? fcm-transition-procedure

Förhandskrav fcm-transition-prerequisites

  • Stödet för HTTP v1 API Läget har lagts till i version 24.1. Om miljön körs på en äldre version är en förutsättning för den här ändringen att du uppgraderar miljön till senaste Campaign Standarden.

  • JSON-filen för kontot för Android-administratören för SDK-tjänsten behövs för att mobilprogrammet ska kunna flyttas till HTTP v1. Lär dig hur du hämtar den här filen i Google Firebase-dokumentation.

  • Om du fortfarande använder den här äldre versionen av SDK måste du uppdatera implementeringen med Adobe Experience Platform SDK. Lär dig hur du migrerar till Adobe Experience Platform SDK i den här artikeln.

  • Se till att du har Konfiguration av mobilappar behörighet i Adobe Experience Platform Data Collection Mobile innan du utför stegen nedan. Läs mer.

Övergångsförfarande fcm-transition-steps

Så här flyttar du miljön till HTTP v1:

  1. Bläddra till Administration > Channels > Mobile app (AEP SDK).

  2. Välj det specifika mobilprogram som kräver certifikatuppdateringen.

  3. Kontrollera Update app credentials kryssrutan.

  4. Ange program-ID (Android-paketnamn) från Android-projektets build.gradle -fil. Till exempel: com.android.test.testApp. Se till att använda olika ID:n för staging- och produktionsmiljöer.

  5. Överför din JSON-nyckelfil för den privata Android-nyckeln.

  6. Klicka på Spara -knappen.

NOTE
När dessa ändringar har tillämpats använder alla nya push-meddelandeleveranser till Android-enheter HTTP v1 API. Befintliga push-leveranser som används, pågår och används, använder fortfarande HTTP-API:t (äldre).

Apple iOS Push Notification service (APN:er) apns-push-upgrade

Vad har ändrats? ios-changes

Som Apple rekommenderar bör du skydda kommunikationen med Apple Push Notification-tjänsten (APN:er) genom att använda statslösa autentiseringstoken.

Tokenbaserad autentisering är ett tillståndslöst sätt att kommunicera med APN:er. Tillståndslös kommunikation är snabbare än certifikatbaserad kommunikation eftersom det inte krävs APN:er för att slå upp certifikatet, eller annan information, som är relaterad till din leverantörsserver. Det finns andra fördelar med att använda tokenbaserad autentisering:

  • Du kan använda samma token från flera providerservrar.

  • Du kan använda en token för att distribuera meddelanden för alla företagets appar.

Läs mer om tokenbaserade anslutningar till APN:er i Dokumentation för Apple Developer.

Adobe Campaign Standard stöder både tokenbaserade och certifikatbaserade anslutningar. Om implementeringen bygger på en certifikatbaserad anslutning rekommenderar Adobe att du uppdaterar den till en tokenbaserad anslutning.

Påverkas du? ios-impact

Om den aktuella implementeringen är beroende av certifikatbaserade begäranden om att ansluta till APN:er, påverkas du. Övergång till en tokenbaserad anslutning rekommenderas.

Hur uppdaterar jag? ios-transition-procedure

Förhandskrav ios-transition-prerequisites

  • Stödet för Tokenbaserad autentisering läge har lagts till i 24.1-utgåvan. Om miljön körs på en äldre version är en förutsättning för den här ändringen att du uppgraderar miljön till senaste Campaign Standarden.

  • Du behöver en signeringsnyckel för APN:s autentiseringstoken för att generera de tokens som servern använder. Du begär den här nyckeln från ditt Apple-utvecklarkonto, vilket förklaras i Dokumentation för Apple Developer.

Övergångsförfarande ios-transition-steps

Så här flyttar du dina iOS-mobilprogram till det tokenbaserade autentiseringsläget:

  1. Bläddra till Administration > Channels > Mobile app (AEP SDK).

  2. Välj det specifika mobilprogram som kräver certifikatuppdateringen.

  3. Kontrollera Update app credentials kryssrutan.

  4. Ange Program-ID (iOS Bundle-ID). Du hittar iOS Bundle ID (App ID) i din apps primära mål i Xcode.

  5. Ladda upp iOS p8-certifikatfil.

  6. Fyll i APN-anslutningsinställningarna Key Id och iOS Team Id.

  7. Klicka på Save.

Ditt iOS-program flyttas nu till det tokenbaserade autentiseringsläget.

Vanliga frågor och svar push-upgrade-faq

Kan vi behålla samma program-ID på scen- och produktinstansen?
För iOS mobilprogram kan du använda samma program-ID, som är ditt iOS-programpaket-ID, för både testnings- och produktionsmiljöer. På Android bör dock program-ID:t vara unikt för varje miljö. Därför föreslår vi att du lägger till"stage" i det program-ID som skapas i mellanlagringsmiljön
Kan vi bara migrera Android-appen?
Nej, både Android- och iOS-program måste migreras enligt stegen ovan.
Vilken typ av verifiering behöver vi utföra efter migreringen?
Vi rekommenderar att du utför funktionsvalidering av alla dina användningsfall som rör push-teknik.
Vad ska du göra när du får felmeddelandet Inte auktoriserad när du sparar mobilappen?
Detta verkar vara ett behörighetsproblem som rör Adobe Experience Platform Data Collection. För att lösa detta måste du lägga till behörigheterna "Konfigurera mobilapp" och "Konfigurera mobilapp" i Adobe Admin Console, enligt beskrivningen i avsnittet Krav i den här artikeln.
Krävs det ändringar i koden för mobilappen?
Nej, endast konfigurationsrelaterade ändringar krävs i Firebase och apputvecklarkontot. Ändringar i kundens mobilapp krävs inte.
Behöver vi uppdatera iOS-certifikatet varje år?
Nej, efter migreringen behöver du inte uppdatera iOS-certifikatet varje år.
Vad händer om migreringen inte är klar?
push-meddelandena från Android börjar misslyckas efter den 20 juni 2024, enligt meddelandet från Google. Läs mer.
Kan kunder migrera tillbaka till FCM när migreringen av FCMv1 är klar?
Ja, kunderna kommer att kunna migrera tillbaka till FCM fram till 20 juni 2024. Efter detta datum är migreringsalternativet inte längre tillgängligt.
Stöds HTTP v1 API-migrering i SDK V4-mobilappen?
Nej, kunderna måste först migrera sin mobilapp till V5 SDK och sedan fortsätta med migreringen ovan. De måste prioritera detta eftersom deras push-tjänst kommer att misslyckas från och med juni 2024, enligt meddelandet från Google.
Påverkar ändringar på sceninstansen produktionsinstansen?
Nej, inga förändringar i mobilappen för scenen påverkar produktionsinstansen.
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff