DokumentationCampaignDokumentation zu Campaign v8

Konfigurieren des Push-Benachrichtigungskanals push-notification-configuration

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Fortgeschrittener
  • Admin
  • Entwickler

Um Push-Benachrichtigungen mit Adobe Campaign zu senden, müssen Sie zunächst Ihre Umgebung und App wie auf dieser Seite beschrieben konfigurieren. In Adobe Campaign ist der Kanal zum Senden von Push-Benachrichtigungen der Mobile-App-Kanal.

CAUTION
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.

Bevor Sie mit dem Versand von Push-Benachrichtigungen mit Adobe Campaign beginnen, müssen Sie sicherstellen, dass Konfigurationen und Integrationen in der Mobile App sowie für Tags in Adobe Experience Platform vorhanden sind. Das Adobe Experience Platform Mobile SDK bietet Client-seitige Integrations-APIs für Ihre Mobilgeräte über Android- und iOS-kompatible SDKs.

Gehen Sie wie folgt vor, um Ihre App mit Adobe Experience Platform Mobile SDKs einzurichten:

  1. Überprüfen Sie die Voraussetzungen.
  2. Richten Sie eine mobile Tag-Eigenschaft in der Adobe Experience Platform-Datenerfassung ein.
  3. Rufen Sie das Adobe Experience Platform Mobile SDK ab, wie auf dieser Seite beschrieben.
  4. (optional) Aktivieren Sie die Protokollierung und Lebenszyklusmetriken, wie auf dieser Seite beschrieben.
  5. (optional) Fügen Sie Adobe Experience Platform Assurance zu Ihrer App hinzu, um Ihre Implementierung zu validieren. Auf dieser Seite erfahren Sie, wie Sie die Adobe Experience Platform Assurance-Erweiterung implementieren{target=“_blank”}.
  6. Konfigurieren Sie Ihre Mobile Services für iOS und Android in Adobe Campaign, wie auf dieser Seite beschrieben.
  7. Installieren und konfigurieren Sie die Adobe Campaign-Erweiterung in Ihrer Mobile-Eigenschaft.
  8. Folgen Sie der Dokumentation zum Adobe Experience Platform Mobile SDK, um das Adobe Experience Platform Mobile SDK in Ihrer App einzurichten.

Voraussetzungen before-starting

Einrichten von Berechtigungen setup-permissions

Bevor Sie eine Mobile App erstellen, müssen Sie zunächst sicherstellen, dass Sie in Adobe Experience Platform über die richtigen Benutzerberechtigungen für Tags verfügen, oder diese Berechtigungen zuweisen. Benutzerberechtigungen für Tags in Adobe Experience Platform werden Benutzerinnen und Benutzern über Adobe Admin Console zugewiesen. Weitere Informationen finden Sie in der Tags-Dokumentation.

CAUTION
Die Push-Konfiguration muss von einer erfahrenen Person durchgeführt werden. Abhängig von Ihrem Implementierungsmodell und den an dieser Implementierung beteiligten Rollen müssen Sie möglicherweise den gesamten Berechtigungssatz einem einzelnen Produktprofil zuweisen oder Berechtigungen zwischen der Person, die die App entwickelt, und den Adobe Campaign-Admins teilen.

Gehen Sie wie folgt vor, um Rechte für Eigenschaft und Firma zuzuweisen.

  1. Greifen Sie auf die Admin Console zu.

  2. Wählen Sie auf der Registerkarte Produkte die Karte Datenerfassung in Adobe Experience Platform aus.

  3. Wählen Sie ein vorhandenes Produktprofil aus oder erstellen Sie mit der Schaltfläche Neues Profil ein neues. Wie Sie ein neues Profil erstellen, erfahren Sie in der Dokumentation zu Admin Console.

  4. Wählen Sie auf der Registerkarte Berechtigungen die Option Eigenschaftsrechte aus.

  5. Klicken Sie auf Alle hinzufügen. Dadurch wird Ihrem Produktprofil die folgende Berechtigung hinzugefügt:

    • Genehmigen
    • Entwickeln
    • Eigenschaft bearbeiten
    • Umgebungen verwalten
    • Erweiterungen verwalten
    • Veröffentlichen

    Diese Berechtigungen sind erforderlich, um die Adobe Campaign-Erweiterung zu installieren und zu veröffentlichen und die App-Eigenschaft im Adobe Experience Platform Mobile SDK zu veröffentlichen.

  6. Wählen Sie anschließend Unternehmensrechte im Menü links aus.

  7. Fügen Sie die folgenden Rechte hinzu:

    • App-Konfigurationen verwalten
    • Eigenschaften verwalten

    Diese Berechtigungen sind erforderlich, damit die Entwicklerin bzw. der Entwickler der mobilen App in der Datenerfassung in Adobe Experience Platform Push-Anmeldedaten einrichten kann.

  8. Klicken Sie auf Speichern.

Um dieses Produktprofil für Benutzerinnen und Benutzer zuzuweisen, gehen Sie folgendermaßen vor.

  1. Greifen Sie auf die Admin Console zu.

  2. Wählen Sie auf der Registerkarte Produkte die Karte Datenerfassung in Adobe Experience Platform aus.

  3. Wählen Sie das zuvor konfigurierte Produktprofil aus.

  4. Klicken Sie auf der Registerkarte Benutzer auf Benutzer hinzufügen.

  5. Geben Sie den Namen oder die E-Mail-Adresse Ihrer Benutzerin bzw. Ihres Benutzers ein und wählen Sie sie bzw. ihn aus. Klicken Sie anschließend auf Speichern.

    note note
    NOTE
    Wenn die Benutzerin oder der Benutzer nicht zuvor in Admin Console erstellt wurde, lesen Sie den Abschnitt Dokumentation zum Hinzufügen von Benutzerinnen und Benutzern.

Konfigurieren der App configure-app

Die technische Einrichtung erfordert eine enge Zusammenarbeit zwischen der Person, die die App entwickelt, und den Business-Admins. Bevor Sie mit dem Versand von Push-Benachrichtigungen mit Adobe Campaign beginnen, müssen Sie Einstellungen in Adobe Experience Platform Data Collection definieren und Ihre Mobile App mit Adobe Experience Platform Mobile SDKs integrieren.

Folgen Sie den Implementierungsschritten, die in den folgenden Links beschrieben werden:

  • Für Apple iOS: Erfahren Sie in der Apple-Dokumentation, wie Sie Ihre App mit APNs registrieren
  • Für Google Android: Erfahren Sie in der Google-Dokumentation, wie Sie eine Firebase Cloud Messaging-Client-App unter Android einrichten

Einrichten einer Mobile-Tag-Eigenschaft in der Datenerfassung in Adobe Experience Platform launch-property

Durch das Einrichten einer Mobile-Eigenschaft können Entwicklerinnen und Entwickler der Mobile App oder Marketing-Fachleute die Mobile SDKs konfigurieren. Normalerweise erstellen Sie für jede Mobile App, die Sie verwalten möchten, eine Mobile-Eigenschaft. Erfahren Sie in der Dokumentation zum Adobe Experience Platform Mobile SDK, wie Sie eine Mobile-Eigenschaft erstellen und konfigurieren.

Weitere Informationen über Adobe Experience Platform Data Collection-Tags finden Sie in der Dokumentation zu Adobe Experience Platform.

Öffnen Sie nach der Erstellung die neue Tag-Eigenschaft und erstellen Sie eine Bibliothek. Gehen Sie dazu wie folgt vor:

  1. Navigieren Sie in der linken Navigation zu Veröffentlichungsfluss und wählen Sie Bibliothek hinzufügen aus.
  2. Geben Sie den Namen der Bibliothek ein und wählen Sie die Umgebung aus.
  3. Wählen Sie Alle geänderten Ressourcen hinzufügen und Speichern und für die Entwicklung erstellen aus.
  4. Legen Sie diese Bibliothek mithilfe der Schaltfläche Arbeitsbibliothek auswählen als Arbeitsbibliothek fest.

Konfigurieren Ihrer Mobile Services in Campaign push-service

Wenn Ihre App in Adobe Experience Platform Data Collection eingerichtet ist, müssen Sie zwei Services erstellen (einen für iOS-Geräte, einen für Android-Geräte), um Push-Benachrichtigungen von Adobe Campaign senden zu können.

Push-Benachrichtigungen werden über einen dedizierten Dienst an die Benutzerinnen und Benutzer Ihrer App gesendet. Wenn Benutzerinnen und Benutzer Ihre Anwendung installieren, abonnieren sie diesen Dienst: Adobe Campaign greift auf diesen Dienst zurück, um nur die Abonnentinnen und Abonnenten Ihrer App anzusprechen. In diesem Dienst müssen Sie Ihre iOS- und Android-Apps hinzufügen, um etwas auf iOS- und Android-Geräten zu senden.

Gehen Sie wie folgt vor, um einen Dienst zum Senden von Push-Benachrichtigungen zu erstellen:

  1. Navigieren Sie zu Profile und Zielgruppen > Services und Abonnements und klicken Sie auf Erstellen.

    {width="800"}

  2. Geben Sie einen Titel und einen internen Namen ein und wählen Sie den Typ Mobile App aus.

    note note
    NOTE
    Das standardmäßige Zielgruppen-Mapping von 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. Weitere Informationen über Zielgruppen-Mapping finden Sie auf dieser Seite.

  3. Klicken Sie dann auf das Symbol Hinzufügen oben rechts, um die Mobile Apps zu definieren, die diesen Dienst verwenden.

iOS

Gehen Sie wie folgt vor, um eine App für iOS-Geräte zu erstellen:

  1. Wählen Sie iOS-Anwendung erstellen aus und klicken Sie auf Weiter.

    {width="600"}

  2. Geben Sie den Namen Ihrer App im Feld Titel ein.

  3. (Optional) Sie können den Inhalt einer Push-Nachricht mit einigen Anwendungsvariablen anreichern. Diese sind vollständig anpassbar und Teil der an das mobile Gerät gesendeten Nachrichten-Payload.

    Im folgenden Beispiel werden die Variablen mediaURl und mediaExt hinzugefügt, um eine Rich-Push-Benachrichtigung zu erstellen. Danach wird der App das Bild bereitgestellt, das in der Benachrichtigung angezeigt werden soll.

    {width="600"}

  4. Auf der Registerkarte Abonnementparameter können Sie das Mapping mit einer Erweiterung des Schemas Abonnierte Anwendungen (nms:appsubscriptionRcp) definieren.

  5. Navigieren Sie zur Registerkarte Töne, um einen Ton festzulegen, der wiedergegeben werden soll. Klicken Sie auf Hinzufügen und füllen Sie das Feld Interner Name aus, das den Namen der in die Anwendung eingebetteten Datei oder den Namen des Systemtons enthalten muss.

  6. Klicken Sie auf Weiter, um mit dem Konfigurieren der Entwicklungsanwendung zu beginnen.

  7. Der Integrationsschlüssel ist für jede Anwendung spezifisch. Dadurch wird die Mobile App mit Adobe Campaign verknüpft.

    Stellen Sie sicher, dass in Adobe Campaign und im Appcode über das SDK derselbe Integrationsschlüssel definiert ist

    Weitere Informationen finden Sie in der Developer-Dokumentation

    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.
    Sie können nicht dasselbe Zertifikat sowohl für die Entwicklungsversion (Sandbox) als auch für die Produktionsversion der Anwendung verwenden.

  8. Wählen Sie im Feld Anwendungssymbol das Symbol aus, um die Mobile App in Ihrem Dienst zu personalisieren.

  9. Wählen Sie den Authentifizierungsmodus aus. Zwei Modi sind verfügbar:

    • (Empfohlen) Token-basierte Authentifizierung: Füllen Sie die Verbindungseinstellungen Schlüssel-ID, Team-ID und Paket-ID aus und wählen Sie dann Ihr p8-Zertifikat, indem Sie auf Privaten Schlüssel eingeben… klicken. Weitere Informationen zur Token-basierten Authentifizierung finden Sie in der Apple-Dokumentation.

    • Zertifikatbasierte Authentifizierung: Klicken Sie auf Zertifikat eingeben…. Wählen Sie dann Ihren p12-Schlüssel und geben Sie das Passwort ein, das der Entwickler bzw. die Entwicklerin der Mobile App bereitgestellt hat. Beachten Sie, dass dieses Zertifikat ein Ablaufdatum besitzt und jährlich erneuert werden muss. Um eine Unterbrechung des Diensts für Ihre Benutzenden zu vermeiden, müssen Sie Ihre Zertifikate aktualisieren, bevor sie ablaufen. Zertifikate sind ein Jahr lang gültig und müssen aktualisiert werden, um weiterhin mit APNs kommunizieren zu können.

  10. Klicken Sie auf die Schaltfläche Verbindung testen, um Ihre Konfiguration zu validieren.

  11. Nun können Sie die Produktionsanwendung konfigurieren, indem Sie auf Weiter klicken und nach dem gleichen Verfahren wie oben beschrieben vorgehen.

  12. Klicken Sie auf Beenden.

Ihre iOS-Anwendung kann jetzt in Campaign verwendet werden.

Android

Gehen Sie wie folgt vor, um eine App für Android-Geräte zu erstellen:

  1. Wählen Sie Android-Anwendung erstellen aus und klicken Sie auf Weiter.

    {width="600"}

  2. Geben Sie den Namen Ihrer App im Feld Titel ein.

  3. Der Integrationsschlüssel ist für jede Anwendung spezifisch. Dadurch wird die Mobile App mit Adobe Campaign verknüpft.

    Stellen Sie sicher, dass in Adobe Campaign und im Appcode über das SDK derselbe Integrationsschlüssel definiert ist

    Weitere Informationen finden Sie in der Developer-Dokumentation

    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 im Feld Anwendungssymbol das Symbol aus, um die Mobile App in Ihrem Dienst zu personalisieren.

  5. Wählen Sie HTTP v1 in der Dropdown-Liste API-Version aus.

  6. 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 in der Dokumentation zu Google Firebase.

    Sie können auch die folgenden Details manuell eingeben:

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

  7. Klicken Sie auf die Schaltfläche Verbindung testen, um Ihre Konfiguration zu validieren.

    note caution
    CAUTION
    Mit der Schaltfläche Verbindung testen wird nicht geprüft, ob der MID-Server Zugriff auf den FCM-Server hat.

  8. 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.

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

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

table 0-row-3 1-row-3 2-row-3 1-align-center 2-align-center 3-align-center 5-align-center 6-align-center 7-align-center 9-align-center 10-align-center 11-align-center
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 Adobe Campaign-Erweiterung in Ihrer Mobile-Eigenschaft configure-extension

Die Adobe Campaign Classic-Erweiterung für Adobe Experience Platform Mobile SDKs ermöglicht Push-Benachrichtigungen für Ihre Mobile Apps, unterstützt Sie bei der Erfassung von Benutzer-Push-Token und verwaltet die Messung von Interaktionen mit Adobe Experience Platform-Services.

Diese Erweiterung, die sowohl für Campaign Classic v7 als auch für Campaign v8 gilt, ist in Ihrer Umgebung vorinstalliert und muss konfiguriert werden. Gehen Sie wie folgt vor, um die Erweiterung für Ihre Mobile-Tag-Eigenschaft zu konfigurieren:

  1. Öffnen Sie die zuvor erstellte Tag-Eigenschaft.
  2. Navigieren Sie in der linken Navigation zu Erweiterungen und öffnen Sie die Registerkarte Katalog. Verwenden Sie das Suchfeld, um die Adobe Campaign Classic-Erweiterung zu finden.
  3. Klicken Sie auf der Karte „Campaign Classic“ auf die Schaltfläche Installieren.
  4. Geben Sie Einstellungen ein, wie in der Dokumentation zum Adobe Experience Platform Mobile SDK beschrieben.

Sie können jetzt Campaign zu Ihrer App hinzufügen, wie in der Dokumentation zum Adobe Experience Platform Mobile SDK beschrieben.

recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b