v7

Konfigurationsschritte für Android

Letzte Aktualisierung: 2023-09-06
  • Themen:
  • Push
    Weitere Informationen zu diesem Thema
  • Erstellt für:
  • User
    Developer

Nachdem das Paket installiert ist, können Sie die Einstellungen Ihrer Android-Mobile-App in Adobe Campaign Classic festlegen.

HINWEIS

Informationen dazu, wie Sie Ihre Mobile-App für iOS konfigurieren und einen Versand für iOS erstellen, finden Sie in diesem Abschnitt.

Die wichtigsten Schritte sind:

  1. Konfigurieren des externen Android-Kontos
  2. Konfigurieren des Android-Service
  3. Erstellen der Mobile App in Campaign
  4. Erweitern des App-Schemas um zusätzliche Daten

Anschließend können Sie eine Rich-Benachrichtigung für Android erstellen.

Konfigurieren des externen Android-Kontos

Für Android sind zwei Connectoren verfügbar:

  • Der V1-Connector, der pro untergeordnetem MTA eine Verbindung ermöglicht.
  • Der V2-Connector, der gleichzeitige Verbindungen zum FCM-Server ermöglicht, um den Durchsatz zu erhöhen.

Wählen Sie den jeweiligen Connector folgendermaßen aus:

  1. Gehen Sie zu Administration > Plattform > Externe Konten.

  2. Wählen Sie das externe Konto Android-Routing aus.

  3. Füllen Sie im Connector-Tab das Feld Connector-JavaScript aus:

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

    HINWEIS

    Sie können das Feld auch wie folgt konfigurieren: https://localhost:8080/nms/jsp/androidPushConnector.js; wir empfehlen Ihnen jedoch, Version 2 des Connectors zu verwenden.

  4. Für Android V2 ist ein zusätzlicher Parameter in der Adobe-Server-Konfigurationsdatei (serverConf.xml) verfügbar:

    • maxGCMConnectPerChild: Maximale Anzahl paralleler HTTP-Abfragen bei FCM durch jeden untergeordneten Server (standardmäßig acht).

Konfigurieren des Android-Service

Erfahren Sie im Video, wie Sie einen Android-Service konfigurieren

  1. Klicken Sie im Knoten Profile und Zielgruppen > Dienste und Abonnements auf die Schaltfläche Neu.

  2. Bestimmen Sie einen Titel und einen internen Namen.

  3. Wählen Sie im Feld Typ die Option Mobile App.

    HINWEIS

    Das standardmäßig vorgeschlagene Zielgruppen-Mapping Abonnierte Anwendungen (nms:appSubscriptionRcp) bezieht sich auf die Empfängertabelle. Wenn Sie ein anderes Zielgruppen-Mapping verwenden wollen, haben Sie die Möglichkeit, im Feld Zielgruppen-Mapping des Service ein neues Zielgruppen-Mapping anzugeben. Weiterführende Informationen zur Erstellung des Zielgruppen-Mappings finden Sie in diesem Abschnitt.

  4. Klicken Sie dann auf die Schaltfläche Hinzufügen, um den Anwendungstyp auszuwählen.

  5. Erstellen Sie Ihre Android-Mobile-App. Weiterführende Informationen hierzu finden Sie in diesem Abschnitt.

Android-Mobile-App erstellen

Nachdem Sie den Dienst erstellt haben, müssen Sie jetzt Ihre Android-Mobile-App erstellen:

  1. Klicken Sie in Ihrem neu erstellten Dienst auf die Schaltfläche Hinzufügen, um den Anwendungstyp auszuwählen.

  2. Wählen Sie Android-Anwendung erstellen aus und geben Sie einen Titel ein.

  3. Stellen Sie sicher, dass in Adobe Campaign und im Anwendungs-Code derselbe Integrationsschlüssel definiert ist (über das SDK). Weiterführende Informationen hierzu finden Sie in diesem Abschnitt.

    HINWEIS

    Der Integrationsschlüssel kann mit einem Zeichenfolgenwert vollständig angepasst werden, muss jedoch mit dem im SDK angegebenen Schlüssel identisch sein.

  4. Wählen Sie die API-Version aus: HTTP Version 1 oder HTTP (frühere Version). Näheres zu diesen Konfigurationen finden Sie in diesem Abschnitt.

  5. Füllen Sie die Felder für Verbindungsparameter für Firebase Cloud Messaging for Android aus.

  6. Klicken Sie auf Beenden und danach auf Speichern. Ihre Android-Anwendung kann jetzt in Campaign Classic verwendet werden.

Standardmäßig speichert Adobe Campaign einen Schlüssel im Feld User-Kennung (@userKey) der Tabelle Abonnentenanwendungen (nms:appSubscriptionRcp). Mit diesem Schlüssel können Sie ein Abonnement mit einem Empfänger verknüpfen. Um zusätzliche Daten (z. B. einen komplexen Abstimmschlüssel) zu erfassen, müssen Sie die folgende Konfiguration übernehmen:

API-Version auswählen

Nachdem Sie einen Service und eine neue Mobile App erstellt haben, müssen Sie Ihre Mobile App entsprechend der ausgewählten API-Version konfigurieren.

  • Näheres zur Konfiguration von HTTP v1 finden Sie in diesem Abschnitt.
  • Näheres zur Konfiguration für HTTP (frühere Version) finden Sie in diesem Abschnitt.

Konfigurieren der HTTP v1-API

Gehen Sie wie folgt vor, um die HTTP v1-API-Version zu konfigurieren:

  1. Wählen Sie im Fenster des Mobile-App-Assistenten die Option HTTP v1 aus der Dropdown-Liste API-Version aus.

  2. Klicken Sie auf Projekt-JSON-Datei zum Extrahieren der Projektdetails laden…, um Ihre JSON-Schlüsseldatei direkt zu laden. Weitere Informationen dazu, wie Sie die JSON-Datei extrahieren, finden Sie auf dieser Seite.

    Sie können auch die folgenden Details manuell eingeben:

    • Projektkennung
    • Privater Schlüssel
    • Client-E-Mail

  3. Klicken Sie auf Verbindung testen, um zu prüfen, ob Ihre Konfiguration korrekt ist und ob der Marketing-Server Zugriff auf den FCM-Server hat.

    VORSICHT

    Bei Mid-Sourcing-Bereitstellungen wird mit der Schaltfläche Verbindung testen nicht geprüft, ob der MID-Server Zugriff auf den FCM-Server hat.

  4. Bei Bedarf können Sie die Inhalte von Push-Nachrichten mit bestimmten Anwendungsvariablen anreichern. Diese sind vollständig anpassbar und Teil der an das mobile Gerät gesendeten Nachrichten-Payload.

  5. Klicken Sie auf Beenden und danach auf Speichern. Ihre Android-Anwendung kann jetzt in Campaign Classic verwendet werden.

Im Folgenden finden Sie die FCM-Payload-Namen, mit denen Sie Ihre Push-Benachrichtigung weiter personalisieren können:

Nachrichtentyp Konfigurierbares Nachrichtenelement (FCM-Payload-Name) Konfigurierbare Optionen (Name der FCM-Payload)
Datennachricht K. A. validate_only
Benachrichtigungsinhalt title, body, android_channel_id, icon, sound, tag, color, click_action, image, ticker, sticky, visibility, notification_priority, notification_count
validate_only


Konfigurieren der HTTP-API (frühere Version)

Gehen Sie wie folgt vor, um die HTTP-API-Version (frühere Version) zu konfigurieren:

  1. Wählen Sie im Fenster des Mobile-App-Assistenten aus der Dropdown-Liste API-Version die Option HTTP (frühere Version) aus.

  2. Geben Sie den Projektschlüssel ein, den der Entwickler der Mobile App bereitgestellt hat.

  3. Bei Bedarf können Sie die Inhalte von Push-Nachrichten mit bestimmten Anwendungsvariablen anreichern. Diese sind vollständig anpassbar; ein Teil der Payload der Nachricht wird an das Mobilgerät gesendet.

    Im folgenden Beispiel werden title, imageURL und iconURL hinzugefügt, um eine Rich-Push-Benachrichtigung einzurichten. Danach werden der Anwendung das Bild, der Titel und das Symbol bereitgestellt, die in der Benachrichtigung angezeigt werden sollen.

  4. Klicken Sie auf Beenden und danach auf Speichern. Ihre Android-Anwendung kann jetzt in Campaign Classic verwendet werden.

Im Folgenden finden Sie die FCM-Payload-Namen, mit denen Sie Ihre Push-Benachrichtigung weiter personalisieren können:

Nachrichtentyp Konfigurierbares Nachrichtenelement (FCM-Payload-Name) Konfigurierbare Optionen (Name der FCM-Payload)
Datennachricht K. A. dryRun
Benachrichtigungsinhalt title, body, android_channel_id, icon, sound, tag, color, click_action
dryRun

Erweitern des appsubscriptionRcp-Schemas

Erfahren Sie im Video, wie Sie das appsubscriptionRcp-Schema erweitern

Sie müssen die appsubscriptionRcp erweitern, um in der Campaign-Datenbank neue zusätzliche Felder zum Speichern von Parametern aus der App zu definieren. Diese Felder werden beispielsweise für die Personalisierung verwendet. Gehen Sie dazu wie folgt vor:

  1. Erstellen Sie eine Erweiterung des Schemas Abonnentenanwendungen (nms:appsubscriptionRcp) und definieren Sie die neuen Felder. Weitere Informationen zur Erweiterung eines Schemas finden Sie auf dieser Seite

  2. Geben Sie im Tab Abonnementparameter das Mapping an.

    VORSICHT

    Stellen Sie sicher, dass die Parameterbezeichnungen im Tab Abonnementparameter mit denen im Anwendungs-Code übereinstimmen. Weitere Informationen finden Sie in diesem Abschnitt.

Auf dieser Seite