[Alpha]{class="badge informative"}
forRequest (Server SDK)
Il metodo forRequest restituisce un handle con ambito di una singola richiesta in ingresso. Chiamala una volta per ogni richiesta gestita dal server, quindi chiama metodi come sendEvent sull’handle. Questo metodo non esiste nel Web SDK, perché ogni pagina del browser serve già un singolo visitatore.
L’handle è supportato dalla propria istanza di SDK, configurata con le stesse opzioni passate a configure. In questo modo, l’identità e il consenso di un visitatore non trapelano mai nella richiesta di un altro visitatore. Consulta Istanze e richieste per una spiegazione di ciò che ogni handle condivide con l’istanza di primo livello.
const visitor = alloy.forRequest({
request: req
});
await visitor.sendEvent({
xdm: {
eventType: "web.webpagedetails.pageViews",
identityMap: {
Email: [{ id: "visitor@example.com", primary: true }]
}
}
});
Opzioni options
Il metodo forRequest accetta un oggetto facoltativo con le seguenti proprietà:
requestheaders funziona, ad esempio Node.js IncomingMessage, una richiesta Express o un’API Fetch Request. SDK inoltra alcune intestazioni del visitatore ad Edge Network e legge l’intestazione Referer. Vedi Intestazioni contestuali e inoltrate.cookiestoragenetwork, runtime, legacy, globalscreateInstance, solo per questo handle. Passare network come funzione che restituisce un servizio di rete e gli altri come oggetti. Consulta Servizi Platform.L’handle non riutilizza mai i servizi cookie o storage passati a createInstance, perché tali servizi contengono i dati del visitatore. Passali invece a forRequest per ogni richiesta.
Valore restituito return
A differenza di altri metodi, forRequest non restituisce una promessa. Restituisce immediatamente una maniglia. L’handle dispone dei seguenti metodi, che funzionano nello stesso modo dell’istanza di livello superiore:
L’handle non dispone di metodi configure o forRequest, perché è già configurato.
Crea un nuovo handle per ogni richiesta. Non riutilizzare un handle tra più richieste né condividerlo tra i visitatori.
Errori errors
forRequest genera un errore se lo chiami prima che configure si risolva o se configure ha rifiutato:
forRequest() can only be called after configure() has resolved.
Per evitare questo errore, attendi la risoluzione di configure prima che il server inizi ad accettare le richieste.