DocumentatieCampaignCampagne-technologie

[v7]{class="badge informative" title="Ook van toepassing op Campaign Classic v7"} [v8]{class="badge positive" title="Is van toepassing op campagne v8"}

Wijzigingen in het kanaal voor pushmeldingen push-upgrade

Last update: Wed Sep 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ervaren
  • Beheerder

Met Campagne kunt u pushmeldingen verzenden op iOS- en Android-apparaten. Hiervoor is de campagne afhankelijk van abonnementsservices voor mobiele toepassingen.

Enkele belangrijke wijzigingen in de Android Firebase Cloud Messaging (FCM)-service worden in 2024 gepubliceerd en kunnen van invloed zijn op uw Adobe Campaign-implementatie. Mogelijk moet uw configuratie met abonnementsservices voor Android-pushberichten worden bijgewerkt om deze wijziging te ondersteunen.

Bovendien adviseert de Adobe hoogst om naar de op teken-gebaseerde verbinding aan APNs eerder dan een op certificaat-gebaseerde verbinding te bewegen, die veiliger en scalable is.

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

Wat is er veranderd? fcm-changes

Als deel van Google dat voortdurend probeert om zijn diensten te verbeteren, zal erfenis FCM APIs op 22 Juli, 2024 worden opgeheven. Leer meer over het protocol van HTTP van het Overseinen van de Wolk van de Wolk van de Wolk van de Vuurstand van de Wolk van de Vuurstand van de Wolk van de Vuurstand in Google documentatie.

Adobe Campaign Classic v7 en Adobe Campaign v8 ondersteunen al de nieuwste API's voor het verzenden van pushberichten. Sommige oude implementaties zijn echter nog steeds afhankelijk van de oudere API's. Deze implementaties moeten worden bijgewerkt.

Heb je invloed op? fcm-impact

Als uw huidige implementatie ondersteuning biedt voor abonnementsservices die verbinding maken met FCM via de verouderde API's, heeft dit gevolgen voor u. De overgang naar de nieuwste API's is verplicht om elke onderbreking van de service te voorkomen. In dat geval zullen de teams van de Adobe u bereiken.

Om te controleren als u wordt beïnvloed, kunt u uw Diensten en Abonnementen zoals per filter hieronder filtreren:

  • Als om het even welk van uw actieve dienst van het pushbericht HTTP (erfenis) API gebruikt, zal uw opstelling direct door deze verandering worden beïnvloed. U moet uw huidige configuraties controleren en naar de nieuwere API's gaan zoals hieronder wordt beschreven.

  • Als uw opstelling uitsluitend HTTP v1 API voor de duw berichten van Android gebruikt, dan bent u reeds in naleving en geen verdere actie zal op uw kant worden vereist.

Hoe kan ik bijwerken? fcm-transition-procedure

Vereisten fcm-transition-prerequisites

  • Het JSON-bestand van de Android Firebase Admin SDK-service is nodig om de mobiele toepassing naar HTTP v1 te verplaatsen. Leer hoe te om dit dossier in documentatie van de Vuurbasis van Googlete krijgen .

  • Voor Campaign Classic v7 is de ondersteuning van HTTP v1 toegevoegd in versie 20.3.1. Als uw milieu op een oudere versie loopt, moet een eerste vereiste voor de overgang aan HTTP v1 uw milieu bevorderen aan het recentste Campaign Classic bouwen. Voor Campagne v8 wordt HTTP v1 door alle versies gesteund, en geen verbetering is nodig.

  • Als Campaign Classic v7 on-premise gebruiker, moet u zowel de Marketing als Real-Time uitvoeringsservers bevorderen.

  • Voor Hybride, Gehoste en Beheerde plaatsingen van Cloud Servicen, naast de overgangsprocedure hieronder, contacteer Adobe om uw Real-Time (RT) uitvoeringsserver bij te werken.

  • Informatie over de Android die externe account routeert:

    • Als Campaign Classic v7 on-premise of hybride gebruiker, controleer dat uw Android die externe rekening verplettert met androidPushConnectorV2.js wordt gevormd. Leer meer in Campaign Classic v7 documentatie.

    • Voor de implementatie van hybride, gehoste en beheerde Cloud Servicen moet u ook verbinding maken met het zorgteam van de Adobe om te controleren of de androidPushConnectorV2.js (nms) -aansluiting is geselecteerd in Android die een externe account van uw mediumsourcingserver routeert.

Overgangprocedure fcm-transition-steps

Ga als volgt te werk om uw omgeving te verplaatsen naar HTTP v1:

  1. Blader naar uw lijst van Diensten en Abonnementen.

  2. Maak een lijst van alle mobiele toepassingen gebruikend de HTTP (erfenis) API versie.

  3. Voor elk van deze mobiele toepassingen, plaats de API versie aan HTTP v1.

  4. Klik op de koppeling Load project json file to extract project details… om het JSON-sleutelbestand rechtstreeks te laden.

    U kunt ook handmatig de volgende gegevens invoeren:

    • Project Id
    • Private Key
    • Client Email

  5. Klik op Test the connection om te controleren of uw configuratie correct is en of de marketingserver toegang heeft tot de FCM. Voor Mid-sourcing-implementaties kan met de knop Test connection niet worden gecontroleerd of de server toegang heeft tot de FCM-service (Firebase Cloud Messaging) van Android.

  6. U kunt desgewenst ook de inhoud van een pushbericht verrijken met wat Application variables . Deze zijn volledig aanpasbaar en een deel van de berichtlading wordt verzonden naar het mobiele apparaat.

  7. Klik op Finish en vervolgens op Save.

    Hieronder vindt u de namen van FCM-ladingen om uw pushmelding verder aan te passen. Deze opties zijn gedetailleerd hier.

    table 0-row-3 1-row-3 2-row-3 1-align-center 2-align-center 3-align-center 5-align-center 6-align-center 7-align-center 9-align-center 10-align-center 11-align-center
    Berichttype Configureerbaar berichtelement (FCM-ladenaam) Configureerbare opties (FCM-ladenaam)
    gegevensbericht N.v.t. validate_only
    meldingsbericht title, body, android_channel_id, icon, sound, tag, color, click_action, image, ticker, sticky, visibility, notification_priority, notification_count validate_only
NOTE
Zodra deze veranderingen in al uw server worden toegepast, gebruiken alle nieuwe het bericht van de duw aan de apparaten van Android v1 API van HTTP. Bestaande push-items worden opnieuw uitgevoerd, in uitvoering en in gebruik, maar gebruiken nog steeds de HTTP (legacy) API. Leer hoe u ze in de onderstaande sectie kunt bijwerken.

Bestaande sjablonen bijwerken fcm-transition-update

Zodra de overgangHTTP v1 wordt gedaan, moet u uw leveringsmalplaatjes voor de duw berichten van Android bijwerken om het aantal partijberichten te verhogen. Om dit te doen, doorblader aan de eigenschappen van uw Android leveringsmalplaatje en, in het lusje van de Levering, plaats de Hoeveelheid van de Batch van het Berichtaan 256. Pas deze wijziging toe op alle leveringssjablonen die worden gebruikt voor uw Android-leveringen en op al uw bestaande Android-leveringen.

U kunt ook bestaande leverings- en leveringssjablonen bijwerken die zijn gemaakt vóór de upgrade naar een versie die HTTP v1 ondersteunt. Dit doet u als volgt:

  • Als Beheerde Cloud Servicen of Gehoste klant, contacteer Adobe om uw bestaande Android leveringsmalplaatjes bij te werken.

  • Voor on-premise omgevingen downloadt u het fcm-httpv1-migration.js -script en voert u dit hieronder uit.

    Download fcm-httpv1-migration.zip.

    note caution
    CAUTION
    Het script moet worden uitgevoerd op uw on-premise marketinginstantie.
    accordion
    Stappen om bestaande leveringen en sjablonen bij te werken (alleen op locatie)

    Voer de volgende stappen uit om alle leverings- en leveringstemplates te repareren die zijn gemaakt vóór de upgrade naar een versie die HTTP v1 ondersteunt:

    1. Exporteer uw bestaande leverings- en leveringssjablonen in een pakket, zodat u deze kunt herstellen in het geval van een onverwacht probleem tijdens de patches.

    2. Voer de volgende opdracht in Posgresql uit:

      code language-sql 
      pg_dump -Fp -f /sftp/<db_name>-nmsdelivery-before_rd_script.sql -t nmsdelivery -d <db_name>

    3. Standaard staat het script in de modus dryrun en kunt u het in die modus starten om te controleren of een deel van de levering moet worden gerepareerd.

      Opdracht

      code language-sql 
      nlserver javascript -instance:<instance_name> -file fcm-httpv1-migration.js

      Uitvoer

      code language-sql 
      ...
HH:MM:SS >   Processing delivery (id:123456,  label:'Deliver on Android - New', name:'DM1234')
HH:MM:SS >   Dry run: Would update androidCheckParams for delivery (id:123456,  label:'Deliver on Android - New', name:'DM1234')
HH:MM:SS >   Processing delivery (id:567890,  label:'Deliver on Android - New', name:'DM5678')
HH:MM:SS >   Dry run: Would update androidCheckParams for delivery (id:567890,  label:'Deliver on Android - New', name:'DM5678')
...
HH:MM:SS >   Summary (XYZ processed deliverie(s) or delivery template(s)):
HH:MM:SS >>  - X had not patchable androidCheckParams formula!
HH:MM:SS >   - Y had androidCheckParams formula patched.
HH:MM:SS >   - Z ignored as alreading having androidCheckParams formula patched.
      note note
      NOTE
      De not patchable -leveringen moeten handmatig worden bijgewerkt. Hun ID is te vinden in het logboek.

    4. Voer het script op de uitvoeringsmodus als volgt uit om leveringen bij te werken:

      code language-sql 
      nlserver javascript -instance:<instance_name> -file fcm-httpv1-migration.js -arg:run

Wat is het effect op mijn Android-apps? fcm-apps

Er zijn geen specifieke wijzigingen vereist in de code van de Android Mobile-toepassingen en het meldingsgedrag moet niet worden gewijzigd.

Met HTTP v1 kunt u uw pushmelding echter verder aanpassen met HTTPV1 additional options .

U kunt:

  • Gebruik het veld Ticker om de tekst van de markering van uw melding in te stellen.
  • Gebruik het veld Image om de URL van de afbeelding in te stellen die in de melding moet worden weergegeven.
  • Gebruik het veld Notification Count om het aantal nieuwe ongelezen gegevens in te stellen dat rechtstreeks op het toepassingspictogram moet worden weergegeven.
  • Stel de optie Sticky in op false, zodat het bericht automatisch wordt gesloten wanneer de gebruiker erop klikt. Indien ingesteld op true, wordt het bericht nog steeds weergegeven, zelfs wanneer de gebruiker erop klikt.
  • Stel het Notification Priority -niveau van uw melding in op standaard, minimum, laag of hoog.
  • Stel het Visibility -niveau van uw melding in op openbaar, privé of geheim.

Voor meer op HTTP v1 additional options en hoe te om deze gebieden te vullen, verwijs naar documentatie FCM.

Apple iOS Push Notification Service (APNs) apns-push-upgrade

Wat is er veranderd? ios-changes

Zoals aanbevolen door Apple, moet u uw communicatie met de APNs (Apple Push Notification service) beveiligen door stateless verificatietokens te gebruiken.

Token-gebaseerde authentificatie biedt een stateless manier om met APNs te communiceren. Stateloze communicatie is sneller dan op certificaat-gebaseerde communicatie omdat het geen APNs vereist om het certificaat, of andere informatie, met betrekking tot uw leverancierserver op te zoeken. Er zijn andere voordelen aan het gebruiken van op teken-gebaseerde authentificatie:

  • U kunt hetzelfde token gebruiken van meerdere providerservers.

  • U kunt één token gebruiken om meldingen te distribueren voor alle apps van uw bedrijf.

Leer meer over op token-gebaseerde verbindingen aan APNs in de documentatie van de Ontwikkelaar van Apple.

Adobe Campaign Classic v7 en Adobe Campaign v8 ondersteunen zowel tokengebaseerde als op certificaten gebaseerde verbindingen. Als uw implementatie afhankelijk is van een verbinding op basis van een certificaat, raadt de Adobe u ten zeerste aan om deze bij te werken naar een tokenverbinding.

Heb je invloed op? ios-impact

Als uw huidige implementatie afhankelijk is van op een certificaat gebaseerde aanvragen om verbinding te maken met APNs, heeft dit gevolgen voor u. De overgang naar een op een token gebaseerde verbinding wordt aanbevolen.

Om te controleren als u wordt beïnvloed, kunt u uw Diensten en Abonnementen zoals per filter hieronder filtreren:

  • Als om het even welk van uw actieve dienst van het pushbericht de op certificaat-gebaseerde authentificatie wijze (.p12) gebruikt, zouden uw huidige implementaties moeten worden herzien en naar a op token-gebaseerde authentificatie wijze (.p8) worden bewogen zoals hieronder beschreven.

  • Als uw opstelling exclusief de op token-gebaseerde authentificatie wijze voor de pushberichten van iOS gebruikt, dan is uw implementatie reeds bijgewerkt en geen verdere actie van uw kant zal worden vereist.

Hoe kan ik bijwerken? ios-transition-procedure

Vereisten ios-transition-prerequisites

  • Voor Campaign Classic v7, is de steun van op token-gebaseerde authentificatie wijze toegevoegd in versie 20.2. Als uw milieu op een oudere versie loopt, is een voorwaarde voor deze verandering uw milieu aan het recentste Campaign Classic te bevorderen bouwt. Voor Campagne v8, op token-gebaseerde authentificatie wordt wijze gesteund door alle versies, en geen verbetering is nodig.

  • U hebt een APNs-verificatietoken voor ondertekening nodig om de tokens te genereren die uw server gebruikt. U vraagt deze sleutel van uw Apple ontwikkelaarsrekening, zoals die in documentatie van de Ontwikkelaar van Applewordt verklaard.

  • Voor hybride, Gehoste en Managed Services plaatsingen, naast de hieronder overgangsprocedure, contacteer Adobe om uw Real-Time (RT) uitvoeringsserver bij te werken. De server voor middelste bronnen heeft geen invloed op deze server.

  • Als Campaign Classic v7 on-premise gebruiker, moet u zowel de Marketing als Real-Time uitvoeringsservers bevorderen. De server voor middelste bronnen heeft geen invloed op deze server.

Overgangprocedure ios-transition-steps

Voer de volgende stappen uit om uw mobiele iOS-toepassingen te verplaatsen naar de op token gebaseerde verificatiemodus:

  1. Blader naar uw lijst van Diensten en Abonnementen.

  2. Maak een lijst van alle mobiele toepassingen gebruikend de op certificaat-gebaseerde authentificatie wijze (.p12).

  3. Bewerk elk van deze mobiele toepassingen en blader naar het Certificaat/Persoonlijke sleutel lusje.

  4. Van de drop-down Wijze van de Authentificatie, uitgezochte op token-gebaseerde authentificatie wijze (.p8).

  5. Vul de instellingen voor de APNs-verbinding Key Id , Team Id en Bundle Id in en selecteer vervolgens het p8-certificaat door op Enter the private key… te klikken.

  6. Klik op Test the connection om te controleren of de configuratie juist is en of de server toegang heeft tot APN's. Voor implementaties van Midden-bronnen kan de knop Test connection niet controleren of de server toegang heeft tot APN's.

  7. Klik op Next om de productietoepassing te configureren en dezelfde stappen uit te voeren als hierboven beschreven.

  8. Klik op Finish en vervolgens op Save.

Uw iOS-toepassing wordt nu verplaatst naar de op token gebaseerde verificatiemodus.

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