Konfigurationsschritte für Android

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

Die wichtigsten Schritte sind:

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

IMPORTANT
Einige wichtige Änderungen am FCM-Dienst (Android Firebase Cloud Messaging) werden 2024 veröffentlicht und können sich auf Ihre Implementierung von Adobe Campaign auswirken. Ihre Konfiguration der Anmeldedienste für Android-Push-Nachrichten muss möglicherweise aktualisiert werden, um diese Änderung zu unterstützen. Sie können dies bereits überprüfen und Maßnahmen ergreifen. Weitere Informationen finden Sie in dieser Technote zu Adobe Campaign v8.

Konfigurieren des externen Android-Kontos configuring-external-account-android

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

    note note
    NOTE
    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 configuring-android-service

Erfahren Sie im Video, wie Sie einen Android-Dienst 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.

    note note
    NOTE
    Das standardmäßige Zielgruppen-Mapping für abonnierte Anwendungen (nms:appSubscriptionRcp) ist mit der Empfängertabelle verknüpft. Wenn Sie ein anderes Zielgruppen-Mapping verwenden möchten, müssen Sie ein neues Zielgruppen-Mapping erstellen und es im Feld Zielgruppen-Mapping des Dienstes eingeben. 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 creating-android-app

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.

    note note
    NOTE
    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:

Konfigurieren der API-Version select-api-version

IMPORTANT
Einige wichtige Änderungen am FCM-Dienst (Android Firebase Cloud Messaging) werden 2024 veröffentlicht und können sich auf Ihre Implementierung von Adobe Campaign auswirken. Im Rahmen der kontinuierlichen Bemühungen von Google, seine Dienste zu verbessern, werden die veralteten FCM-APIs am 20. Juni 2024 eingestellt. Weitere Informationen finden Sie in dieser Technote zu Adobe Campaign v8.

Nachdem Sie einen Dienst und eine neue Mobile App erstellt haben, müssen Sie Ihre Mobile App entsprechend der ausgewählten API-Version konfigurieren. Die HTTP-API (veraltet) sollte nicht ausgewählt werden, da sie von Google nicht mehr unterstützt wird.

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.

    note caution
    CAUTION
    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

Erweitern des appsubscriptionRcp-Schemas extend-subscription-schema

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.

    note caution
    CAUTION
    Stellen Sie sicher, dass die Parameterbezeichnungen im Tab Abonnementparameter mit denen im Anwendungs-Code übereinstimmen. Weitere Informationen finden Sie in diesem Abschnitt.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1