Configuratiestappen voor Android

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

De belangrijkste stappen zijn:

Dan kunt u een Android-rijk bericht 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. Meer informatie in deze Adobe Campaign v8-technologie.

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.

Voer de volgende stappen uit om te kiezen welke aansluiting u wilt gebruiken:

  1. Ga naar Administration > Platform > External accounts.

  2. Selecteer de Android routing externe rekening.

  3. In de Connector tabblad, vult de JavaScript used in the connector veld:

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

    note note
    NOTE
    U kunt het ook configureren als volgt: https://localhost:8080/nms/jsp/androidPushConnector.js, maar u wordt aangeraden versie 2 van de connector te gebruiken.

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

    • maxGCMConnectPerChild: Maximale limiet van parallelle HTTP-aanvragen voor de FCM die door elke onderliggende server worden gestart (standaard 8).

Een Android-service configureren configuring-android-service

Leer hoe u een Android-service configureert in video.

  1. Ga naar de Profiles and Targets > Services and subscriptions knoop en klik New.

  2. Een Label en Internal name.

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

    note note
    NOTE
    De standaardwaarde Subscriber applications (nms:appSubscriptionRcp) doeltoewijzing 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 dialoogvenster Target mapping van de dienst. Raadpleeg voor meer informatie over het maken van doeltoewijzingen de deze sectie.

  4. Klik vervolgens op de knop Add Selecteer het toepassingstype.

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

De mobiele Android-toepassing maken creating-android-app

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

  1. Klik op de knop Add Selecteer het toepassingstype.

  2. Selecteren Create an Android application en voert u een Label.

  3. Zorg ervoor dat Integration key wordt gedefinieerd in Adobe Campaign en in de toepassingscode via de SDK. Raadpleeg deze sectie voor meer informatie.

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

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

  6. Klikken Finish dan Save. Uw Android-toepassing kan nu worden gebruikt in het Campaign Classic.

Standaard slaat Adobe Campaign een toets op in het dialoogvenster User identifier (@userKey) in het veld Subscriber applications (nms:appSubscriptionRcp) tabel. 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 onderdeel van de voortdurende inspanningen van Google om haar diensten te verbeteren, zullen de bestaande FCM API's worden stopgezet op 20 juni 2024. Meer informatie in deze Adobe Campaign v8-technologie.

Nadat u de service en een nieuwe mobiele toepassing hebt gemaakt, moet u uw mobiele toepassing configureren. De HTTP (verouderd) API mag niet worden geselecteerd omdat deze is vervangen door Google.

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

  1. In uw Mobile application creation wizard venster, selecteert u HTTPV1 in de API version vervolgkeuzelijst.

  2. Klikken Load project json file to extract project details… om uw JSON-sleutelbestand rechtstreeks te laden. Voor meer informatie over het uitpakken van uw JSON-bestand raadpleegt u deze pagina.

    U kunt ook handmatig de volgende gegevens invoeren:

    • Project Id
    • Private Key
    • Client Email

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

    note caution
    CAUTION
    Voor de implementatie van middelmatige bronnen Test connection niet controleert of de MID-server toegang heeft tot de FCM-server.

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

  5. Klikken Finish dan Save. Uw Android-toepassing kan nu worden gebruikt in het Campaign Classic.

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

Berichttype
Configureerbaar berichtelement (FCM-ladenaam)
Configureerbare opties (FCM-ladenaam)
gegevensbericht
N.v.t.
validate_only
meldingsbericht
title, body, android_channel_id, icon, sound, tag, color, click_action, image, ticker, sticky, visibility, notification_priority, notification_count
validate_only

Het schema appsubscriptionRcp uitbreiden extend-subscription-schema

Leer hoe u het schema appsubscriptionRcp in video kunt uitbreiden

U moet het dialoogvenster appsubscriptionRcp 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. Een extensie maken van de Subscriber applications (nms:appsubscriptionRcp) en definieert u de nieuwe velden. Meer informatie over schema-extensies vindt u in deze pagina

  2. De toewijzing definiëren in het dialoogvenster Subscription parameters tab.

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