DocumentazioneGuida per gli sviluppatori di Target

adobe.target.applyOffers(options) - at.js 2.x

Ultimo aggiornamento: 20 luglio 2024
  • Argomenti:

Creato per:

  • Sviluppatore

Questa funzione ti consente di applicare più di un’offerta recuperata da adobe.target.getOffers().

NOTA
Questa funzione è stata introdotta con at.js 2.x. Questa funzione non è disponibile per at.js versione 1.x.
ChiaveTipoObbligatorioDescrizione
selectorStringaNoElemento HTML o selettore CSS utilizzato per identificare l’elemento HTML in cui Target deve inserire il contenuto dell’offerta. Se non viene fornito un selettore, Target presuppone che l'elemento HTML da utilizzare sia HTML HEAD.
RispostaOggettoSìOggetto di risposta da getOffers().
Vedi la tabella Richieste di seguito.

Risposta

NOTA
Consulta la documentazione sulle API di consegna per informazioni sui tipi accettabili per tutti i campi elencati di seguito.
Nome campoDescrizione
response > prefetch > views > options > contentNota che il contenuto di “option” non è definito e dipende direttamente dalla struttura tipo/modello dell’opzione.
response > prefetch > views > options > typeTipo di opzione. Riflette il tipo del campo “content”. Il tipo supportato è “actions”.
response > prefetch > views > stateUn token opaco da inoltrare con la notifica sul display per la visualizzazione
response > prefetch > views > options > responseTokensContiene la mappa dei valori responseTokens raccolti quando l’opzione corrente era in fase di elaborazione.
response > prefetch > views > analytics > payloadPayload Analytics per l'integrazione sul lato client da inviare a Analytics dopo l'applicazione della visualizzazione.
response > prefetch > views > traceL’oggetto contenente tutti i dati di trace per la chiamata di preacquisizione per la visualizzazione.
L’oggetto trace includerà anche una versione per la traccia.
L’oggetto trace includerà anche i dettagli della visualizzazione corrente.
response > prefetch > views > options > eventTokenLa registrazione degli eventi è eseguita per opzione. Per ogni opzione applicata, il rispettivo token evento deve essere aggiunto all’elenco dei token di notifica. Una visualizzazione è composta da più opzioni. Se sono state applicate e visualizzate tutte le opzioni, è necessario includere tutti i valori eventTokens nella notifica.
response > prefetch > views > nameIl nome della visualizzazione leggibile dall’utente.
response > prefetch > views > metricsMetriche di reporting da controllare e segnalare a Target. Al momento, è disponibile il supporto alla metrica di solo clic. Se si verifica un clic sull’elemento, è necessario raccogliere il valore eventTokens adeguato e inviare una notifica.
response > prefetch > views > keyChiave o impronta digitale che identifica la visualizzazione.
response > prefetch > views > idID della visualizzazione.
response > notifications > idID notifica.
response > notifications > events > typeTipo di notifica, clic o visualizzazione.
response > notifications > events > traceLa traccia per l’evento di notifica.
response > notifications > events > tokenToken inviato con l’evento di notifica.
response > notifications > events > timestampLa marca temporale inviata con l’evento di notifica.
response > notifications > events > errorCodeSe la notifica non riesce, il codice indica il motivo dell’errore.
response > notifications > eventsGli eventi registrati o non registrati per la notifica corrente.
response > notificationsIndica le notifiche registrate o non riuscite.
response > execute > mboxes > mbox > traceL’oggetto contenente tutti i dati di trace per la singola richiesta mbox.
response > execute > mboxes > mbox > responseTokensContiene la mappa di responseTokens per un’esecuzione specifica della richiesta mbox.
response > execute > mboxes > mbox > option > contentNota che il contenuto di “option” non è definito e dipende direttamente dalla struttura tipo/modello dell’opzione.
response > execute > mboxes > mbox > option > typeTipo di opzione. Riflette il tipo del campo “content”. I tipi supportati sono: html, redirect, JSON e dinamico.
response > execute > mboxes > mbox > optionsOpzione Risposta.
response > execute > mboxes > mbox > metrics > eventTokenToken dell’evento di clic.
response > execute > mboxes > mbox > metrics > type"click"
response > execute > mboxes > mbox > metricsContiene l’elenco clickThrough delle metriche.
response > execute > mboxes > mbox > mboxNome della mbox.
response > execute > mboxes > mbox >indexIndica che la risposta è per la mbox con questo indice della richiesta.
response > execute > mboxes > mbox > analytics > payloadPayload Analytics per l'integrazione sul lato client da inviare a Analytics dopo l'applicazione della mbox. (Vedi la sezione Campagne abilitate per A4T.)
response > execute > mboxesElenco delle mbox eseguite.
response > execute > pageLoad > options > contentNota che il contenuto di “option” non è definito e dipende direttamente dalla struttura tipo/modello dell’opzione.
response > execute > pageLoad > options > typeTipo di opzione. Riflette il tipo del campo “content”. I tipi supportati sono: html, redirect, JSON, dinamico e “action”.
response > execute > pageLoad > optionsOpzioni non raggruppate per visualizzazioni (target-global-mbox + opzioni di attività con viste non raggruppate per viste).
response > execute > pageLoad > metricsMetriche di clic che non erano impostate per appartenere a una visualizzazione specifica.
response > execute > pageLoad > traceL’oggetto contenente tutti i dati trace per la richiesta pageload.
response > execute > pageLoad > analytics > payloadPayload Analytics per l'integrazione sul lato client da inviare a Analytics dopo l'applicazione del contenuto di caricamento pagina. (Vedi la sezione Campagne abilitate per A4T.)

Esempio di chiamata applyOffers()

adobe.target.applyOffers({response:{
  "execute": {
    "pageLoad": {
      "options": [{
        "type": "html",
        "content": "page-load"
      },
      {
        "type": "actions",
        "content": [{
          "type": "setHtml",
          "content": "<h1>Container 1</h1>",
          "selector": "#container1",
          "cssSelector": "#container1"
        },
        {
          "type": "setHtml",
          "content": "<h3>Container 3</h3>",
          "selector": "#container3",
          "cssSelector": "#container3"
        }]
      }],


      "metrics": [{
        "type": "click",
        "selector": "#container1",
        "eventToken": "page-load-click-metric"
      }]
    }
  }
}});

Esempio di chiamate della catena di promesse con getOffers() e applyOffers(), perché queste funzioni sono basate su promesse

adobe.target.getOffers({...})
.then(response => adobe.target.applyOffers({ response: response }))
.then(() => console.log("Success"))
.catch(error => console.log("Error", error));

Per ulteriori esempi su come utilizzare getOffers(), consulta la documentazione di getOffers

Esempio di richiesta di caricamento pagina

adobe.target.getOffers({
    request: {
        execute: {
            pageLoad: {}
        }
    }
}).
then(response => adobe.target.applyOffers({ response: response }))
.then(() => console.log("Success"))
.catch(error => console.log("Error", error));
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3