DokumentationCampaignKampanjtekniker

[v7]{class="badge informative" title="Gäller även Campaign Classic v7"} [v8]{class="badge positive" title="Gäller Campaign v8"}

Push Notification Channel-ändringar push-upgrade

Last update: Mon Mar 18 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å iOS- och Android-enheter. För att kunna göra detta förlitar sig Campaign på prenumerationstjänster för mobilappar.

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.

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.

Adobe Campaign Classic v7 och Adobe Campaign v8 har redan stöd för de senaste API:erna för att skicka push-meddelanden. Vissa gamla implementeringar är dock fortfarande beroende av de äldre API:erna. Dessa implementeringar måste uppdateras.

Påverkas du? fcm-impact

Om din nuvarande implementering stöder prenumerationstjänster som ansluter till FCM med de äldre API:erna påverkas du. Övergång till de senaste API:erna är obligatoriskt för att undvika att tjänster störs. I så fall kommer Adobe-teamen att kontakta dig.

Om du vill kontrollera om du påverkas kan du filtrera Tjänster och prenumerationer enligt filtret nedan:

  • Om någon av dina aktiva push-meddelandetjänster använder HTTP (äldre) API, din konfiguration påverkas direkt av den här ändringen. Du måste granska dina aktuella konfigurationer och gå över till de nyare API:erna som beskrivs nedan.

  • Om din installation endast använder HTTP v1 API för push-meddelanden för Android är du redan kompatibel och ingen ytterligare åtgärd krävs från din sida.

Hur uppdaterar jag? fcm-transition-procedure

Förhandskrav fcm-transition-prerequisites

  • För Campaign Classic v7 har stöd för HTTP v1 lagts till i version 20.3.1. Om miljön körs på en äldre version är en förutsättning för övergången till HTTP v1 att du uppgraderar miljön till senaste Campaign Classicen. För Campaign v8 stöds HTTP v1 av alla versioner och ingen uppgradering behövs.

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

  • För Hybrid-, Hosted- och Managed Services-distributioner ska du, utöver övergångsproceduren nedan, kontakta Adobe för att uppdatera körningsservern för realtid (RT). Servern för MID-Source påverkas inte.

  • Som Campaign Classic v7-användare på plats måste ni uppgradera både marknadsförings- och Real-Time Execution-servrarna. Servern för MID-Source påverkas inte.

Övergångsförfarande fcm-transition-steps

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

  1. Bläddra till din lista över Tjänster och prenumerationer.

  2. Lista alla mobilprogram som använder HTTP (äldre) API-version.

  3. För vart och ett av dessa mobilprogram anger du API-version till HTTP v1.

  4. Klicka på Load project json file to extract project details… för att läsa in JSON-nyckelfilen direkt.

    Du kan även ange följande manuellt:

    • Project Id
    • Private Key
    • Client Email

  5. Klicka Test the connection för att kontrollera att konfigurationen är korrekt och att marknadsföringsservern har åtkomst till FCM. Observera att när det gäller distributioner via medelkällor Test connection kan inte kontrollera om servern har åtkomst till tjänsten Android Firebase Cloud Messaging (FCM).

  6. Som ett alternativ kan du utöka ett push-meddelandeinnehåll med Application variables vid behov. Dessa är helt anpassningsbara och utgör en del av den meddelandenyttolast som skickas till den mobila enheten.

  7. Klicka Finish och sen Save.

Nedan finns FCM-nyttolastsnamnen för att ytterligare anpassa ditt push-meddelande. Dessa alternativ är detaljerade här.

Meddelandetyp
Konfigurerbart meddelandeelement (FCM-nyttolastnamn)
Konfigurerbara alternativ (FCM-nyttolastnamn)
datameddelande
N/A
validate_only
meddelandemeddelande
title, body, android_channel_id, icon, sound, tag, color, click_action, image, ticker, sticky, visibility, notification_priority, notification_count
validate_only
NOTE
När dessa ändringar har tillämpats på alla servrar använder alla nya push-meddelanden som levereras till Android-enheter HTTP v1-API:t. Befintliga push-leveranser som används, pågår och används, använder fortfarande HTTP-API:t (äldre).

Vilken effekt har mina Android-appar? fcm-apps

Det krävs inga specifika ändringar i koden för Android-mobilprogram och meddelandefunktionen bör inte ändras.

Med HTTP v1 kan du dock anpassa push-meddelandena ytterligare med HTTPV1 additional options.

Du kan:

  • Använd Ticker för att ange tickningstexten för meddelandet.
  • Använd Image för att ange bildens URL som ska visas i meddelandet.
  • Använd Notification Count för att ange antalet nya olästa uppgifter som ska visas direkt på programikonen.
  • Ange Sticky till false så att meddelandet automatiskt stängs när användaren klickar på det. Om värdet är true visas meddelandet fortfarande även när användaren klickar på det.
  • Ange Notification Priority nivån på dina meddelanden till standard, minimum, low eller high.
  • Ange Visibility nivån på dina meddelanden till allmänheten, privat eller hemligt.

Mer information finns på HTTP v1 additional options och hur du fyller i dessa fält, se FCM-dokumentation.

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 Classic v7 och Adobe Campaign v8 har stöd för 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.

Om du vill kontrollera om du påverkas kan du filtrera Tjänster och prenumerationer enligt filtret nedan:

  • Om någon av dina aktiva push-meddelandetjänster använder Certifikatbaserad autentisering (.p12) bör dina nuvarande implementeringar granskas och flyttas till en Tokenbaserad autentisering läge (.p8) enligt beskrivningen nedan.

  • Om din installation endast använder Tokenbaserad autentisering för push-meddelanden från iOS är implementeringen redan uppdaterad och ingen ytterligare åtgärd krävs från din sida.

Hur uppdaterar jag? ios-transition-procedure

Förhandskrav ios-transition-prerequisites

  • För Campaign Classic v7 har Tokenbaserad autentisering Läget har lagts till i version 20.2. 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 Classicen. För Campaign v8, Tokenbaserad autentisering läge stöds av alla versioner och ingen uppgradering behövs.

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

  • För Hybrid-, Hosted- och Managed Services-distributioner ska du, utöver övergångsproceduren nedan, kontakta Adobe för att uppdatera körningsservern för realtid (RT). Servern för MID-Source påverkas inte.

  • Som Campaign Classic v7-användare på plats måste ni uppgradera både marknadsförings- och Real-Time Execution-servrarna. Servern för MID-Source påverkas inte.

Övergångsförfarande ios-transition-steps

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

  1. Bläddra till din lista över Tjänster och prenumerationer.

  2. Lista alla mobilprogram som använder Certifikatbaserad autentisering mode (.p12).

  3. Redigera vart och ett av dessa mobilprogram och gå till Certifikat/privat nyckel -fliken.

  4. Från Autentiseringsläge nedrullningsbar meny, välja Tokenbaserad autentisering mode (.p8).

  5. Fyll i APN-anslutningsinställningarna Key Id, Team Id och Bundle Id välj sedan ditt p8-certifikat genom att klicka på Enter the private key….

  6. Klicka Test the connection för att kontrollera att konfigurationen är korrekt och att servern har åtkomst till APN:er. Observera att när det gäller distributioner via medelkällor Test connection -knappen kan inte kontrollera om servern har åtkomst till APN:er.

  7. Klicka Next för att börja konfigurera produktionsprogrammet och följa de steg som beskrivs ovan.

  8. Klicka Finish och sen Save.

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

recommendation-more-help
c14bd44c-7b5f-474a-888d-1c2baee5a247