Documentazione Guida per gli sviluppatori di Target

Get Offers (Node.js)

Ultimo aggiornamento: 20 luglio 2024

Argomenti:
APIs/SDKs

Creato per:

Sviluppatore

Descrizione

getOffers() viene utilizzato per eseguire una decisione e recuperare un'esperienza da Adobe Target.

Metodo

getOffers

TargetClient.getOffers(options: Object): Promise

Parametri

L'oggetto options ha la seguente struttura:

Nome	Tipo	Obbligatorio	Predefinito	Descrizione
Richiesta	Oggetto	Sì	None (Nessuno)	Conforme alla richiesta Target API di consegna
visitorCookie	Stringa	No	None (Nessuno)	Cookie ECID (VisitorId)
targetCookie	Stringa	No	None (Nessuno)	Cookie Target
targetLocationHint	Stringa	No	None (Nessuno)	Target hint di posizione
consumerId	Stringa	No	None (Nessuno)	consumerIds per l'unione di Analytics for Target (A4T)
ID cliente	Array	No	None (Nessuno)	ID cliente in formato compatibile con VisitorId
sessionId	Stringa	No	None (Nessuno)	Utilizzato per collegare più richieste Target
visitatore	Oggetto	No	nuovo VisitorId	Specifica un'istanza VisitorId esterna

Promessa

Promise restituito ha la seguente struttura:

Nome	Tipo	Descrizione
richiesta	Oggetto	Target Delivery API richiesta
risposta	Oggetto	Target Delivery API risposta
visitorState	Oggetto	Oggetto da passare all'API visitatore `getInstance()`
targetCookie	Oggetto	Cookie Target
targetLocationHintCookie	Oggetto	Cookie dell'hint di posizione Target
analyticsDetails	Array	Payload di Analytics, in caso di utilizzo di Analytics lato client
responseTokens	Array	Elenco di token di risposta.
traccia	Array	Dati di trace aggregati per tutte le mbox/visualizzazioni di richiesta
status	Oggetto	Oggetto contenente lo stato della risposta.
decisioningMethod	Stringa	Determina il metodo decisionale da utilizzare (sul dispositivo, lato server, ibrido)

targetCookie e targetLocationHintCookie oggetti utilizzati per restituire dati al browser hanno la seguente struttura:

Nome	Tipo	Descrizione
name	Stringa	Nome cookie
value	Any	Valore del cookie, il verrà convertito in stringa
maxAge	Numero	L'opzione `maxAge` è una comodità per impostare le scadenze relative all'ora corrente in secondi

L'oggetto status utilizzato per indicare lo stato della risposta di destinazione ha la seguente struttura:

Nome	Tipo	Descrizione
status	Numero	Codice di stato HTTP
message	Stringa	Un messaggio sulla risposta. Ad esempio, potrebbe indicare se la risposta è stata decisa sul dispositivo o lato server
remoteMboxes	Array	Quando il metodo di decisione è `on-device`, viene fornito un array di nomi mbox che non è stato possibile decidere completamente sul dispositivo. In altre parole, è necessaria una richiesta Target Delivery API.

Esempio

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