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.
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:
-
Gehen Sie zu Administration > Plattform > Externe Konten.
-
Wählen Sie das externe Konto Android-Routing aus.
-
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. -
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.
-
Klicken Sie im Knoten Profile und Zielgruppen > Dienste und Abonnements auf die Schaltfläche Neu.
-
Bestimmen Sie einen Titel und einen internen Namen.
-
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. -
Klicken Sie dann auf die Schaltfläche Hinzufügen, um den Anwendungstyp auszuwählen.
-
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:
-
Klicken Sie in Ihrem neu erstellten Dienst auf die Schaltfläche Hinzufügen, um den Anwendungstyp auszuwählen.
-
Wählen Sie Android-Anwendung erstellen aus und geben Sie einen Titel ein.
-
Stellen Sie sicher, dass in Adobe Campaign und im Anwendungs-Code derselbe Integrationsschlüssel definiert ist (über das SDK).
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. -
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.
-
Füllen Sie die Felder für Verbindungsparameter für Firebase Cloud Messaging for Android aus.
-
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
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:
-
Wählen Sie im Fenster des Mobile-App-Assistenten die Option HTTP v1 aus der Dropdown-Liste API-Version aus.
-
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
-
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. -
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.
-
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:
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:
-
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
-
Geben Sie auf der Registerkarte Abonnementparameter das Mapping an.
note caution CAUTION Stellen Sie sicher, dass die Parameterbezeichnungen auf der Registerkarte Abonnementparameter mit denen im Anwendungs-Code übereinstimmen.