DokumentationCampaignDokumentation om Campaign v8

Konfigurera kanal för push-meddelanden push-notification-configuration

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Mellanliggande
  • Administratör
  • Utvecklare

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.

CAUTION
Vissa viktiga ändringar av tjänsten Android Firebase Cloud Messaging (FCM) kommer att släppas 2024 och kan komma att påverka din Adobe Campaign-implementering. Konfigurationen för prenumerationstjänster för push-meddelanden för Android kan behöva uppdateras för att den här ändringen ska fungera. Du kan redan kontrollera och vidta åtgärder. Läs mer.

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 innehåller 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:

  1. Kontrollera förutsättningarna.
  2. Ställ in en mobil taggegenskap i Adobe Experience Platform Data Collection.
  3. Hämta Adobe Experience Platform Mobile SDK enligt informationen på den här sidan.
  4. (valfritt) Aktivera loggnings- och livscykelstatistik, enligt informationen på den här sidan.
  5. (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.
  6. Konfigurera dina iOS- och Android-mobiltjänster i Adobe Campaign enligt informationen på den här sidan.
  7. Installera och konfigurera Adobe Campaign Extension i din mobila egenskap.
  8. Följ dokumentationen för Adobe Experience Platform Mobile SDK om du vill konfigurera med Adobe Experience Platform Mobile SDK i din app.

Förhandskrav 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.

CAUTION
Push-konfigurationen måste utföras av en expertanvändare. Beroende på din implementeringsmodell och vilka profiler som används i den här implementeringen kan du behöva tilldela en enskild produktprofil den fullständiga behörighetsuppsättningen eller dela behörigheter mellan apputvecklaren och Adobe Campaign -administratören.

Följ stegen nedan för att tilldela Egenskap och Företag behörigheter:

  1. Åtkomst till Admin Console.

  2. Välj Adobe Experience Platform Data Collection-kortet på fliken Products.

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

  4. På fliken Permissions väljer du Property Rights.

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

  6. Välj sedan Company rights på den vänstra menyn.

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

  8. Klicka på Save.

Följ stegen nedan för att tilldela Product profile till användare:

  1. Åtkomst till Admin Console.

  2. Välj Adobe Experience Platform Data Collection-kortet på fliken Products.

  3. Välj din tidigare konfigurerade Product profile.

  4. Klicka på Add user på fliken Users.

  5. Skriv in användarens namn eller e-postadress och markera användaren. Klicka sedan på Save.

    note 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-dokumentationen
  • 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 Adobe Experience Platform Mobile SDK-dokumentationen.

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:

  1. Bläddra till Publiceringsflöde i den vänstra navigeringen och välj Lägg till bibliotek.
  2. Ange namnet på biblioteket och välj miljö.
  3. Välj Lägg till alla ändrade resurser och Spara och skapa i utveckling.
  4. 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ändare 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 prenumeranterna av din app. 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:

  1. Bläddra till fliken Profiles and Targets > Services and Subscriptions och klicka på Create.

    {width="800"}

  2. Ange en Label och en Internal name och välj en Mobile application-typ.

    note note
    NOTE
    Standardmålmappningen för 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.

  3. Använd sedan ikonen Add till höger för att definiera de mobilprogram som använder den här tjänsten.

iOS

Så här skapar du en app för iOS-enheter:

  1. Markera Create an iOS application och klicka på Next.

    {width="600"}

  2. Ange namnet på din app i fältet Label.

  3. (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.

    {width="600"}

  4. Bläddra till fliken Subscription parameters för att definiera mappningen med ett tillägg till schemat Subscriber applications (nms:appsubscriptionRcp).

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

  6. Klicka på Next för att börja konfigurera utvecklingsprogrammet.

  7. 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
    NOTE
    Integration key är helt anpassningsbar med strängvärde, men måste vara exakt densamma som den som anges i SDK:n.
    Du kan inte använda samma certifikat för utvecklingsversionen (sandlådan) och produktionsversionen av programmet.

  8. Välj ikonen i fältet Application icon om du vill anpassa mobilprogrammet i tjänsten.

  9. Markera 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…, markera din p12-nyckel och ange lösenordet som angavs av utvecklaren av mobilprogrammet. 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.

  10. Använd knappen Test the connection för att validera konfigurationen.

  11. Klicka på Next för att börja konfigurera produktionsprogrammet och följ stegen som anges ovan.

  12. Klicka på Finish.

Ditt iOS-program kan nu användas i Campaign.

Android

Så här skapar du en app för Android-enheter:

  1. Markera Create an Android application och klicka på Next.

    {width="600"}

  2. Ange namnet på din app i fältet Label.

  3. 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
    NOTE
    Integration key är helt anpassningsbar med strängvärde, men måste vara exakt densamma som den som anges i SDK:n.

  4. Välj ikonen i fältet Application icon om du vill anpassa mobilprogrammet i tjänsten.

  5. Välj HTTP v1 i listrutan API version.

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

  7. Använd knappen Test the connection för att validera konfigurationen.

    note caution
    CAUTION
    Knappen Test connection kontrollerar inte om MID-servern har åtkomst till FCM-servern.

  8. (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.

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

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:

  1. Öppna taggegenskapen som du skapade tidigare.
  2. 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.
  3. Klicka på knappen Installera på Campaign Classicen.
  4. 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 Adobe Experience Platform Mobile SDK-dokumentationen.

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