Cloud Connector-Erweiterung – Übersicht
Mit der Cloud Connector-Ereignisweiterleitungserweiterung können Sie benutzerdefinierte HTTP-Anfragen erstellen, um Daten an ein Ziel zu senden oder Daten von einem Ziel abzurufen. Die Cloud Connector-Erweiterung ist wie Postman für das Adobe Experience Platform Edge Network und kann verwendet werden, um Daten an einen Endpunkt zu senden, der noch keine dedizierte Erweiterung hat.
Verwenden Sie diese Referenz, um Informationen zu den verfügbaren Optionen beim Erstellen einer Regel mithilfe dieser Erweiterung zu erhalten.
Aktionstyp der Cloud Connector-Erweiterung
In diesem Abschnitt wird der Aktionstyp „Daten senden“ beschrieben, der in der Adobe Experience Platform Cloud Connector-Erweiterung verfügbar ist.
Anfragetyp
Zur Auswahl des für den Endpunkt erforderlichen Anfragetyps wählen Sie den entsprechenden Typ in der Dropdown-Liste Anfragetyp aus.
Endpunkt-URL
Geben Sie in das Textfeld neben dem Dropdown-Menü „Anfragetyp“ die URL für den Endpunkt ein, an den Sie Daten senden möchten.
Konfiguration der Abfrageparameter, Header und Nachrichtenkörper
Verwenden Sie die einzelnen Registerkarten (Abfrageparameter, Header und Nachrichtenkörper-Datenelemente), um zu steuern, welche Daten an einen bestimmten Endpunkt gesendet werden.
Abfrageparameter
Definieren Sie einen Schlüssel und einen Wert für jedes Schlüssel-Wert-Paar, das Sie als Abfragezeichenfolge-Parameter senden möchten. Um ein Datenelement manuell einzugeben, verwenden Sie die Datenelement-Tokenisierung für die Ereignisweiterleitung mit geschweiften Klammern. Um auf den Wert eines Datenelements mit dem Namen „siteSection“ als Schlüssel oder Wert zu verweisen, geben Sie {{siteSection}}
ein. Sie können auch das zuvor erstellte Datenelement wählen, indem Sie es im Dropdown-Menü auswählen.
Um weitere Abfrageparameter hinzuzufügen, wählen Sie Weitere hinzufügen aus.
Header
Definieren Sie einen Schlüssel und einen Wert für jedes Schlüssel-Wert-Paar, das Sie als Header senden möchten. Um ein Datenelement manuell einzugeben, verwenden Sie die Datenelement-Tokenisierung für die Ereignisweiterleitung mit geschweiften Klammern. Um auf den Wert eines Datenelements mit dem Namen „pageName“ als Schlüssel oder Wert zu verweisen, geben Sie {{pageName}}
ein. Sie können auch das zuvor erstellte Datenelement wählen, indem Sie es im Dropdown-Menü auswählen.
Um weitere Header hinzuzufügen, wählen Sie Weitere hinzufügen aus.
In der folgenden Tabelle sind die vordefinierten Header aufgeführt. Sie sind nicht auf diese Header beschränkt und können bei Bedarf eigene benutzerdefinierte Header hinzufügen. Diese stehen jedoch als Unterstützung zur Verfügung.
Accept-Datetime
-Header in einer HTTP-Anfrage an ein TimeGate für eine ursprüngliche Ressource übermittelt. Der Wert gibt den Zeitpunkt des gewünschten früheren Zustands der Originalressource an.Set-Cookie
-Header gesendet wurden.Accept-Transfer-Encoding
nennen, was intuitiver wäre).Upgrade
-Header-Feld ist RFC 7230, Abschnitt 6.7. Der Standard legt Regeln für die Aktualisierung oder den Wechsel zu einem anderen Protokoll in der aktuellen Client-, Server- und Transportprotokollverbindung fest. Dieser Header-Standard ermöglicht es beispielsweise einem Client, von HTTP 1.1 zu HTTP 2.0 zu wechseln, vorausgesetzt, der Server entscheidet, das Upgrade
-Header-Feld zu bestätigen und zu implementieren. Keine der Parteien muss die im Upgrade
-Header-Feld angegebenen Bedingungen akzeptieren. Es kann sowohl in Client- als auch in Server-Headern verwendet werden. Wenn das Upgrade
-Header-Feld angegeben ist, MUSS der Absender auch das Connection
-Header-Feld mit der upgrade
-Option senden.Nachrichtenkörper als JSON
Definieren Sie einen Schlüssel und einen Wert für jedes Schlüssel-Wert-Paar, das Sie im Nachrichtenkörper der Anfrage senden möchten. Um ein Datenelement manuell einzugeben, verwenden Sie die Datenelement-Tokenisierung für die Ereignisweiterleitung mit geschweiften Klammern. Um auf den Wert eines Datenelements mit dem Namen „appSection“ als Schlüssel oder Wert zu verweisen, geben Sie {{appSection}}
ein. Sie können auch das zuvor erstellte Datenelement wählen, indem Sie es im Dropdown-Menü auswählen.
Um weitere Schlüssel-Wert-Paare hinzuzufügen, wählen Sie Weitere hinzufügen aus.
Nachrichtenkörper als Rohtext
Definieren Sie einen Schlüssel und einen Wert für jedes Schlüssel-Wert-Paar, das Sie im Nachrichtenkörper der Anfrage senden möchten. Um ein Datenelement manuell einzugeben, verwenden Sie die Datenelement-Tokenisierung für die Ereignisweiterleitung mit geschweiften Klammern. Um auf den Wert eines Datenelements mit dem Namen „appSection“ als Schlüssel oder Wert zu verweisen, geben Sie {{appSection}}
ein. Sie können auch das zuvor erstellte Datenelement wählen, indem Sie es im Dropdown-Menü auswählen. Sie können ein oder mehrere Datenelemente hinzufügen.
Erweitert
Aktionen innerhalb von Regeln in der Ereignisweiterleitung werden sequenziell ausgeführt. In bestimmten Szenarien möchten Sie aber womöglich Daten von einer externen Quelle abrufen, die nicht im vom Client eingehenden Ereignis vorhanden ist, um im Rahmen einer einzelnen Regel die in dieser Antwort enthaltenen Daten entweder umzuwandeln oder an ein in einer nachfolgenden Aktion enthaltenes endgültiges Ziel zu senden. Die Option „Save the request response“ (Anfrageantwort speichern) im Bereich „Advanced“ (Erweitert) ermöglicht dies.
Um den von einem Endpunkt erhaltenen Antworttext zu speichern, aktivieren Sie das Kontrollkästchen Anfrageantwort speichern und legen Sie im Textfeld einen Antwortschlüssel fest.
Wenn Sie den Antwortschlüssel als productDetails
festgelegt haben, verweisen Sie in einem Datenelement auf diese Daten sowie in einer nachfolgenden Aktion innerhalb derselben Regel auf dieses Datenelement. Um ein Datenelement zu erstellen, das auf productDetail
verweist, erstellen Sie ein Datenelement vom Typ path
und geben Sie den folgenden Pfad ein:
arc.ruleStash.[EXTENSION-NAME-HERE].responses.[RESPONSE-KEY-HERE]
arc.ruleStash.adobe-cloud-connector.reponses.productDetails