Présentation de l’extension Cloud Connector
L’extension de transfert d’événement Cloud Connector vous permet de créer des requêtes HTTP personnalisées pour envoyer des données à une destination ou récupérer des données d’une destination. L’extension Cloud Connector est semblable à Postman sur Adobe Experience Platform Edge Network et peut être utilisée pour envoyer des données à un point d’entrée qui n’a pas encore d’extension dédiée.
Utilisez cette référence pour obtenir des informations sur les options disponibles lors de l’utilisation de cette extension pour créer une règle.
Type d’action d’extension Cloud Connector
Cette section décrit le type d’action Envoyer les données disponible dans l’extension Adobe Experience Platform Cloud Connector.
Type de requête
Pour sélectionner le type de requête requis par le point d’entrée, cliquez sur le type approprié dans la liste déroulante Type de requête.
URL du point d’entrée
Dans le champ de texte en regard du menu déroulant Type de requête, saisissez l’URL du point d’entrée auquel vous envoyez des données.
Paramètres de requête, en-têtes et configuration du corps
Utilisez chacun de ces onglets (Paramètres de requête, En-têtes et Éléments de données de contenu) pour contrôler les données envoyées à un point d’entrée donné.
Paramètres de requête
Définissez une clé et une valeur pour chaque paire clé-valeur à envoyer en tant que paramètre de chaîne de requête. Pour entrer manuellement un élément de données, utilisez la segmentation en unités lexicales de l’élément de données pour le transfert d'événement. Pour référencer la valeur d’un élément de données nommé « siteSection » comme clé ou valeur, saisissez {{siteSection}}
. Vous pouvez également sélectionner l’élément de données créé précédemment en le sélectionnant dans le menu déroulant.
Pour ajouter d’autres paramètres de requête, sélectionnez Ajouter un autre élément.
En-têtes
Définissez une clé et une valeur pour chaque paire clé-valeur que vous voulez envoyer en tant qu’en-tête. Pour entrer manuellement un élément de données, utilisez la segmentation en unités lexicales de l’élément de données pour le transfert d'événement. Pour référencer la valeur d’un élément de données nommé « pageName » comme clé ou valeur, saisissez {{pageName}}
. Vous pouvez également sélectionner l’élément de données créé précédemment en le sélectionnant dans le menu déroulant.
Pour ajouter d’autres en-têtes, sélectionnez Ajouter un autre élément.
Le tableau suivant répertorie les en-têtes prédéfinis. Vous n’êtes pas limité à ces en-têtes et vous pouvez ajouter vos propres en-têtes personnalisés si nécessaire, mais ils sont mis à votre disposition pour votre commodité.
Accept-Datetime
est transmis dans une requête HTTP émise par rapport à un TimeGate pour une ressource d’origine, et sa valeur indique la date et l’heure (datetime) de l’état passé recherché de la ressource d’origine.Set-Cookie
.Accept-Transfer-Encoding
, ce qui serait plus intuitif).Upgrade
est RFC 7230, section 6.7. Le standard établit des règles pour la mise à niveau ou la modification d’un protocole différent sur la connexion actuelle du client, du serveur, du protocole de transport. Par exemple, ce standard pour l’en-tête permet à un client de passer de HTTP 1.1 à HTTP 2.0, en supposant que le serveur décide de reconnaître et d’implémenter le champ d’en-tête Upgrade
. Aucune des parties n’est tenue d’accepter les termes spécifiés dans le champ d’en-tête Upgrade
. Ce champ peut être utilisé dans les en-têtes client et serveur. Si le champ d’en-tête Upgrade
est spécifié, l’expéditeur DOIT également envoyer le champ d’en-tête Connection
en spécifiant l’option upgrade
.Corps en tant que JSON
Définissez une clé et une valeur pour chaque paire clé-valeur que vous voulez envoyer dans le corps de la requête. Pour entrer manuellement un élément de données, utilisez la segmentation en unités lexicales de l’élément de données pour le transfert d'événement. Pour référencer la valeur d’un élément de données nommé « appSection » comme clé ou valeur, saisissez {{appSection}}
. Vous pouvez également sélectionner l’élément de données créé précédemment en le sélectionnant dans le menu déroulant.
Pour ajouter des paires clé-valeur supplémentaires, sélectionnez Ajouter un autre élément.
Corps comme brut
Définissez une clé et une valeur pour chaque paire clé-valeur que vous voulez envoyer dans le corps de la requête. Pour entrer manuellement un élément de données, utilisez la segmentation en unités lexicales de l’élément de données pour le transfert d'événement. Pour référencer la valeur d’un élément de données nommé « appSection » comme clé ou valeur, saisissez {{appSection}}
. Vous pouvez également sélectionner l’élément de données créé précédemment en le sélectionnant dans le menu déroulant. Vous pouvez ajouter un ou plusieurs éléments de données.
Advanced
Les actions dans les règles du transfert d’événement s’exécutent de manière séquentielle. Dans certaines situations, vous pourriez souhaiter récupérer des données provenant d’une source externe non présente sur l’événement entrant du client, puis prendre cette réponse et transformer ou envoyer ces données vers une destination finale lors d’une action ultérieure au sein d’une seule règle. La section « Enregistrer la réponse à la requête » de la section Avancée permet cette opération.
Pour enregistrer le corps de la réponse à partir d’un point d’entrée, cochez la case Enregistrer la réponse de la requête et définissez une clé de réponse dans le champ de texte.
Si vous avez défini la clé de réponse comme productDetails
, référencez ces données dans un élément de données, puis référencez cet élément de données dans une action ultérieure au sein de la même règle. Pour créer un élément de données qui référence productDetail
, créez un élément de données de type path
et saisissez le chemin suivant :
arc.ruleStash.[EXTENSION-NAME-HERE].responses.[RESPONSE-KEY-HERE]
arc.ruleStash.adobe-cloud-connector.reponses.productDetails