DokumentationCampaignDokumentation om Campaign Standard

Ändringar i push-meddelandekanalen push-upgrade

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Erfaren
  • Administratör

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, vilket kan påverka implementeringen av Adobe Campaign. Din prenumerationstjänstkonfiguration för Android push-meddelanden 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 den 20 juni 2024. Läs mer om HTTP-protokollet för meddelanden i Firebase Cloud i Google Firebase-dokumentationen.

Från och med 24.1-utgåvan stöder Adobe Campaign Standard HTTP v1-API:erna för att skicka push-meddelanden från 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öd för läget HTTP v1 API har lagts till i version 24.1. Om din miljö körs på en äldre version är en förutsättning för den här ändringen att du uppgraderar miljön till den senaste Campaign Standarden.

  • Android Firebase Admin SDK-tjänstens konto-JSON-fil 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-dokumentationen.

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

  • Kontrollera att du har behörighet Mobile App Configuration 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. Gå till Administration > Channels > Mobile app (AEP SDK).

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

  3. Markera kryssrutan Update app credentials.

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

  5. Ladda upp din JSON-nyckelfil för privat nyckel från Android.

  6. Klicka på knappen Spara.

NOTE
När dessa ändringar har tillämpats används HTTP v1-API:t för alla nya push-meddelandeleveranser till Android-enheter. 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 dokumentationen 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öd för tokenbaserad autentisering har lagts till i 24.1-versionen. Om din miljö körs på en äldre version är en förutsättning för den här ändringen att du uppgraderar miljön till den 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 Apple Developer-dokumentationen.

Övergångsförfarande ios-transition-steps

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

  1. Gå till Administration > Channels > Mobile app (AEP SDK).

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

  3. Markera kryssrutan Update app credentials.

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

  5. Överför din 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. I 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-appar 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?
Android push-meddelanden kommer att börja misslyckas efter den 20 juni 2024, enligt Google anmälan. 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