DocumentazioneGuida per gli sviluppatori di Target

Get Offers (Node.js)

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

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
6906415f-169c-422b-89d3-7118e147c4e3