Configuratiestappen voor Android

Nadat het pakket is geïnstalleerd, kunt u de instellingen van uw Android-app definiëren in Adobe Campaign Classic.

De belangrijkste stappen zijn:

U kunt dan een uitgebreide Android-melding maken.

IMPORTANT
In 2024 komt er een versie met enkele belangrijke wijzigingen voor de service FCM (Android Firebase Cloud Messaging). Deze kunnen van invloed zijn op uw Adobe Campaign-implementatie. De configuratie van uw lidmaatschapsservices voor Android-pushberichten moet mogelijk worden bijgewerkt om deze wijziging te ondersteunen. U kunt al controleren en actie ondernemen. Leer meer in dit Adobe Campaign v8 technote.

Externe Android-account configureren configuring-external-account-android

Voor Android zijn twee connectors beschikbaar:

  • De V1 schakelaar die één verbinding per kind MTA toestaat.
  • De V2-connector die gelijktijdige verbindingen met de FCM-server mogelijk maakt om de doorvoer te verbeteren.

Volg deze stappen om te kiezen welke connector u wilt gebruiken:

  1. Ga naar Administration > Platform > External accounts .

  2. Selecteer de Android routing externe account.

  3. Vul op het tabblad Connector het veld JavaScript used in the connector in:

    Voor Android V2: https://localhost:8080/nms/jsp/androidPushConnectorV2.js

    note note
    NOTE
    Je kunt het ook als volgt configureren https://localhost:8080/nms/jsp/androidPushConnector.js maar we raden je aan om versie 2 van de connector te gebruiken.

  4. Voor Android V2 is één extra parameter beschikbaar in het Adobe Server-configuratiebestand (serverConf.xml):

    • maxGCMConnectPerChild: Maximale limiet van parallelle HTTP-verzoeken naar de FCM die door elke onderliggende server worden geïnitieerd (standaard 8).

Een Android-service configureren configuring-android-service

Leer in video hoe u een Android-service configureert.

  1. Ga naar het knooppunt Profiles and Targets > Services and subscriptions en klik op New .

  2. Definieer een Label en een Internal name .

  3. Ga naar het veld Type en selecteer Mobile application .

    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. Raadpleeg deze sectie🔗 voor meer informatie over het maken van doeltoewijzing.

  4. Klik vervolgens op de Add knop om het toepassingstype te selecteren.

  5. Maak uw Android-toepassing. Raadpleeg deze sectie voor meer informatie.

De mobiele Android-toepassing maken creating-android-app

Nadat u uw service hebt gemaakt, moet u nu uw Android-toepassing maken:

  1. Klik vanuit de nieuwe service op de knop Add om het toepassingstype te selecteren.

  2. Selecteer Create an Android application en voer een Label in.

  3. Zorg ervoor dat hetzelfde Integration key is gedefinieerd in Adobe Campaign en in de toepassingscode via de SDK.

    note note
    NOTE
    Integration key is volledig aanpasbaar met tekenreekswaarde, maar moet precies hetzelfde zijn als de waarde die in de SDK is opgegeven.
  4. Selecteer API version: HTTP v1 of HTTP (verouderd). Deze configuraties zijn gedetailleerd in deze sectie

  5. Vul de velden Firebase Cloud Messaging the Android connection settings in.

  6. Klik op Finish en vervolgens op Save . Uw Android-toepassing kan nu worden gebruikt in Campaign Classic.

Standaard slaat Adobe Campaign een toets op in het veld User identifier (@userKey) van de tabel Subscriber applications (nms:appSubscriptionRcp) . Met deze sleutel kunt u een abonnement koppelen aan een ontvanger. Als u aanvullende gegevens wilt verzamelen (zoals een complexe afstemmingssleutel), moet u de volgende configuratie toepassen:

De API-versie configureren select-api-version

IMPORTANT
In 2024 komt er een versie met enkele belangrijke wijzigingen voor de service FCM (Android Firebase Cloud Messaging). Deze kunnen van invloed zijn op uw Adobe Campaign-implementatie. Als deel van Google dat voortdurend probeert om zijn diensten te verbeteren, zal erfenis FCM APIs op juni 20, 2024 worden opgeheven. Leer meer in dit Adobe Campaign v8 technote.

Nadat u de service en een nieuwe mobiele toepassing hebt gemaakt, moet u uw mobiele toepassing configureren. HTTP (erfenis) API zou niet moeten worden geselecteerd aangezien het door Google is verouderd.

Voer de volgende stappen uit om de HTTP v1 API-versie te configureren:

  1. Selecteer in het Mobile application creation wizard -venster HTTPV1 in de vervolgkeuzelijst API version .

  2. Klik op Load project json file to extract project details… om het JSON-sleutelbestand rechtstreeks te laden. Voor meer informatie over hoe te om uw JSON- dossier te halen, verwijs naar deze pagina.

    U kunt ook handmatig de volgende gegevens invoeren:

    • Project Id
    • Private Key
    • Client Email

  3. Klik Test the connection om te controleren of uw configuratie correct is en of de marketingserver toegang heeft tot de FCM.

    note caution
    CAUTION
    Voor Mid-Sourcing Deployment controleert de Test connection knop niet of de MID-server toegang heeft tot de FCM-server.

  4. Als optie kunt u de inhoud van een pushbericht indien nodig verrijken met wat Application variables . Deze zijn volledig aanpasbaar en een deel van de berichtlading wordt verzonden naar het mobiele apparaat.

  5. Klik vervolgens Save op Finish . Uw Android-toepassing kan nu worden gebruikt in Campaign Classic.

Hieronder vindt u de namen van FCM-ladingen om uw pushmelding verder aan te passen:

Berichttype
Configureerbaar berichtelement (naam van de FCM-payload)
Configureerbare opties (naam FCM-payload)
gegevensbericht
N.v.t.
validate_only
meldingsbericht
titel, lichaam, android_channel_id, icoon, geluid, label, kleur, click_action, afbeelding, ticker, plakkerig, zichtbaarheid, notification_priority, notification_count
validate_only

Het appsubscriptionRcp-schema uitbreiden extend-subscription-schema

Leer hoe te om het schema appsubscriptionRcp in video uit te breiden

U moet appsubscriptionRcp uitbreiden om nieuwe extra gebieden te bepalen om parameters van app in het gegevensbestand van de Campagne op te slaan. Deze velden worden bijvoorbeeld gebruikt voor personalisatie. Dit doet u als volgt:

  1. Maak een extensie van het schema Subscriber applications (nms:appsubscriptionRcp) en definieer de nieuwe velden. Leer meer over schemauitbreiding in deze pagina

  2. Definieer de toewijzing op het tabblad Subscription parameters .

    note caution
    CAUTION
    Zorg ervoor dat de configuratienamen op het Subscription parameters tabblad hetzelfde zijn als die in de code van de mobiele toepassing.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1