Konfigurera kanal för push-meddelanden push-notification-configuration
Om du vill skicka push-meddelanden med Adobe Campaign måste du först konfigurera miljön och appen så som anges på den här sidan. I Adobe Campaign är mobilappskanalen kanalen för att skicka push-meddelanden.
Innan du börjar skicka push-meddelanden med Adobe Campaign måste du se till att det finns konfigurationer och integreringar på mobilappen och för taggar i Adobe Experience Platform. Adobe Experience Platform Mobile SDK erbjuder API:er för integrering på klientsidan för mobiler via Android och iOS-kompatibla SDK:er.
Så här konfigurerar du appen med Adobe Experience Platform Mobile SDK:
- Kontrollera förutsättningarna.
- Ställ in en mobil taggegenskap i Adobe Experience Platform Data Collection.
- Hämta Adobe Experience Platform Mobile SDK enligt informationen på den här sidan.
- (valfritt) Aktivera loggnings- och livscykelstatistik, enligt informationen på den här sidan.
- (valfritt) Lägg till Adobe Experience Platform Assurance i din app för att validera implementeringen. Lär dig hur du implementerar Adobe Experience Platform Assurance-tillägget på den här sidan.
- Konfigurera dina iOS- och Android-mobiltjänster i Adobe Campaign enligt informationen på den här sidan.
- Installera och konfigurera Adobe Campaign Extension i din mobila egenskap.
- Följ dokumentationen för Adobe Experience Platform Mobile SDK om du vill konfigurera Adobe Experience Platform Mobile SDK:er i din app.
Förutsättningar before-starting
Konfigurera behörigheter setup-permissions
Innan du skapar ett mobilprogram måste du kontrollera att du har eller tilldelar rätt användarbehörigheter för taggar i Adobe Experience Platform. Användarbehörigheter för taggar i Adobe Experience Platform tilldelas användare via Adobe Admin Console. Läs mer i Tagg-dokumentationen.
Följ stegen nedan för att tilldela Egenskap och Företag behörigheter:
-
Åtkomst till Admin Console.
-
Välj Adobe Experience Platform Data Collection-kortet på fliken Products.
-
Välj en befintlig Product Profile eller skapa en ny med knappen New profile. Lär dig hur du skapar en ny New profile i Admin Console-dokumentationen.
-
Välj Property Rights på fliken Permissions.
-
Klicka på Add all. Detta lägger till följande rättigheter i din produktprofil:
- Approve
- Develop
- Edit Property
- Manage Environments
- Manage Extensions
- Publish
Dessa behörigheter krävs för att installera och publicera Adobe Campaign-tillägget och publicera appegenskapen i Adobe Experience Platform Mobile SDK.
-
Välj sedan Company rights på den vänstra menyn.
-
Lägg till följande rättigheter:
- Manage App Configurations
- Manage Properties
Dessa behörigheter krävs för att mobilappsutvecklaren ska kunna ställa in push-autentiseringsuppgifter i Adobe Experience Platform Data Collection.
-
Klicka på Save.
Följ stegen nedan för att tilldela Product profile till användare:
-
Åtkomst till Admin Console.
-
Välj Adobe Experience Platform Data Collection-kortet på fliken Products.
-
Välj din tidigare konfigurerade Product profile.
-
Klicka på Add user på fliken Users.
-
Skriv in användarens namn eller e-postadress och markera användaren. Klicka sedan på Save.
note NOTE Om användaren inte redan har skapats i Admin Console läser du dokumentationen till Lägg till användare.
Konfigurera din app configure-app
Den tekniska konfigurationen innefattar nära samarbete mellan apputvecklaren och företagsadministratören. Innan du börjar skicka push-meddelanden med Adobe Campaign måste du definiera inställningar i Adobe Experience Platform Data Collection och integrera din mobilapp med Adobe Experience Platform Mobile SDK:er.
Följ implementeringsstegen som beskrivs i länkarna nedan:
- För Apple iOS: Lär dig hur du registrerar din app med APN:er i Apple Documentation
- För Google Android: Lär dig hur du konfigurerar en Firebase Cloud Messaging-klientapp på Android i Google Documentation
Konfigurera en mobil taggegenskap i Adobe Experience Platform Data Collection launch-property
Genom att konfigurera en mobil egenskap kan utvecklaren eller marknadsföraren av mobilappen konfigurera SDK:n för mobilappen. Du skapar vanligtvis en mobil egenskap för varje mobilprogram som du vill hantera. Lär dig hur du skapar och konfigurerar en mobil egenskap i dokumentationen för Adobe Experience Platform Mobile SDK.
Läs mer om Adobe Experience Platform Data Collection-taggar i Adobe Experience Platform-dokumentation.
Öppna den nya taggegenskapen och skapa ett bibliotek när du har skapat den. Så här gör du:
- Bläddra till Publiceringsflöde i den vänstra navigeringen och välj Lägg till bibliotek.
- Ange namnet på biblioteket och välj miljö.
- Välj Lägg till alla ändrade resurser och Spara och skapa i utveckling.
- Ange slutligen det här biblioteket som ditt arbetsbibliotek från knappen Välj ett arbetsbibliotek .
Konfigurera dina mobiltjänster i Campaign push-service
När din mobilapp har konfigurerats i Adobe Experience Platform Data Collection måste du skapa två tjänster (en för iOS-enheter, en för Android-enheter) för att kunna skicka push-meddelanden från Adobe Campaign.
Push-meddelanden skickas till appanvändarna via en dedikerad tjänst. När användarna installerar din app prenumererar de på den här tjänsten: Adobe Campaign förlitar sig på den här tjänsten för att endast rikta sig till appens prenumeranter. I den här tjänsten måste du lägga till dina iOS- och Android-appar som ska skickas på enheter med iOS och Android.
Följ stegen nedan för att skapa en tjänst för att skicka push-meddelanden:
-
Bläddra till fliken Profiles and Targets > Services and Subscriptions och klicka på Create.
{align="left" width="800"}
-
Ange en Label och en Internal name och välj en Mobile application-typ.
note NOTE Standardmålmappningen Subscriber applications (nms:appSubscriptionRcp) är länkad till mottagartabellen. Om du vill använda en annan målmappning måste du skapa en ny målmappning och ange den i fältet Target mapping för tjänsten. Läs mer om målmappningar på den här sidan. -
Använd sedan ikonen Add till höger för att definiera de mobilprogram som använder den här tjänsten.
Så här skapar du en app för iOS-enheter:
-
Markera Create an iOS application och klicka på Next.
{align="left" width="600"}
-
Ange namnet på din app i fältet Label.
-
(valfritt) Du kan utöka ett push-meddelandeinnehåll med lite Application variables. Dessa är helt anpassningsbara och utgör en del av den meddelandenyttolast som skickas till den mobila enheten.
I exemplet nedan läggs variablerna mediaURl och mediaExt till för att skapa omfattande push-meddelanden och ger sedan programmet den bild som ska visas i meddelandet.
{align="left" width="600"}
-
Bläddra till fliken Subscription parameters för att definiera mappningen med ett tillägg till schemat Subscriber applications (nms:appsubscriptionRcp).
-
Bläddra till fliken Sounds för att definiera ett ljud som ska spelas upp. Klicka på Add och fyll i fältet Internal name som måste innehålla namnet på filen som är inbäddad i programmet eller namnet på systemljudet.
-
Klicka på Next för att börja konfigurera utvecklingsprogrammet.
-
Integreringsnyckeln är specifik för varje program. Det länkar mobilprogrammet till Adobe Campaign.
Kontrollera att samma Integration key har definierats i Adobe Campaign och i programkoden via SDK.
Läs mer i utvecklardokumentationen
note NOTE Integration key är helt anpassningsbar med strängvärde, men måste vara exakt densamma som den som anges i SDK. Du kan inte använda samma certifikat för utvecklingsversionen (sandlådan) och produktionsversionen av programmet. -
Välj ikonen i fältet Application icon om du vill anpassa mobilprogrammet i tjänsten.
-
Välj Authentication mode. Det finns två lägen:
-
(Rekommenderas) Token-based authentication: Fyll i APN-anslutningsinställningarna Key Id, Team Id och Bundle Id och välj sedan ditt p8-certifikat genom att klicka på Enter the private key… . Mer information om Token-based authentication finns i Apple-dokumentationen.
-
Certificate-based authentication: Klicka på Enter the certificate… och välj sedan din p12-nyckel och ange lösenordet som angavs av mobilprogramutvecklaren. Observera att detta certifikat har ett förfallodatum och måste förnyas årligen. Uppdatera certifikaten innan de upphör att gälla för att undvika avbrott i användandet för dina användare. Certifikaten är giltiga i ett år och du måste uppdatera dem för att kunna fortsätta kommunicera med APN:er.
-
-
Använd knappen Test the connection för att validera konfigurationen.
-
Klicka på Next för att börja konfigurera produktionsprogrammet och följ stegen som anges ovan.
-
Klicka på Finish.
Ditt iOS-program kan nu användas i Campaign.
Så här skapar du en app för Android-enheter:
-
Markera Create an Android application och klicka på Next.
{align="left" width="600"}
-
Ange namnet på din app i fältet Label.
-
Integreringsnyckeln är specifik för varje program. Det länkar mobilprogrammet till Adobe Campaign.
Kontrollera att samma Integration key har definierats i Adobe Campaign och i programkoden via SDK.
Läs mer i utvecklardokumentationen
note NOTE Integration key är helt anpassningsbar med strängvärde, men måste vara exakt densamma som den som anges i SDK. -
Välj ikonen i fältet Application icon om du vill anpassa mobilprogrammet i tjänsten.
-
Välj HTTP v1 i listrutan API version.
-
Klicka på länken Load project json file to extract project details… för att läsa in JSON-nyckelfilen. Mer information om hur du extraherar JSON-filen finns i Google Firebase-dokumentationen.
Du kan även ange följande manuellt:
- Project Id
- Private Key
- Client Email
-
Använd knappen Test the connection för att validera konfigurationen.
note caution CAUTION Knappen Test connection kontrollerar inte om MID-servern (Middle-sourcing) har åtkomst till FCM-servern. -
(valfritt) Du kan utöka ett push-meddelandeinnehåll med vissa Application variables vid behov. Dessa är helt anpassningsbara och utgör en del av den meddelandenyttolast som skickas till den mobila enheten.
-
Klicka på Finish och sedan på Save. Ditt Android-program kan nu användas i Campaign.
Nedan visas FCM-nyttolastsnamnen för att ytterligare anpassa ditt push-meddelande:
| 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 | ||
|---|---|---|
| Meddelandetyp | Konfigurerbart meddelandeelement (FCM-nyttolastnamn) | Konfigurerbara alternativ (FCM-nyttolastnamn) |
| datameddelande | Ej tillämpligt | validate_only |
| meddelandemeddelande | title, body, android_channel_id, icon, sound, tag, color, click_action, image, ticker, sticky, visibility, notification_priority, notification_count | validate_only |
Konfigurera Adobe Campaign Extension i din mobila egenskap configure-extension
Adobe Campaign Classic-tillägget för Adobe Experience Platform Mobile SDK:er hanterar push-meddelanden för dina mobilappar och hjälper dig att samla in push-tokens för användare och hantera interaktionsmätning med Adobe Experience Platform-tjänster.
Det här tillägget, som gäller både Campaign Classic v7 och Campaign v8, är förinstallerat i din miljö och måste konfigureras. Så här konfigurerar du tillägget för din mobila taggegenskap:
- Öppna taggegenskapen som du skapade tidigare.
- Bläddra till Tillägg från den vänstra navigeringen och öppna fliken Katalog. Använd sökfältet för att hitta tillägget Adobe Campaign Classic.
- Klicka på knappen Installera på Campaign Classic-kortet.
- Ange inställningar enligt beskrivningen i dokumentationen för Adobe Experience Platform Mobile SDK.
Nu kan du lägga till Campaign i din app, vilket beskrivs i dokumentationen för Adobe Experience Platform Mobile SDK.