DokumentationCampaignDokumentation för Campaign Classic v7

Konfigurationssteg för Android

Last update: Tue Sep 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Användare
  • Utvecklare

När paketet har installerats kan du definiera dina programinställningar för Android i Adobe Campaign Classic.

Viktiga steg är:

  1. Konfigurera Android externa konto
  2. Konfigurera Android-tjänsten
  3. Skapa mobilappen i Campaign
  4. Utöka appschemat med ytterligare data

Du kan sedan skapa ett omfattande Android-meddelande.

IMPORTANT
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 i den här Adobe Campaign v8-tekniken.

Konfigurera Android externa konto configuring-external-account-android

För Android finns två anslutningsmöjligheter:

  • V1-anslutningen som tillåter en anslutning per underordnad MTA.
  • V2-anslutningen som tillåter samtidiga anslutningar till FCM-servern för att förbättra genomströmningen.

Så här väljer du vilken koppling du vill använda:

  1. Gå till Administration > Platform > External accounts.

  2. Välj det Android routing externa kontot.

  3. På fliken Connector fyller du i fältet JavaScript used in the connector:

    För Android V2: https://localhost:8080/nms/jsp/androidPushConnectorV2.js

    note note
    NOTE
    Du kan även konfigurera den enligt https://localhost:8080/nms/jsp/androidPushConnector.js, men vi rekommenderar att du använder version 2 av kopplingen.

  4. För Android V2 finns ytterligare en parameter i konfigurationsfilen för Adobe Server (serverConf.xml):

    • maxGCMConnectPerChild: Maximal gräns för parallella HTTP-begäranden till FCM som initieras av varje underordnad server (8 som standard).

Konfigurera en Android-tjänst configuring-android-service

Lär dig hur du konfigurerar en Android-tjänst i en video.

  1. Gå till noden Profiles and Targets > Services and subscriptions och klicka på New.

  2. Definiera en Label och en Internal name.

  3. Gå till fältet Type och välj Mobile application.

    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. Mer information om hur du skapar målmappning finns i det här avsnittet.

  4. Klicka sedan på knappen Add för att välja programtyp.

  5. Skapa ett Android-program. Mer information om detta finns i det här avsnittet.

Skapa Android mobilprogram creating-android-app

När du har skapat tjänsten måste du nu skapa ett Android-program:

  1. Klicka på knappen Add för att välja programtyp i den nya tjänsten.

  2. Välj Create an Android application och ange en Label.

  3. Kontrollera att samma Integration key har definierats i Adobe Campaign och i programkoden via SDK.

    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 API version: HTTP v1 eller HTTP (äldre). Dessa konfigurationer beskrivs i det här avsnittet

  5. Fyll i fälten Firebase Cloud Messaging the Android connection settings.

  6. Klicka på Finish och sedan på Save. Ditt Android-program kan nu användas i Campaign Classic.

Som standard sparar Adobe Campaign en nyckel i fältet User identifier (@userKey) i tabellen Subscriber applications (nms:appSubscriptionRcp). Med den här nyckeln kan du länka en prenumeration till en mottagare. Om du vill samla in ytterligare data (till exempel en komplex avstämningsnyckel) måste du använda följande konfiguration:

Konfigurera API-versionen select-api-version

IMPORTANT
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. Som en del av Google kontinuerliga arbete med att förbättra sina tjänster kommer de äldre FCM-API:erna att upphöra den 20 juni 2024. Läs mer i den här Adobe Campaign v8-tekniken.

När du har skapat en tjänst och ett nytt mobilprogram måste du konfigurera ditt mobilprogram. API:t HTTP (äldre) bör inte väljas eftersom det har tagits bort av Google.

Följ stegen nedan för att konfigurera API-versionen för HTTP v1:

  1. I Mobile application creation wizard-fönstret väljer du HTTPV1 i listrutan API version.

  2. Klicka på Load project json file to extract project details… om du vill läsa in JSON-nyckelfilen direkt. Mer information om hur du extraherar JSON-filen finns på den här sidan.

    Du kan även ange följande manuellt:

    • Project Id
    • Private Key
    • Client Email

  3. Klicka på Test the connection om du vill kontrollera att konfigurationen är korrekt och att marknadsföringsservern har åtkomst till FCM.

    note caution
    CAUTION
    Knappen Test connection kontrollerar inte om MID-servern har åtkomst till FCM-servern för distributionen med mellanresurser.

  4. Som ett alternativ kan du 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.

  5. Klicka på Finish och sedan på Save. Ditt Android-program kan nu användas i Campaign Classic.

Nedan visas FCM-nyttolastsnamnen för att ytterligare anpassa ditt push-meddelande:

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

Utöka appsubscriptionRcp-schemat extend-subscription-schema

Lär dig hur du utökar appsubscriptionRcp-schemat i video

Du måste utöka appsubscriptionRcp för att definiera nya fält för att lagra parametrar från appen i Campaign-databasen. De här fälten används till exempel för personalisering. Så här gör du:

  1. Skapa ett tillägg till schemat Subscriber applications (nms:appsubscriptionRcp) och definiera de nya fälten. Läs mer om schematillägget på den här sidan

  2. Definiera mappningen på fliken Subscription parameters.

    note caution
    CAUTION
    Kontrollera att konfigurationsnamnen på fliken Subscription parameters är samma som de i mobilprogramkoden.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1