Gestion des réponses de commande
Certaines commandes du SDK Web peuvent renvoyer un objet contenant des données potentiellement utiles à votre entreprise. Si vous le souhaitez, vous pouvez choisir ce que vous souhaitez faire avec ces données. Les réponses de commande sont utiles pour les propositions et les destinations, car elles nécessitent des données Edge Network pour fonctionner efficacement.
Les réponses de commande utilisent JavaScript {promesses, agissant comme un proxy pour une valeur inconnue lors de la création de la promesse. Une fois la valeur connue, la promesse est "résolue" avec la valeur .
Gestion des réponses de commande à l’aide de l’extension de balise SDK Web
Créez une règle qui s’abonne à l’événement Send event complete dans le cadre d’une règle.
- Connectez-vous à experience.adobe.com à l’aide de vos informations d’identification Adobe ID.
- Accédez à Collecte de données > Balises.
- Sélectionnez la propriété de balise de votre choix.
- Accédez à Rules, puis sélectionnez la règle de votre choix.
- Sous Events, sélectionnez un événement existant ou créez un événement.
- Définissez le champ déroulant Extension sur SDK Web Adobe Experience Platform et définissez le Type d’événement sur Envoyer l’événement terminé.
- Cliquez sur Conserver les modifications, puis exécutez votre processus de publication.
Vous pouvez ensuite inclure les actions Appliquer les propositions ou Appliquer la réponse à cette règle.
- Lors de l’affichage de la règle créée ou modifiée ci-dessus, sélectionnez une action existante ou créez une action.
- Définissez le champ déroulant Extension sur SDK Web Adobe Experience Platform et définissez le Type d’action sur Appliquer les propositions ou Appliquer la réponse, en fonction du comportement souhaité.
- Définissez les champs de votre choix, puis cliquez sur Conserver les modifications.
Gestion des réponses de commande à l’aide de la bibliothèque JavaScript SDK Web
Utilisez les méthodes then et catch pour déterminer quand une commande réussit ou échoue. Vous pouvez omettre then ou catch si leurs objectifs ne sont pas importants pour votre mise en oeuvre.
alloy("sendEvent", {
"xdm": {
"commerce": {
"order": {
"purchaseID": "a8g784hjq1mnp3",
"purchaseOrderNumber": "VAU3123",
"currencyCode": "USD",
"priceTotal": 999.98
}
}
}
}).then(function(result) {
console.log("The sendEvent command succeeded.");
})
.catch(function(error) {
console.log("The sendEvent command failed.");
});
Toutes les promesses renvoyées par les commandes utilisent un objet result. Par exemple, vous pouvez obtenir des informations sur la bibliothèque de l’objet result à l’aide de la commande getLibraryInfo :
alloy("getLibraryInfo")
.then(function(result) {
console.log(result.libraryInfo.version);
console.log(result.libraryInfo.commands);
console.log(result.libraryInfo.configs);
});
Le contenu de cet objet result dépend d’une combinaison de la commande que vous utilisez et du consentement de l’utilisateur. Si un utilisateur n’a pas donné son consentement dans un but particulier, l’objet de réponse contient uniquement des informations qui peuvent être fournies dans le contexte de ce à quoi l’utilisateur a consenti.