Konfigurieren einer benutzerdefinierten Aktion configure-a-custom-action
Wenn Sie ein Drittanbietersystem zum Nachrichtenversand verwenden oder wenn Sie möchten, dass von Journeys API-Aufrufe an ein Drittanbietersystem gesendet werden, verwenden Sie benutzerdefinierte Aktionen, um die Verbindung zwischen dem System und Ihrer Journey zu konfigurieren. Sie können mit benutzerdefinierten Aktionen beispielsweise eine Verbindung mit den folgenden Systemen herstellen: Epsilon, Slack, Adobe Developer, Firebase usw.
Benutzerdefinierte Aktionen sind zusätzliche Aktionen, die von technischen Benutzern definiert und Marketing-Experten zur Verfügung gestellt werden. Nach der Konfiguration erscheinen sie in der linken Palette Ihrer Journey in der Kategorie Aktion. Weiterführende Informationen finden Sie auf dieser Seite.
Einschränkungen custom-actions-limitations
Für benutzerdefinierte Aktionen gibt es einige Einschränkungen, die auf dieser Seite aufgeführt sind.
In den Parametern für benutzerdefinierte Aktionen können Sie sowohl eine einfache Sammlung als auch eine Sammlung von Objekten übergeben. Weitere Informationen zu den Einschränkungen von Sammlungen finden Sie auf dieser Seite.
Beachten Sie auch, dass bei den Parametern für benutzerdefinierte Aktionen ein bestimmtes Format erwartet wird (Beispiel: Zeichenfolge, Dezimalwert usw.). Sie müssen darauf achten, dass diese erwarteten Formate eingehalten werden. Weitere Informationen finden Sie in diesem Anwendungsfall.
Benutzerdefinierte Aktionen unterstützen das JSON-Format nur bei Verwendung von Anfrage- oder Antwort-Payloads.
Best Practices custom-action-enhancements-best-practices
Stellen Sie bei der Auswahl eines mit einer benutzerdefinierten Aktion anzusprechenden Endpunkts sicher, dass:
- Dieser Endpunkt den Journey-Durchsatz unterstützen kann, indem er ihn mit Konfigurationen aus der Drosselungs-API oder Begrenzungs-API begrenzt. Vorsicht: Eine Drosselungskonfiguration darf nicht unter 200 TPS liegen. Jeder angesprochene Endpunkt muss mindestens 200 TPS unterstützen.
- Dieser Endpunkt muss eine so niedrige Antwortzeit wie möglich haben. Abhängig von Ihrem erwarteten Durchsatz kann sich eine hohe Reaktionszeit auf den tatsächlichen Durchsatz auswirken.
Für alle benutzerdefinierten Aktionen ist ein Begrenzung von 300.000 Aufrufen über eine Minute festgelegt. Darüber hinaus wird die Standardbegrenzung pro Host und Sandbox angewendet. Wenn Sie beispielsweise in einer Sandbox zwei Endpunkte mit demselben Host haben (z. B. https://www.adobe.com/endpoint1 und https://www.adobe.com/endpoint2), gilt die Begrenzung für alle Endpunkte unter dem Host adobe.com. „Endpunkt1“ und „Endpunkt2“ verwenden dieselbe Begrenzungskonfiguration. Wenn ein Endpunkt diesen Wert erreicht, wirkt sich dies auch auf den anderen Endpunkt aus.
Diese Beschränkung wurde auf der Grundlage der Kundennutzung festgelegt, um externe Endpunkte zu schützen, die von benutzerdefinierten Aktionen angesprochen werden. Sie müssen dies in Ihren zielgruppenbasierten Journeys berücksichtigen, indem Sie eine geeignete Leserate definieren (5000 Profile pro Sekunde, wenn benutzerdefinierte Aktionen verwendet werden). Bei Bedarf können Sie diese Einstellung überschreiben, indem Sie über unsere Begrenzungs- oder Drosselungs-API eine höhere Begrenzung oder Einschränkung definieren. Weitere Informationen finden Sie auf dieser Seite.
Sie sollten öffentliche Endpunkte aus verschiedenen Gründen nicht mit benutzerdefinierten Aktionen ansprechen:
- Ohne ordnungsgemäße Begrenzung oder Einschränkung besteht das Risiko, zu viele Aufrufe an einen öffentlichen Endpunkt zu senden, der ein solches Volumen möglicherweise nicht unterstützt.
- Profildaten können über benutzerdefinierte Aktionen gesendet werden, sodass das Ansprechen eines öffentlichen Endpunkts dazu führen kann, dass personenbezogene Daten versehentlich extern freigegeben werden.
- Sie haben keine Kontrolle über die Daten, die von öffentlichen Endpunkten zurückgegeben werden. Wenn ein Endpunkt seine API ändert oder damit beginnt, falsche Informationen zu senden, werden diese in gesendeten Nachrichten zur Verfügung gestellt, was negative Auswirkungen haben könnte.
Einverständnis und Data Governance privacy
In Journey Optimizer können Sie Data Governance- und Einverständnisrichtlinien auf Ihre benutzerdefinierten Aktionen anwenden. Damit verhindern Sie, dass bestimmte Felder in Drittanbietersysteme exportiert werden, und können Kunden ausschließen, die dem Empfang von E-Mails, Push- oder SMS-Nachrichten nicht zugestimmt haben. Weitere Informationen finden Sie auf den folgenden Seiten:
Konfigurationsschritte configuration-steps
Im Folgenden werden die wichtigsten Schritte beschrieben, die zum Konfigurieren einer benutzerdefinierten Aktion ausgeführt werden müssen:
-
Wählen Sie im Menü ADMINISTRATION die Option Konfigurationen. Klicken Sie im Abschnitt Aktionen auf Verwalten. Klicken Sie auf Aktion erstellen, um eine neue Aktion zu erstellen. Der Bereich für die Aktionskonfiguration wird auf der rechten Seite des Bildschirms geöffnet.
-
Geben Sie einen Namen für Ihre Aktion ein.
note note NOTE Es sind nur alphanumerische Zeichen und Unterstriche zulässig. Die maximale Länge beträgt 30 Zeichen. -
Fügen Sie Ihrer Aktion eine Beschreibung hinzu. Dieser Schritt ist optional.
-
Die Anzahl der Journeys, die diese Aktion verwenden, wird im Feld Verwendet in angezeigt. Sie können auf Customer Journeys anzeigen klicken, um die Liste der Journeys, die diese Aktion verwenden, anzuzeigen.
-
Definieren Sie die verschiedenen URL-Konfigurations-Parameter. Weitere Informationen finden Sie auf dieser Seite.
-
Konfigurieren Sie den Abschnitt Authentifizierung. Diese Konfiguration entspricht der für Datenquellen. Weiterführende Informationen finden Sie in diesem Abschnitt.
-
Definieren Sie die Aktionsparameter. Weitere Informationen finden Sie auf dieser Seite.
-
Klicken Sie auf Speichern.
Die Aktion ist jetzt konfiguriert und kann in Ihren Journeys verwendet werden. Weitere Informationen finden Sie auf dieser Seite.
note note NOTE Wenn eine benutzerdefinierte Aktion in einer Journey verwendet wird, sind die meisten Parameter schreibgeschützt. Sie können nur die Felder Name, Beschreibung, URL und den Abschnitt Authentifizierung ändern.
Endpunktkonfiguration url-configuration
Beim Konfigurieren einer benutzerdefinierten Aktion müssen Sie die folgenden Endpunkt-Konfigurationsparameter definieren:
-
Geben Sie im Feld URL die URL des externen Services an:
-
Wenn die URL statisch ist, geben Sie die URL in dieses Feld ein.
-
Wenn die URL einen dynamischen Pfad enthält, geben Sie nur den statischen Teil der URL ein, d. h. das Schema, den Host, den Port und optional einen statischen Teil des Pfads.
Beispiel:
https://xxx.yyy.com/somethingstatic/Sie geben den dynamischen Pfad der URL später an, wenn Sie die benutzerdefinierte Aktion zu einer Journey hinzufügen. Weitere Informationen.
note note NOTE Aus Sicherheitsgründen empfehlen wir dringend, das HTTPS-Schema für die URL zu verwenden. Die Verwendung nicht öffentlicher Adobe-Adressen und die Verwendung von IP-Adressen sind nicht zulässig. Bei der Definition einer benutzerdefinierten Aktion sind nur die Standard-Ports zulässig: 80 für http und 443 für https. -
-
Wählen Sie die Aufrufmethode aus: Es kann entweder POST, GET oder PUT sein.
note note NOTE Die Methode DELETE wird nicht unterstützt. Wenn Sie eine vorhandene Ressource aktualisieren müssen, wählen Sie die Methode PUT. -
Definieren Sie die Header und Abfrageparameter:
- Klicken Sie im Abschnitt Header auf Header-Feld hinzufügen, um die HTTP-Header-Zeilen der Anfragenachricht zu definieren, die an den externen Service gesendet werden soll. Die Header-Felder Content-Typ und Charset werden standardmäßig festgelegt. Sie können diese Felder nicht löschen. Es kann nur der Content-Typ-Header geändert werden. Sein Wert sollte dem JSON-Format entsprechen. Dies ist der Standardwert:
- Klicken Sie im Abschnitt Abfrageparameter auf Feld für Abfrageparameter hinzufügen, um die Parameter zu definieren, die Sie der URL hinzufügen möchten.
-
Geben Sie die Bezeichnung oder den Namen des Felds ein.
-
Wählen Sie einen Typ aus: konstant oder variabel. Wenn Sie konstant gewählt haben, geben Sie den konstanten Wert ins Wert-Feld ein. Wenn Sie Variabel ausgewählt haben, geben Sie diese Variable an, wenn Sie die benutzerdefinierte Aktion zu einer Journey hinzufügen. Weitere Informationen.
note note NOTE Nachdem Sie die benutzerdefinierte Aktion zu einer Journey hinzugefügt haben, können Sie ihr weiterhin Felder für Header- oder Abfrageparameter hinzufügen, wenn sich die Journey im Entwurfsstatus befindet. Wenn Sie nicht möchten, dass sich Konfigurationsänderungen auf die Journey auswirken, duplizieren Sie die benutzerdefinierte Aktion und fügen Sie die Felder zur neuen benutzerdefinierten Aktion hinzu. Header werden gemäß den folgenden Parsing-Regeln validiert. Weitere Informationen finden Sie in dieser Dokumentation.
mTLS-Protokoll-Unterstützung mtls-protocol-support
Sie können Mutual Transport Layer Security (mTLS) verwenden, um die Sicherheit bei ausgehenden Verbindungen zu benutzerdefinierten Aktionen von Adobe Journey Optimizer zu erhöhen. mTLS ist eine End-to-End-Sicherheitsmethode zur gegenseitigen Authentifizierung, die sicherstellt, dass beide Parteien, die Informationen austauschen, auch die sind, die sie vorgeben zu sein, bevor die Daten ausgetauscht werden. mTLS umfasst einen zusätzlichen Schritt im Vergleich zu TLS, bei dem der Server auch das Zertifikat der Kundin bzw. des Kunden anfordert und überprüft, ob es gültig ist.
Die gegenseitige TLS-Authentifizierung (mTLS) wird in benutzerdefinierten Aktionen unterstützt. Es ist keine zusätzliche Konfiguration in der benutzerdefinierten Aktion oder Journey erforderlich, um mTLS zu aktivieren, sondern dies geschieht automatisch, wenn ein mTLS-fähiger Endpunkt erkannt wird. Weitere Informationen.
Definieren der Payload-Parameter define-the-message-parameters
Sie können den Payload-Parameter wie unten beschrieben definieren:
-
Fügen Sie im Abschnitt Anfrage ein Beispiel der JSON-Payload ein, die an den externen Service gesendet werden soll. Dieses Feld ist optional und nur für die Aufrufmethoden „POST“ und „PUT“ verfügbar.
Aktivieren Sie die Option NULL-Werte zulassen, um Nullwerte im externen Aufruf beizubehalten. Beachten Sie, dass das Senden von Arrays aus int, string usw. mit Null-Werten darin nicht vollständig unterstützt wird. Zum Beispiel wird das folgende Array mit den Ganzzahlen
[1, null, 2, 3]als[1, 2, 3]gesendet, auch wenn diese Option aktiviert ist. Wenn ein solches Array null ist, wird es außerdem als leeres Array gesendet.
-
Fügen Sie im Abschnitt Reaktion ein Beispiel der vom Aufruf zurückgegebenen Payload ein. Dieses Feld ist optional und ist für alle Aufrufmethoden verfügbar. Ausführliche Informationen zur Verwendung von API-Aufrufantworten in benutzerdefinierten Aktionen finden Sie auf dieser Seite.
. Punkt enthalten noch mit einem $-Zeichen beginnen.
Bei der Feldkonfiguration müssen Sie folgendermaßen vorgehen:
-
Wählen Sie den Parametertyp aus, z. B. String, Ganzzahl usw.
-
Definieren Sie einen Parameter vom Typ „Konstante“ oder „Variable“:
-
Konstante bedeutet, dass der Wert des Parameters im Bereich für die Konfiguration der Aktion von einem technischen Anwender definiert wird. Der Wert bleibt über all Journeys hinweg immer gleich. Er ändert sich nicht und wird den Marketing-Fachleuten nicht angezeigt, wenn sie die benutzerdefinierte Aktion während der Journey verwenden. Es kann sich beispielsweise um eine ID handeln, die das Drittanbietersystem erwartet. In diesem Fall wird der Wert für die Konstante im Feld rechts neben dem Umschalter „Konstante/Variable“ festgelegt.
-
Variabel bedeutet, dass der Wert des Parameters variieren kann. Marketing-Fachleute, die diese benutzerdefinierte Aktion in einer Journey verwenden, können den von ihnen gewünschten Wert weitergeben oder auch angeben, von wo der Wert für diesen Parameter abgerufen werden soll (z. B. vom Ereignis oder von Adobe Experience Platform). In diesem Fall ist das Feld rechts neben dem Umschalter zwischen Konstante und Variable der Titel, den die Marketing-Fachkraft in der Journey sieht, um diesen Parameter zu benennen.
Für optionale Parameter aktivieren Sie die Option Ist optional am Ende der Zeile. Wenn Sie diese Option aktivieren, markieren Sie den Parameter als nicht obligatorisch und überlassen es den Journey-Anwenderinnen und -Anwendern, ob sie ihn bei der Erstellung dieser benutzerdefinierten Aktion in einer Journey ausfüllen oder nicht.
-