Konfigurationssteg för Android

När paketet har installerats kan du definiera inställningarna för Android-appen i Adobe Campaign Classic.

Viktiga steg är:

Då kan du skapa ett omfattande meddelande för Android.

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 om detta Adobe Campaign v8-teknik.

Konfigurera externt Android-konto configuring-external-account-android

För Android finns två anslutningar:

  • 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 Android routing externt konto.

  3. I Connector -flik, fylla i JavaScript used in the connector fält:

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

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

  2. Definiera en Label och Internal name.

  3. Gå till Type fält och markera Mobile application.

    note note
    NOTE
    Standardvärdet Subscriber applications (nms:appSubscriptionRcp) målmappningen ä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 Target mapping tjänstens fält. Mer information om hur du skapar målmappning finns i det här avsnittet.

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

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

Skapa Android-mobilprogrammet creating-android-app

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

  1. Klicka på Add för att välja programtyp.

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

  3. Se till att samma Integration key definieras i Adobe Campaign och i programkoden via SDK. Mer information om detta finns i det här avsnittet.

    note note
    NOTE
    The Integration key är helt anpassningsbart 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 Firebase Cloud Messaging the Android connection settings fält.

  6. Klicka Finish sedan Save. Android-programmet kan nu användas i Campaign Classic.

Som standard sparar Adobe Campaign en tangent i User identifier (@userKey) i fältet Subscriber applications (nms:appSubscriptionRcp) tabell. 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 på 20 juni 2024. Läs mer om detta Adobe Campaign v8-teknik.

När du har skapat en tjänst och ett nytt mobilprogram måste du konfigurera ditt mobilprogram. The HTTP (äldre) API 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önster, markera HTTPV1 i API version nedrullningsbar meny.

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

    Du kan även ange följande manuellt:

    • Project Id
    • Private Key
    • Client Email

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

    note caution
    CAUTION
    För resursdistributionen kan du Test connection kontrollerar inte om MID-servern har åtkomst till FCM-servern.

  4. Som ett alternativ kan du utöka ett push-meddelandeinnehåll med Application variables vid behov. Dessa är helt anpassningsbara och utgör en del av den meddelandenyttolast som skickas till den mobila enheten.

  5. Klicka Finish sedan Save. Android-programmet 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 om du vill 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 Subscriber applications (nms:appsubscriptionRcp) och definiera de nya fälten. Läs mer om schemautökning i den här sidan

  2. Definiera mappningen i Subscription parameters -fliken.

    note caution
    CAUTION
    Kontrollera konfigurationsnamnen i dialogrutan Subscription parameters -fliken är densamma som i mobilprogramkoden. Se det här avsnittet.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1