Documentación Target Guía para desarrolladores de Target

Get Offers (Node.js)

Última actualización: 5 de mayo de 2025

Temas:
APIs/SDKs

Creado para:

Desarrollador

Descripción

getOffers() se usa para ejecutar una decisión y recuperar una experiencia de Adobe Target.

Método

getOffers

TargetClient.getOffers(options: Object): Promise

Parámetros

El objeto options tiene la siguiente estructura:

Nombre	Tipo	Requerido	Valor predeterminado	Descripción
Solicitud	Objeto	Sí	Ninguna	Se ajusta a la solicitud de la Target API de envío
visitorCookie	Cadena	No	Ninguna	Cookie ECID (VisitorId)
targetCookie	Cadena	No	Ninguna	Cookie Target
targetLocationHint	Cadena	No	Ninguna	Target sugerencia de ubicación
consumerId	Cadena	No	Ninguna	consumerIds para la vinculación de Analytics for Target (A4T)
CustomerIds	Matriz	No	Ninguna	ID de cliente en formato compatible con VisitorId
sessionId	Cadena	No	Ninguna	Se usa para vincular varias solicitudes Target
visitante	Objeto	No	new VisitorId	Proporcione una instancia de VisitorId externa

Promesa

Promise devuelto tiene la siguiente estructura:

Nombre	Tipo	Descripción
de eventos	Objeto	Target Delivery API solicitud
respuesta	Objeto	Target Delivery API respuesta
visitorState	Objeto	Objeto que se debe pasar a la API de visitante `getInstance()`
targetCookie	Objeto	Cookie Target
targetLocationHintCookie	Objeto	Target cookie de indicio de ubicación
analyticsDetails	Matriz	Carga útil de Analytics, en caso de uso de Analytics en el lado del cliente
responseTokens	Matriz	Una lista de tokens de respuesta.
trazar	Matriz	Datos de seguimiento agregados para todos los mboxes o vistas de solicitud
status	Objeto	Un objeto que contiene el estado de la respuesta.
decisioningMethod	Cadena	Determina qué método de toma de decisiones usar (en el dispositivo, del lado del servidor, híbrido)

Los objetos targetCookie y targetLocationHintCookie utilizados para devolver datos al explorador tienen la siguiente estructura:

Nombre	Tipo	Descripción
name	Cadena	Nombre de la cookie
value	Cualquiera	Valor de la cookie, el se convertirá en cadena
maxAge	Número	La opción `maxAge` es una conveniencia para configurar las caducidades en relación con el tiempo actual en segundos

El objeto status utilizado para indicar el estado de la respuesta de destino tiene la siguiente estructura:

Nombre	Tipo	Descripción
status	Número	Código de estado HTTP
message	Cadena	Un mensaje sobre la respuesta. Por ejemplo, puede indicar si la respuesta se decidió en el dispositivo o en el lado del servidor
remoteMboxes	Matriz	Cuando el método de toma de decisiones es `on-device`, se proporciona una matriz de nombres de mbox que no se pudieron decidir completamente en el dispositivo. En otras palabras, se necesita una solicitud Target Delivery API.

Ejemplo

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