Pushmeldingskanaal configureren push-notification-configuration
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.
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:
- Controle eerste vereisten.
- Opstelling a mobiel markeringsbezitin de Inzameling van Gegevens van Adobe Experience Platform.
- Krijg Adobe Experience Platform Mobile SDK zoals gedetailleerd in deze pagina.
- (facultatief) laat registreren en levenscyclusmetriek toe, zoals gedetailleerd in deze pagina.
- (facultatief) voeg Adobe Experience Platform Assurance aan uw apptoe om uw implementatie te bevestigen. Leer hoe te om de uitbreiding van Adobe Experience Platform Assurance in deze paginauit te voeren .
- Vorm uw mobiele diensten van iOS en van Android in Adobe Campaign zoals gedetailleerd in deze pagina.
- Installeer en vorm Uitbreiding van Adobe Campaignin uw mobiel bezit.
- Volg de Mobiele documentatie van SDK van Adobe Experience Platform Mobileom opstelling met Adobe Experience Platform Mobile SDKs in uw app te krijgen.
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. Leer meer in documentatie van Markeringen.
Om Bezit en bedrijf rechten toe te wijzen, volg hieronder de stappen:
-
Open de lus Admin Console .
-
Selecteer op het tabblad Products de Adobe Experience Platform Data Collection -kaart.
-
Selecteer een bestaande Product Profile of maak een nieuwe New profile met de knop. Leer hoe te om tot een nieuw New profile in de Admin consoledocumentatiete leiden.
-
Selecteer op het tabblad Permissions de optie Property Rights.
-
Klik op Add all. Hiermee voegt u het volgende recht toe aan uw productprofiel:
- Approve
- Develop
- Edit Property
- Manage Environments
- Manage Extensions
- Publish
Deze toestemmingen worden vereist om de uitbreiding van Adobe Campaign te installeren en te publiceren, en app bezit in Adobe Experience Platform Mobile SDK te publiceren.
-
Selecteer vervolgens Company rights in het linkermenu.
-
Voeg de volgende rechten toe:
- Manage App Configurations
- Manage Properties
Deze toestemmingen worden vereist voor de mobiele toepassingsontwikkelaar aan opstellings dupgeloofsbrieven in de Inzameling van Gegevens van Adobe Experience Platform.
-
Klik op Save.
Volg onderstaande stappen om deze Product profile aan gebruikers toe te wijzen:
-
Open de lus Admin Console .
-
Selecteer op het tabblad Products de Adobe Experience Platform Data Collection -kaart.
-
Selecteer de eerder geconfigureerde Product profile.
-
Klik op het tabblad Users op Add user.
-
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 console Admin werd gecreeerd, verwijs naar gebruikersdocumentatietoevoegen.
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 uw mobiele app integreren met Adobe Experience Platform Mobile SDK's.
Voer de implementatiestappen uit die in de onderstaande koppelingen worden beschreven:
- Voor Apple iOS: Leer hoe te om uw app met APNs in Documentatie van Applete registreren
- Voor Google Android: Leer hoe te opstelling een de cliëntapp van het Overseinen van de Wolk van de Wolk van de Vuurbasis op Android in Documentatie van Google
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 te om een mobiel bezit in Adobe Experience Platform Mobiele documentatie van SDKtot stand te brengen en te vormen .
Leer meer over Adobe Experience Platform Data Collection markeringen in documentatie van Adobe Experience Platform.
Nadat u de nieuwe eigenschap tag hebt gemaakt, opent u de nieuwe eigenschap tag en maakt u een bibliotheek. Dit doet u als volgt:
- Blader aan het Publiceren Stroom in de linkernavigatie en selecteer Bibliotheek toevoegen.
- Voer de naam van de bibliotheek in en selecteer de omgeving.
- Selecteer toevoegen Alle Gewijzigde Middelen, en sparen en bouwen aan ontwikkeling.
- Tot slot plaats deze bibliotheek als uw werkende bibliotheek van Uitgezochte een werkende bibliotheek knoop.
Uw mobiele services configureren in Campagne push-service
Wanneer uw mobiele app is ingesteld in Adobe Experience Platform Data Collection , moet u twee services maken (een voor iOS-apparaten, een voor Android-apparaten) om pushmeldingen te kunnen verzenden vanuit 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 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:
-
Blader naar de tab Profiles and Targets > Services and Subscriptions en klik op Create .
-
Voer een Label en een Internal name in en selecteer een Mobile application -type.
note note NOTE De standaarddoeltoewijzing Subscriber applications (nms:appSubscriptionRcp) 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 veld Target mapping van de service. Leer meer over doelafbeeldingen in deze pagina. -
Vervolgens gebruikt u het pictogram Add rechts in het scherm om de mobiele toepassingen te definiëren die deze service gebruiken.
Ga als volgt te werk om een app voor iOS-apparaten te maken:
-
Selecteer Create an iOS application en klik op Next.
-
Voer in het veld Label de naam van uw toepassing in.
-
(optioneel) U kunt 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 voorbeeld hieronder, worden mediaURl en mediaExt variabelen toegevoegd om rijke pushmelding tot stand te brengen en dan de toepassing van het beeld te voorzien om binnen het bericht te tonen.
-
Blader naar het tabblad Subscription parameters om de toewijzing te definiëren met een extensie van het schema Subscriber applications (nms:appsubscriptionRcp) .
-
Blader naar het tabblad Sounds om het af te spelen geluid te definiëren. Klik op Add en vul Internal name veld in dat de naam moet bevatten van het bestand dat is ingesloten in de toepassing of de naam van het systeemgeluid.
-
Klik op Next om de ontwikkeltoepassing te configureren.
-
De integratiesleutel is specifiek voor elke toepassing. De mobiele toepassing wordt aan Adobe Campaign gekoppeld.
Zorg ervoor dat dezelfde Integration key is gedefinieerd in Adobe Campaign en in de toepassingscode via de SDK.
Leer meer in de documentatie van de Ontwikkelaar
note note NOTE Integration key is volledig aanpasbaar met tekenreekswaarde, maar moet precies 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. -
Selecteer het pictogram in het veld Application icon om de mobiele toepassing in uw service aan te passen.
-
Selecteer het Authentication mode. Er zijn twee modi beschikbaar:
-
(Aanbevolen) Token-based authentication: vul de instellingen voor de APNs-verbinding in Key Id , Team Id en Bundle Id en selecteer vervolgens het p8-certificaat door op Enter the private key… te klikken. Voor meer op Token-based authentication, verwijs naar documentatie van Apple.
-
Certificate-based authentication: Klik op Enter the certificate… en selecteer de p12-toets. Voer vervolgens het wachtwoord in dat door de ontwikkelaar van de mobiele toepassing is 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.
-
-
Gebruik de knop Test the connection om uw configuratie te valideren.
-
Klik op Next om de productietoepassing te configureren en dezelfde stappen uit te voeren als hierboven beschreven.
-
Klik op Finish.
Uw iOS-toepassing kan nu worden gebruikt in Campagne.
Ga als volgt te werk om een app voor Android-apparaten te maken:
-
Selecteer Create an Android application en klik op Next.
-
Voer in het veld Label de naam van uw toepassing in.
-
De integratiesleutel is specifiek voor elke toepassing. De mobiele toepassing wordt aan Adobe Campaign gekoppeld.
Zorg ervoor dat dezelfde Integration key is gedefinieerd in Adobe Campaign en in de toepassingscode via de SDK.
Leer meer in de documentatie van de Ontwikkelaar
note note NOTE Integration key is volledig aanpasbaar met tekenreekswaarde, maar moet precies hetzelfde zijn als de waarde die in de SDK is opgegeven. -
Selecteer het pictogram in het veld Application icon om de mobiele toepassing in uw service aan te passen.
-
Selecteer HTTP v1 in API version drop-down lijst.
-
Klik op de koppeling Load project json file to extract project details… om het JSON-sleutelbestand te laden. Voor meer informatie over hoe te om uw JSON- dossier te halen, verwijs naar de documentatie van de Vuurbasis van Google.
U kunt ook handmatig de volgende gegevens invoeren:
- Project Id
- Private Key
- Client Email
-
Gebruik de knop Test the connection om uw configuratie te valideren.
note caution CAUTION De knop Test connection controleert niet of de server voor midsourcing (MID) toegang heeft tot de FCM-server. -
(optioneel) U kunt desgewenst 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.
-
Klik op Finish en vervolgens op 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 uitbreiding van Adobe Campaign Classic voor de bevoegdheden van Adobe Experience Platform Mobile SDKs duwt berichten voor uw mobiele apps en helpt u gebruikersdrukknoppennen verzamelen en interactiemeting met de diensten van Adobe Experience Platform beheert.
Deze extensie, die geldt voor zowel Campaign Classic v7 als 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:
- Open de eigenschap tag die u eerder hebt gemaakt.
- Van de linkernavigatie, doorblader aan Uitbreidingen, en open de Catalogus tabel. Gebruik het onderzoeksgebied om de Adobe Campaign Classic uitbreiding te vinden.
- Van de kaart van Campaign Classic, klik installeer knoop.
- Ga montages in zoals die in Adobe Experience Platform Mobile SDK documentatieworden beschreven.
U kunt Campagne aan uw app nu toevoegen, zoals die in wordt gedetailleerd Adobe Experience Platform Mobile SDK documentatie.