DokumentationJourney OptimizerHandbuch für Journey Optimizer

[Eingeschränkte Verfügbarkeit]{class="badge informative"}

Einrichten eines benutzerdefinierten Kanals create-custom-channel

Letzte Aktualisierung: 16. Juli 2026

Erstellt für:

  • Experienced
  • Admin

Um einen benutzerdefinierten Kanal in -Kampagnen und -Journey verwenden zu können, muss zunächst ein Administrator den Kanal erstellen. Dazu gehört die Definition des Endpunkts, der Authentifizierung, der Drosselungsrichtlinie und der Payload-Struktur der Nachricht.

Der Channel Builder-Abschnitt ist die zentrale Schnittstelle zum Definieren neuer benutzerdefinierter Kanäle. Damit können Sie benutzerdefinierte Kanäle erstellen und konfigurieren, aber auch API-Anmeldeinformationen verwalten und Subdomains delegieren.

IMPORTANT
Um auf den Channel Builder zugreifen, benutzerdefinierte Kanäle erstellen und verwalten zu können, benötigen Sie die Berechtigungen Benutzerdefinierte Kanäle anzeigen und Benutzerdefinierte Kanäle verwalten . Erfahren Sie in (​ Abschnitt), wie Sie Berechtigungen ​.

Zugreifen auf und Verwalten von benutzerdefinierten Kanälen access-channel-builder

Gehen Sie wie folgt vor, um auf Channel Builder zuzugreifen und Ihre benutzerdefinierten Kanäle zu verwalten.

  1. Navigieren Sie Administration > Kanäle in der linken Navigationsleiste.

  2. Wählen Benutzerdefinierte Kanäle im Abschnitt Channel Builder aus.

    Benutzerdefinierter Kanalbestand {width="70%"}

  3. Das Inventar listet alle benutzerdefinierten Kanäle in Ihrer Sandbox auf, einschließlich ihres aktuellen Status und des Authentifizierungstyps, der zum Herstellen einer Verbindung mit dem externen Endpunkt verwendet wird.

  4. Sie können die benutzerdefinierten Kanäle nach Status (Entwurf, Aktiv oder Archiviert) filtern, von wem sie erstellt wurden, und nach Namen suchen.

  5. Um einen Kanal zu bearbeiten, klicken Sie im Inventar auf seinen Namen, nehmen Sie die Änderungen vor und speichern Sie. Für aktive Kanäle können nur bestimmte Felder bearbeitet werden (​ Informationen.

    note caution
    CAUTION
    Die Änderung der Drosselungs- oder Wiederholungseinstellungen für einen aktiven Kanal wird sofort für alle laufenden und zukünftigen Ausführungen wirksam.

  6. Um einen Kanal zu archivieren, öffnen Sie ihn im Inventar und klicken Sie auf Archivieren.

    Wenn Sie einen aktiven Kanal archivieren, wird er aus allen Auswahl-Dropdown-Menüs entfernt - Kampagnenaktionsselektor, Journey-Aktionspalette, orchestrierte Kampagnenkanalliste, Kanalkonfigurationen und Inhaltsvorlagen. Bestehende Journey und Kampagnen, die den -Kanal bereits verwenden, funktionieren weiterhin normal.

Erstellen eines benutzerdefinierten Kanals create-channel

Gehen Sie wie folgt vor, um einen neuen benutzerdefinierten Kanal zu erstellen.

  1. Klicken Sie auf Benutzerdefinierten Kanal erstellen, um das Formular zur Kanalerstellung zu öffnen. Definieren Sie zunächst die allgemeinen Einstellungen für Ihren benutzerdefinierten Kanal.

    Allgemeine Einstellungen {width="70%"}

  2. Geben Sie Abschnitt einen Namen für Ihren benutzerdefinierten Kanal ein. Dieser Name wird auf der Journey-Arbeitsfläche, in der Auswahl der Kampagnenaktion und in der Liste der Kanäle für orchestrierte Kampagnen angezeigt.

    note
    NOTE
    Der Name muss eindeutig sein, mit einem Buchstaben (A-Z) beginnen, nur alphanumerische Zeichen oder Sonderzeichen ( _, ., -) enthalten und sollte mehr als 1 Zeichen lang sein.

  3. Sie können ein Symbol aus der standardmäßigen Symbolbibliothek auswählen oder eine SVG-Datei auf Ihrem Computer auswählen.

    note
    NOTE
    Die Datei darf nicht größer als 150 KB sein.

    Dieses Symbol wird neben dem Kanalnamen auf der Journey-Arbeitsfläche angezeigt. Wenn kein Symbol hochgeladen wird, wird das Standardsymbol verwendet.

  4. Geben Sie eine optionale Beschreibung ein.

Festlegen der Endpunktkonfiguration endpoint-configuration

Sie müssen den Endpunkt konfigurieren. Dies ist die HTTP-URL Ihres externen Messaging-Systems. Journey Optimizer sendet eine POST-Anfrage mit der personalisierten Payload an diesen Endpunkt, wenn sich ein Profil in einer Kampagne oder auf einer Journey qualifiziert.

Endpunktkonfiguration {width="70%"}

  1. Geben im Abschnitt „Endpunktkonfiguration den Host URL Ihres externen Messaging-Systems ein.

    note important
    IMPORTANT
    Ihr externes Messaging-System muss einen HTTPS-Endpunkt bereitstellen, den Journey Optimizer über HTTP POST aufrufen können. Der Endpunkt muss:
    • Akzeptieren Sie das von Ihrem Kanal definierte Payload-Format (JSON).
    • Unterstützt eine der Authentifizierungsmethoden, die im Channel Builder verfügbar sind. Weitere Informationen
    • Gibt eine HTTP 2xx-Antwort zurück, um den erfolgreichen Empfang der Anfrage zu bestätigen.

  2. Fügen Sie Kopfzeilen nach Bedarf hinzu. Header sind Schlüssel-Wert-Paare, die auf HTTP-Anfrageebene übertragen werden. Sie werden zusammen mit jeder Anfrage an Ihren Endpunkt gesendet und normalerweise für Authentifizierungs-Token, Inhaltstypspezifikationen oder andere Metadaten verwendet, die von Ihrem externen System benötigt werden.

    Headers-Konfiguration

    Für jede Kopfzeile können Sie festlegen, ob ihr Wert wie folgt lautet:

    • Konstante - Ein statischer Wert, der einmal festgelegt und in jeder Anfrage enthalten ist. Sie können beispielsweise den Content-Type mit dem Wert application/json oder den Charset mit dem Wert UTF-8 definieren.
    • Variable - Wenn hier ein Standardwert eingegeben wird, wird er verwendet, es sei denn, er wird in der Kanalkonfiguration überschrieben. Sie können beispielsweise eine Variable für die Benutzer-ID definieren, die zur Laufzeit aufgelöst wird. Weitere Informationen

  3. Fügen Sie optional Abfrageparameter“ demselben Konstanten-/Variablenmuster hinzu. Abfrageparameter werden zur Versandzeit an die Endpunkt-URL angehängt. Konstante Parameter werden immer mit demselben Wert hinzugefügt. Variablenparameter werden zum Sendezeitpunkt aufgelöst, z. B. um eine Benutzerkennung aus dem Profil zu übergeben.

    Abfrageparameter {width="70%"}

  4. Definieren Sie Abschnitt Richtlinienkonfiguration“, wie Journey Optimizer mit Anfragedurchsatz und -fehlern umgeht. Dies ist wichtig, um sicherzustellen, dass Ihr externes System das Anfragevolumen verarbeiten kann, und um eine Überlastung zu vermeiden.

    Richtlinienkonfiguration

    • Drosselung aktivieren - Standardmäßig deaktiviert. Legen Sie die maximale Anzahl von Anfragen pro Sekunde fest (Standard: 5.000c). Sobald das Limit erreicht ist, werden Anfragen in die Warteschlange gestellt und so bald wie möglich gesendet.
    • Wiederholen aktivieren - Standardmäßig aktiviert. Legen Sie die maximale Wiederholungsanzahl (Standard: 3) konfigurierbaren Bereich: 0-10) für fehlgeschlagene Anfragen fest. Dadurch wird verhindert, dass der Endpunkt während vorübergehender Fehler überlastet wird.
    • Zeitüberschreitung - Standard: 5.000 Millisekunden. Legen Sie die maximale Zeit fest, die auf eine Antwort des Endpunkts gewartet werden soll, bevor die Anfrage als fehlgeschlagen eingestuft wird.

Authentifizierungseinstellungen authentication-settings

Wählen Sie „Authentifizierungstyp aus, den Sie für diesen Kanal verwenden müssen. Die verfügbaren Optionen hängen von den Authentifizierungsmethoden ab, die von Ihrem externen Messaging-System unterstützt werden.

Authentifizierungstyp {width="70%"}

Geben Sie die Authentifizierungsdetails an, wie von Ihrem Endpunkt benötigt.

  • Keine - Die Anfrage wird ohne Anmeldeinformationen gesendet.
  • API-Schlüssel - Geben Sie den Schlüsselnamen, den Wert und den Speicherort (Abfrageparameter oder Kopfzeile) an.
  • Einfache Authentifizierung - Geben Sie einen Benutzernamen und ein Kennwort ein.
  • OAuth 2.0 - Konfigurieren der Payload für die OAuth 2.0-Authentifizierung.

Wenn es sich bei dem Authentifizierungstyp um einen anderen als "" handelt, generiert Journey Optimizer automatisch einen ersten Satz von API-Anmeldeinformationen für diesen Kanal, wenn er aktiviert wird. Sie können diese Anmeldeinformationen ändern und neue im Inventar der API-Anmeldeinformationen erstellen. Weitere Informationen

Die Authentifizierungsdetails sind jedoch hier erforderlich, um die Verbindung zu Ihrem Endpunkt zu testen, bevor Sie den Kanal aktivieren. Zur der Authentifizierungseinstellungen die Schaltfläche „Verbindung testen“ verfügbar. Weitere Informationen

Payload-Konfiguration payload-configuration

Die Payload wird an den Endpunkt gesendet, wenn sich ein Profil in einer Kampagne oder auf einer Journey qualifiziert.

Definieren Sie in der Payload-Konfiguration die Struktur der Nachrichten-Payload und die Felder, die Marketing-Experten erstellen und personalisieren können.

  1. Klicken Sie Payload definieren und wählen Sie aus, wie die Payload definiert werden soll:

    • Beispiel-JSON-Payload einfügen - Fügen Sie ein repräsentatives JSON-Objekt ein und leitet Journey Optimizer automatisch ein Schema daraus ab.

    • JSON-Schema importieren (in Kürze verfügbar) - Laden Sie eine vollständige JSON-Schemadatei hoch.

      note availability
      AVAILABILITY
      Diese Funktion ist noch nicht verfügbar. Sie wird in einer zukünftigen Version hinzugefügt.

  2. Nachdem das Schema generiert wurde, zeigt Journey Optimizer alle erkannten Felder in einer Formularansicht an.

  3. Konfigurieren Sie für jedes Feld die folgenden Einstellungen:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Einstellung Beschreibung
    Standardwert Optional. Wird verwendet, wenn beim Authoring kein personalisierter Wert angegeben wird.
    Typ Schreibgeschützt, von der Payload abgeleitet. Unterstützte Typen: string, integer, decimal, boolean, dateTime, dateTimeOnly, dateOnly, listObject, listString, listInteger, listDecimal, listBoolean, listDateTime, listDateTimeOnly, listDateOnly.
    Erforderlich Wenn diese Option aktiviert ist, muss das Feld einen Wert enthalten, wenn der Kanal in einer Kampagne oder auf einer Journey verwendet wird. Fehlende Pflichtfelder : Trigger eines Validierungsfehlers, der die Aktivierung verhindert.
    Kanalkonfiguration Wenn diese Option aktiviert ist, wird das Feld in der Kanalkonfiguration angezeigt, sodass Admins für jede Konfiguration unterschiedliche Werte festlegen können (z. B. eine andere Absender-ID pro Marke oder Region). Weitere Informationen

    Verschachtelte Felder werden mit Punktnotation dargestellt (z. B. image.id)

Testen und Aktivieren test-activate

Während sich der Kanal im Status Entwurf befindet, verwenden Sie die Schaltfläche Verbindung testen am oberen Bildschirmrand, um eine Testanfrage an Ihren Endpunkt zu senden und die End-to-End-Verbindung zu validieren.

Schaltfläche „Verbindung testen“ {width="70%"}

Überprüfen Sie die Protokolle Ihres externen Systems, um sicherzustellen, dass die Anfrage mit der erwarteten Authentifizierung und Payload empfangen wurde.

Nach erfolgreichem Test können Sie den Kanal speichern oder aktivieren.

  • Klicken Sie Als Entwurf speichern, um Ihren Fortschritt zu speichern, ohne den Kanal verfügbar zu machen.
  • Klicken Sie Aktivieren, um den Kanal für die Verwendung in Kanalkonfigurationen, Kampagnen und Journey verfügbar zu machen.
IMPORTANT
Nachdem ein Kanal aktiviert wurde, können nur die folgenden Felder bearbeitet werden: Name, Beschreibung, Symbol, Einschränkungen und Konfiguration wiederholen. Endpunkt-URL, Kopfzeilen, Abfrageparameter, Authentifizierung und Payload-Struktur sind gesperrt.

Nächste Schritte next-steps

Ihr benutzerdefinierter Kanal wird jetzt erstellt. Schließen Sie die Konfiguration ab, indem Sie die verbleibenden Schritte ausführen:

recommendation-more-help
journey-optimizer-help