[Alpha]{class="badge informative"}
Panoramica dei metodi
Il Server SDK fornisce le proprie funzionalità come metodi sull’oggetto restituito da createInstance. Se è stato utilizzato il Web SDK, questi metodi corrispondono ai comandi di Web SDK, ma vengono chiamati in modo diverso:
alloy("sendEvent", { xdm })alloy.sendEvent({ xdm })alloy("getIdentity")alloy.getIdentity()Il Web SDK utilizza una singola funzione che assume il nome del comando come stringa, in modo che una pagina possa mettere in coda i comandi prima che termini il caricamento della libreria. Un server carica la libreria prima di gestire eventuali richieste, pertanto Server SDK utilizza metodi regolari, che l’editor può suggerire e controllare durante la digitazione.
Metodi disponibili methods
forRequestPer il traffico dei visitatori, chiamare i metodi su un handle forRequest invece che sull’istanza di livello superiore. Consulta Istanze e richieste.
Gestisci risultati results
Ogni metodo tranne forRequest restituisce una promise. La promessa viene risolta con un oggetto risultato quando il metodo ha esito positivo e viene rifiutata con Error quando ha esito negativo. Usa await con try...catch oppure then e catch:
try {
const result = await visitor.sendEvent({
xdm: {
eventType: "web.webpagedetails.pageViews",
identityMap: {
Email: [{ id: "visitor@example.com", primary: true }]
}
}
});
console.log("Propositions", result.propositions);
} catch (error) {
console.error("sendEvent failed", error.message);
}
Il contenuto dell’oggetto risultato dipende dal metodo. La pagina di ogni metodo descrive il relativo oggetto risultato. Alcuni metodi, ad esempio setConsent, vengono risolti con un oggetto vuoto.
Il risultato dipende anche dal consenso del visitatore. Se il visitatore ha rinunciato, metodi come sendEvent si risolvono con un oggetto vuoto senza inviare nulla ad Adobe.
Errori errors
Un metodo rifiuta nei seguenti casi, tra cui:
- Opzioni non valide: SDK convalida ogni opzione prima di inviare qualsiasi elemento. Opzione sconosciuta o errata oppure valore di tipo errato. Il messaggio che indica il nome del problema, ad esempio
'bogus': Unknown field, rifiuta. - Errori di autenticazione: se SDK non riesce a ottenere un token di accesso, il metodo rifiuta con un messaggio che include
Failed to acquire an IMS access token. Vedi Autenticazione. - Errori Edge Network: se Edge Network rifiuta la richiesta, ad esempio perché l’evento non ha un’identità primaria, il metodo rifiuta con l’errore restituito da Edge Network.
- Errori di rete: se il server non è in grado di raggiungere Adobe, il metodo viene rifiutato con l’errore di rete sottostante.
forRequest non restituisce una promessa. Restituisce immediatamente un handle o genera un errore se configure non è ancora stato risolto.
A seconda del runtime e della relativa configurazione, un rifiuto di promessa non gestito può arrestare il processo server o non soddisfare la richiesta. Gestisci sempre i rifiuti dai metodi di SDK, in modo che un problema che invia dati ad Adobe non interrompa la risposta che il server invia al visitatore.