adobe.target.getOffers() - at.js 2.x
Questa funzione ti consente di recuperare più offerte passando più mbox. Inoltre, è possibile recuperare più offerte per tutte le visualizzazioni nelle attività attive.
consumerIdIl valore predefinito è la mbox globale del client, se non specificato. Questa chiave viene utilizzata per generare l’ID dati supplementare (SDID) utilizzato per l’integrazione di A4T.
Quando si utilizza getOffers(), ogni chiamata genera un nuovo SDID. Se sulla stessa pagina sono presenti più richieste mbox e desideri mantenere l'SDID (in modo che corrisponda all'SDID di target-global-mbox e all'SDID Adobe Analytics), utilizza il parametro consumerId.
Se getOffers() include tre mbox (denominate "mbox1", "mbox2" e "mbox3"), includere: consumerId: "mbox1, mbox2, mbox3" nella chiamata getOffers().
decisioningMethodrequesttimeoutRichiesta
tntId, thirdPartyId e marketingCloudVisitorId è obbligatorio.I seguenti elementi devono essere implementati sulla pagina:
- Servizio ID visitatori
- Appmeasurement.js
Sono supportati i seguenti valori:
client_side: se specificato, verrà restituito un payload di Analytics al chiamante che deve essere utilizzato per inviare a Adobe Analytics tramite Data Insertion API.
lato server: questo è il valore predefinito, in cui il backend Target e Analytics utilizzeranno l'identificatore SDID per unire le chiamate a scopo di reporting.
Numero massimo: 50.
Nome non vuoto.
Lunghezza nome <= 128.
Lunghezza valore <= 5000.
Il nome non deve iniziare con "profile".
Nomi non consentiti: "orderId", "orderTotal", "productPurchasedId".
Numero massimo: 50.
Nome non vuoto.
Lunghezza nome <= 128.
Lunghezza valore <= 5000.
Accetta solo valori String.
Il nome non deve iniziare con "profile".
Non vuoto.
dimensione massima = 128.
Non vuoto.
dimensione massima = 128.
>= 0.Nessun valore vuoto.
Lunghezza massima di ogni valore: 50.
Concatenato e separato da virgole.
Lunghezza totale ID prodotto <= 250.
Request > execute > pageLoad
parameters
Numero massimo: 50.
Nome non vuoto.
Lunghezza nome <= 128.
Lunghezza valore <= 5000.
Accetta solo valori String.
Il nome non deve iniziare con "profile".
Nomi non consentiti: "orderId", "orderTotal", "productPurchasedId".
Request > execute > pageLoad
profileParameters
Numero massimo: 50.
Nome non vuoto.
Lunghezza nome <= 128.
Lunghezza del valore <=256.
Il nome non deve iniziare con "profile".
Accetta solo valori String.
Request > execute > pageLoad
product
Request > execute > pageLoad
product -> id
Non vuoto.
Dimensione massima = 128.
Request > execute > pageLoad
product > categoryId
Non vuoto.
Dimensione massima = 128.
Request > execute > pageLoad
order
Request > execute > pageLoad
order > id
Request > execute > pageLoad
order > total
>= 0Request > execute > pageLoad
order > purchasedProductIds
Nessun valore vuoto.
Lunghezza massima di ogni valore: 50.
Concatenato e separato da virgole.
Lunghezza totale ID prodotto <= 250.
Dimensione massima = 50.
Nessun elemento null.
Non vuoto.
Nessun suffisso "-clicked".
Dimensione massima = 250.
Caratteri consentiti: `'-, ./=:;&!@#$%^&*()+
Non nulle.
Univoco.
>= 0
Numero massimo = 50.
Nome non vuoto.
Lunghezza nome <= 128.
Accetta solo valori String.
Lunghezza valore <= 5000.
Il nome non deve iniziare con "profile".
Nomi non consentiti: "orderId", "orderTotal", "productPurchasedId".
Numero massimo = 50.
Nome non vuoto.
Lunghezza nome <= 128.
Accetta solo valori String.
Lunghezza del valore <=256.
Il nome non deve iniziare con "profile".
Non vuoto.
Dimensione massima = 128.
Non vuoto.
Dimensione massima = 128.
>= 0Nessun valore vuoto.
Lunghezza massima di ogni valore = 50.
Concatenato e separato da virgole.
Lunghezza totale ID prodotto <= 250.
Richiama getOffers() per tutte le visualizzazioni
adobe.target.getOffers({
request: {
prefetch: {
views: [{}]
}
}
});
Chiama getOffers() per prendere decisioni su dispositivo
adobe.target.getOffers({
decisioningMethod:"on-device",
request: {
execute: {
mboxes: [
{
index: 0,
name: "homepage"
}
]
}
}
});
Richiama getOffers() per recuperare le visualizzazioni più recenti con i parametri e i parametri del profilo passati
adobe.target.getOffers({
request: {
"prefetch": {
"views": [
{
"parameters": {
"ad": "1"
},
"profileParameters": {
"age": 23
}
}
]
}
}
});
Richiama getOffers() per recuperare mbox con parametri e parametri di profilo passati.
adobe.target.getOffers({
request: {
execute: {
mboxes: [
{
index: 0,
name: "first-mbox"
},
{
index: 1,
name: "second-mbox",
parameters: {
a: 1
},
profileParameters: {
b: 2
}
}
]
}
}
});
Chiama getOffers() per recuperare il payload di Analytics dal lato client
adobe.target.getOffers({
request: {
experienceCloud: {
analytics: {
logging: "client_side"
}
},
prefetch: {
mboxes: [{
index: 0,
name: "a1-serverside-xt"
}]
}
}
})
.then(console.log)
Risposta:
{
"prefetch": {
"mboxes": [{
"index": 0,
"name": "a1-serverside-xt",
"options": [{
"content": "<img src=\"http://s7d2.scene7.com/is/image/TargetAdobeTargetMobile/L4242-xt-usa?tm=1490025518668&fit=constrain&hei=491&wid=980&fmt=png-alpha\"/>",
"type": "html",
"eventToken": "n/K05qdH0MxsiyH4gX05/2qipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
"responseTokens": {
"profile.memberlevel": "0",
"geo.city": "bucharest",
"activity.id": "167169",
"experience.name": "USA Experience",
"geo.country": "romania"
}
}],
"analytics": {
"payload": {
"pe": "tnt",
"tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
}
}
}]
}
}
Il payload può quindi essere inoltrato a Adobe Analytics tramite l'API di inserimento dati.
Recupera ed esegui il rendering di dati da più mbox tramite getOffers() e applyOffers()
at.js 2.x consente di recuperare più mbox tramite l’API getOffers(). Puoi anche recuperare dati per più mbox e quindi utilizzare applyOffers() per eseguire il rendering dei dati in posti diversi identificati da un selettore CSS.
L’esempio seguente mostra una semplice pagina HTML con at.js 2.x implementata:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>at.js 2.x, multiple selectors and multiple mboxes</title>
<script src="at.js"></script>
</head>
<body>
<div id="container1">Default content 1</div>
<div id="container2">Default content 2</div>
<div id="container3">Default content 3</div>
</body>
</html>
Supponi di disporre di tre contenitori che desideri modificare tramite il contenuto ricevuto da Target. Puoi creare una singola richiesta per tre mbox in cui ogni mbox ha del contenuto da riprodurre nel rispettivo contenitore.
La richiesta e il codice di rendering possono avere il seguente aspetto:
adobe.target.getOffers({
request: {
prefetch: {
mboxes: [
{
index: 0,
name: "mbox1"
},
{
index: 1,
name: "mbox2"
},
{
index: 2,
name: "mbox3"
}
]
}
}
})
.then(response => {
// get all mboxes from response
const mboxes = response.prefetch.mboxes;
let count = 1;
mboxes.forEach(el => {
adobe.target.applyOffers({
selector: "#container" + count,
response: {
prefetch: {
mboxes: [el]
}
}
});
count += 1;
});
});
Nella sezione request > prefetch > mboxes sono disponibili tre mbox diverse. Riceverai la risposta per ogni mbox da response > prefetch > mboxes se la richiesta è stata completata con successo. Una volta che possiedi le risposte e le posizioni da utilizzare per il rendering, puoi richiamare applyOffers() per riprodurre il contenuto recuperato da Target. In questo esempio abbiamo la seguente mappatura:
- mbox1 > Selettore CSS #container1
- mbox2 > Selettore CSS #container2
- mbox3 > Selettore CSS #container3
Questo esempio utilizza la variabile count per creare i selettori CSS. In uno scenario reale puoi utilizzare una mappatura diversa tra il selettore CSS e la mbox.
Questo esempio utilizza prefetch > mboxes, ma puoi anche utilizzare execute > mboxes. Se utilizzi la preacquisizione in getOffers(), devi anche usare la preacquisizione nella chiamata di applyOffers().
Chiamare getOffers() per eseguire un pageLoad
L'esempio seguente mostra come eseguire un pageLoad utilizzando getOffers() con at.js 2.x
adobe.target.getOffers({
request: {
execute: {
pageLoad: {
parameters: {}
}
}
}
});