Documentation Guide du développeur de Target

Get Offers (Node.js)

Dernière mise à jour : 20 juillet 2024

Rubriques :
APIs/SDKs

Créé pour :

Développeur

Description

getOffers() est utilisé pour exécuter une décision et récupérer une expérience de Adobe Target.

Méthode

getOffers

TargetClient.getOffers(options: Object): Promise

Paramètres

L’objet options possède la structure suivante :

Nom	Type	Requis	Par défaut	Description
Demande	Objet	Oui	None	Se conforme à la requête Target API de diffusion
visitorCookie	Chaîne	Non	None	Cookie ECID (VisitorId)
targetCookie	Chaîne	Non	None	cookie Target
targetLocationHint	Chaîne	Non	None	Target indicateur d’emplacement
consumerId	Chaîne	Non	None	consumerIds pour le groupement Analytics for Target (A4T)
CustomerIds	Tableau	Non	None	ID de client au format compatible avec VisitorId
sessionId	Chaîne	Non	None	Utilisé pour lier plusieurs requêtes Target
visiteur	Objet	Non	new VisitorId	Fournir une instance VisitorId externe

Promesse

Promise renvoyé présente la structure suivante :

Nom	Type	Description
events	Objet	requête Target Delivery API
response	Objet	Réponse Target Delivery API
visitorState	Objet	Objet qui doit être transmis à l’API visiteur `getInstance()`
targetCookie	Objet	cookie Target
targetLocationHintCookie	Objet	cookie d’indicateur d’emplacement Target
analyticsDetails	Tableau	Charge utile Analytics, en cas d’utilisation d’Analytics côté client
responseTokens	Tableau	Liste de jetons de réponse.
trace	Tableau	Données de suivi agrégées pour toutes les mbox/vues de requête
status	Objet	Objet contenant l’état de la réponse.
decisioningMethod	Chaîne	Détermine la méthode de prise de décision à utiliser (on-device, côté serveur, hybride)

Les objets targetCookie et targetLocationHintCookie utilisés pour renvoyer les données au navigateur ont la structure suivante :

Nom	Type	Description
name	Chaîne	Nom du cookie
value	Quelconque	Valeur du cookie, qui sera convertie en chaîne
maxAge	Nombre	L’option `maxAge` est pratique pour définir les expirations par rapport à l’heure actuelle en secondes.

L’objet status utilisé pour indiquer l’état de la réponse cible possède la structure suivante :

Nom	Type	Description
status	Nombre	Code d’état HTTP
message	Chaîne	Un message à propos de la réponse. Par exemple, il peut indiquer si la réponse a été décidée sur l’appareil ou côté serveur.
remoteMboxes	Tableau	Lorsque la méthode de prise de décision est `on-device`, un tableau de noms de mbox qui n’ont pas pu être entièrement décidés sur l’appareil est donné. En d’autres termes, une requête Target Delivery API est nécessaire.

Exemple

Node.js

const TargetClient = require("@adobe/target-nodejs-sdk");
const CONFIG = {
  client: "acmeclient",
  organizationId: "1234567890@AdobeOrg"
};

const targetClient = TargetClient.create(CONFIG);

const request = {
    context: {channel: "web"},
    execute: {
        mboxes: [{
            name: "a1-serverside-ab",
            index: 1
        }]
}};

const response = await targetClient.getOffers({ request });

recommendation-more-help