DocumentatieCampaignDocumentatie voor Campaign v8

Pushmeldingskanaal configureren push-notification-configuration

Last update: Mon Mar 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • tussenpersoon
  • Beheerder
  • Ontwikkelaar

Als u pushmeldingen wilt verzenden met Adobe Campaign, moet u eerst uw omgeving en app configureren zoals in deze pagina wordt beschreven. In Adobe Campaign is het kanaal voor het verzenden van pushmeldingen het mobiele app-kanaal.

CAUTION
In 2024 komt er een versie met enkele belangrijke wijzigingen voor de service FCM (Android Firebase Cloud Messaging). Deze kunnen van invloed zijn op uw Adobe Campaign-implementatie. De configuratie van uw lidmaatschapsservices voor Android-pushberichten moet mogelijk worden bijgewerkt om deze wijziging te ondersteunen. U kunt al controleren en actie ondernemen. Meer informatie.

Voordat u pushberichten met Adobe Campaign gaat verzenden, moet u ervoor zorgen dat er configuraties en integratie zijn in de mobiele app en voor tags in Adobe Experience Platform. Adobe Experience Platform Mobile SDK biedt client-side integratie-API's voor uw mobiele apparaten via met Android en iOS compatibele SDK's.

Voer de volgende stappen uit om uw app in te stellen met Adobe Experience Platform Mobile SDK's:

  1. Controleren voorwaarden.
  2. Een eigenschap mobile tag in Adobe Experience Platform Data Collection.
  3. De Adobe Experience Platform Mobile SDK ophalen als gedetailleerd op deze pagina.
  4. (optioneel) Schakel registratie- en levenscyclusmetriek in als gedetailleerde op deze pagina.
  5. (optioneel) Toevoegen Adobe Experience Platform Assurance voor uw app to validate your implementation. Learn how to implement Adobe Experience Platform Assurance extension in this page.
  6. Configureer uw mobiele iOS- en Android-services in Adobe Campaign als gedetailleerd op deze pagina.
  7. Installeren en configureren Adobe Campaign-extensie in uw eigenschap mobile.
  8. Volgen Adobe Experience Platform Mobile SDK-documentatie voor installatie met Adobe Experience Platform Mobile SDK's in uw app.

Vereisten before-starting

Machtigingen instellen setup-permissions

Voordat u een mobiele toepassing maakt, moet u er eerst voor zorgen dat u over de juiste gebruikersmachtigingen voor tags in Adobe Experience Platform beschikt of deze toewijst. Gebruikersmachtigingen voor tags in Adobe Experience Platform worden aan gebruikers toegewezen via Adobe Admin Console. Meer informatie in Documentatie over tags.

CAUTION
De duimconfiguratie moet door een deskundige gebruiker worden uitgevoerd. Afhankelijk van uw implementatiemodel en de personen die bij deze implementatie zijn betrokken, moet u mogelijk de volledige set machtigingen toewijzen aan één productprofiel of machtigingen delen tussen de ontwikkelaar van de app en de ontwikkelaar van de Adobe Campaign beheerder.

Om Eigenschap en Bedrijf rechten, volgt u de onderstaande stappen:

  1. Toegang krijgen tot de Admin Console.

  2. Van de Products selecteert u de Adobe Experience Platform Data Collection kaart.

  3. Bestaande selecteren Product Profile of maak een nieuwe versie met de New profile knop. Leer hoe u een nieuwe New profile in de Documentatie voor beheerconsole.

  4. Selecteer op het tabblad Permissions de optie Property Rights.

  5. Klik op Add all. Hiermee voegt u het volgende recht toe aan uw productprofiel:

    • Approve
    • Develop
    • Edit Property
    • Manage Environments
    • Manage Extensions
    • Publish

    Deze machtigingen zijn vereist voor het installeren en publiceren van de Adobe Campaign-extensie en het publiceren van de app-eigenschap in Adobe Experience Platform Mobile SDK.

  6. Selecteer vervolgens Company rights in het linkermenu.

  7. Voeg de volgende rechten toe:

    • Manage App Configurations
    • Manage Properties

    Deze machtigingen zijn vereist voor de ontwikkelaar van de mobiele app om pushgegevens in te stellen in Adobe Experience Platform-gegevensverzameling.

  8. Klik op Save.

Om dit toe te wijzen Product profile aan gebruikers, volg de hieronder stappen:

  1. Toegang krijgen tot de Admin Console.

  2. Van de Products selecteert u de Adobe Experience Platform Data Collection kaart.

  3. Selecteer de eerder geconfigureerde Product profile.

  4. Klik op het tabblad Users op Add user.

  5. Typ de naam of het e-mailadres van uw gebruiker en selecteer de gebruiker. Klik vervolgens op Save.

    note note
    NOTE
    Als de gebruiker niet eerder in de Admin console werd gecreeerd, verwijs naar Gebruikersdocumentatie toevoegen.

Uw app configureren configure-app

De technische opstelling impliceert nauwe samenwerking tussen de toepassingsontwikkelaar en bedrijfsbeheerder. Voordat u begint met het verzenden van pushberichten met Adobe Campaign, moet u instellingen definiëren in Adobe Experience Platform Data Collection en integreer uw mobiele app met Adobe Experience Platform Mobile SDK's.

Voer de implementatiestappen uit die in de onderstaande koppelingen worden beschreven:

  • Voor Apple iOS: Leer hoe u uw app bij APN's kunt registreren in Apple-documentatie
  • Voor Google Android: Leer hoe u een Firebase Cloud Messaging-clienttoepassing op Android instelt in Google-documentatie

Een eigenschap voor een mobiele tag instellen in de gegevensverzameling van Adobe Experience Platform launch-property

Als u een eigenschap voor mobiele apparaten instelt, kan de ontwikkelaar of markator van de mobiele app de mobiele SDK's configureren. Doorgaans maakt u een eigenschap voor mobiele apparaten voor elke mobiele toepassing die u wilt beheren. Leer hoe u een mobiele eigenschap kunt maken en configureren in Adobe Experience Platform Mobile SDK-documentatie.

Meer informatie over Adobe Experience Platform Data Collection tags in Adobe Experience Platform-documentatie.

Nadat u de nieuwe eigenschap tag hebt gemaakt, opent u de nieuwe eigenschap tag en maakt u een bibliotheek. Dit doet u als volgt:

  1. Bladeren naar Publishing Flow in de linkernavigatie en selecteer Bibliotheek toevoegen.
  2. Voer de naam van de bibliotheek in en selecteer de omgeving.
  3. Selecteren Alle gewijzigde bronnen toevoegen, en Opslaan en samenstellen voor ontwikkeling.
  4. Stel ten slotte deze bibliotheek in als de werkbibliotheek in het dialoogvenster Een werkbibliotheek selecteren knop.

Uw mobiele services configureren in Campagne push-service

Zodra uw mobiele app is ingesteld in Adobe Experience Platform Data Collection, moet u twee services maken (één voor iOS-apparaten, één voor Android-apparaten) om pushberichten te kunnen verzenden van Adobe Campaign.

Pushberichten worden via een speciale service naar gebruikers van de app verzonden. Wanneer gebruikers uw app installeren, abonneren zij zich op deze service: Adobe Campaign vertrouwt op deze service om alleen de abonnees van uw app als doel in te stellen. In deze service moet u uw iOS- en Android-apps toevoegen om op iOS- en Android-apparaten te verzenden.

Voer de onderstaande stappen uit om een service te maken voor het verzenden van pushberichten:

  1. Bladeren naar Profiles and Targets > Services and Subscriptions en klikt u op Create.

    {width="800"}

  2. Voer een Label en Internal name en selecteert u een Mobile application type.

    note note
    NOTE
    De standaardwaarde Subscriber applications (nms:appSubscriptionRcp) doeltoewijzing is gekoppeld aan de tabel met ontvangers. Als u een andere doelafbeelding wilt gebruiken, moet u een nieuwe doeltoewijzing maken en deze invoeren in het dialoogvenster Target mapping van de dienst. Meer informatie over doeltoewijzingen in deze pagina.

  3. Gebruik vervolgens de Add pictogram aan de rechterkant om de mobiele toepassingen te definiëren die deze service gebruiken.

iOS

Ga als volgt te werk om een app voor iOS-apparaten te maken:

  1. Selecteer Create an iOS application en klik op Next.

    {width="600"}

  2. Voer de naam van uw app in het dialoogvenster Label veld.

  3. (optioneel) U kunt 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.

    In het onderstaande voorbeeld wordt mediaURl en mediaExt variabelen worden toegevoegd om uitgebreide pushmeldingen te maken en geven de toepassing de afbeelding die binnen het bericht moet worden weergegeven.

    {width="600"}

  4. Bladeren naar de Subscription parameters tabblad om de toewijzing te definiëren met een extensie van de optie Subscriber applications (nms:appsubscriptionRcp) schema.

  5. Bladeren naar de Sounds om het af te spelen geluid te definiëren. Klikken Add en vullen Internal name veld dat de naam moet bevatten van het bestand dat is ingesloten in de toepassing of de naam van het systeemgeluid.

  6. Klikken Next om de ontwikkelingstoepassing te configureren.

  7. De integratiesleutel is specifiek voor elke toepassing. De mobiele toepassing wordt aan Adobe Campaign gekoppeld.

    Zorg ervoor dat hetzelfde Integration key wordt gedefinieerd in Adobe Campaign en in de toepassingscode via de SDK.

    Meer informatie in de documentatie voor ontwikkelaars

    note note
    NOTE
    De Integration key is volledig aanpasbaar met tekenreekswaarde, maar moet exact hetzelfde zijn als de waarde die in de SDK is opgegeven.
    U kunt niet hetzelfde certificaat gebruiken voor de ontwikkelingsversie (sandbox) en de productieversie van de toepassing.

  8. Selecteer het pictogram in het menu Application icon om de mobiele toepassing in uw service aan te passen.

  9. Selecteer het Authentication mode. Er zijn twee modi beschikbaar:

    • (Aanbevolen) Token-based authentication: Vul de verbindingsinstellingen van APNs in Key Id, Team Id en Bundle Id Selecteer vervolgens uw p8-certificaat door op Enter the private key…. Voor meer informatie Token-based authentication, zie Apple-documentatie.

    • Certificate-based authentication: Klikken Enter the certificate… Selecteer vervolgens de p12-toets en voer het wachtwoord in dat de ontwikkelaar van de mobiele toepassing heeft opgegeven. Dit certificaat heeft een vervaldatum en moet jaarlijks worden vernieuwd. Om een onderbreking van de dienst voor uw gebruikers te vermijden, werk uw certificaten bij alvorens zij verlopen. Certificaten zijn een jaar geldig en u moet ze bijwerken om te kunnen blijven communiceren met APN's.

  10. Gebruik de Test the connection knoop om uw configuratie te bevestigen.

  11. Klikken Next om de productietoepassing te configureren en dezelfde stappen uit te voeren als hierboven beschreven.

  12. Klik op Finish.

Uw iOS-toepassing kan nu worden gebruikt in Campagne.

Android

Voer de volgende stappen uit om een app voor Android-apparaten te maken:

  1. Selecteer Create an Android application en klik op Next.

    {width="600"}

  2. Voer de naam van uw app in het dialoogvenster Label veld.

  3. De integratiesleutel is specifiek voor elke toepassing. De mobiele toepassing wordt aan Adobe Campaign gekoppeld.

    Zorg ervoor dat hetzelfde Integration key wordt gedefinieerd in Adobe Campaign en in de toepassingscode via de SDK.

    Meer informatie in de documentatie voor ontwikkelaars

    note note
    NOTE
    De Integration key is volledig aanpasbaar met tekenreekswaarde, maar moet exact hetzelfde zijn als de waarde die in de SDK is opgegeven.

  4. Selecteer het pictogram in het menu Application icon om de mobiele toepassing in uw service aan te passen.

  5. Selecteren HTTP v1 in API version vervolgkeuzelijst.

  6. Klikken Load project json file to extract project details… koppeling om uw JSON-sleutelbestand te laden. Voor meer informatie over het uitpakken van uw JSON-bestand raadpleegt u Google Firebase-documentatie.

    U kunt ook handmatig de volgende gegevens invoeren:

    • Project Id
    • Private Key
    • Client Email

  7. Gebruik de Test the connection knoop om uw configuratie te bevestigen.

    note caution
    CAUTION
    De Test connection controleert niet of de MID-server toegang heeft tot de FCM-server.

  8. (optioneel) U kunt de inhoud van een pushbericht verrijken met wat Application variables indien nodig. Deze zijn volledig aanpasbaar en een deel van de berichtlading wordt verzonden naar het mobiele apparaat.

  9. Klikken Finish dan Save. Uw Android-toepassing kan nu worden gebruikt in Campagne.

Hieronder vindt u de namen van FCM-ladingen om uw pushmelding verder aan te passen:

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

Adobe Campaign-extensie configureren in uw mobiele eigenschap configure-extension

De Adobe Campaign Classic-extensie voor Adobe Experience Platform Mobile SDK's kunt u pushmeldingen voor uw mobiele apps maken en gebruikers-pushtokens verzamelen en interactiemetingen beheren met Adobe Experience Platform-services.

Deze extensie, die van toepassing is op Campaign Classic v7 en Campagne v8, is vooraf geïnstalleerd op uw omgeving en moet worden geconfigureerd. Voer de volgende stappen uit om de extensie voor de eigenschap mobile tag te configureren:

  1. Open de eigenschap tag die u eerder hebt gemaakt.
  2. Blader vanuit de linkernavigatie naar Extensies en opent u de Catalogus tab. Gebruik het zoekveld om het Adobe Campaign Classic extensie.
  3. Klik op de kaart van het Campaign Classic op Installeren knop.
  4. Instellingen invoeren zoals beschreven in Adobe Experience Platform Mobile SDK-documentatie.

U kunt nu campagne toevoegen aan uw app, zoals wordt beschreven in Adobe Experience Platform Mobile SDK-documentatie.

recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b