[Alpha]{class="badge informative"}
forRequest (SDK do Servidor)
O método forRequest retorna um identificador com escopo para uma única solicitação recebida. Chame-o uma vez para cada solicitação manipulada pelo servidor e, em seguida, chame métodos como sendEvent no identificador. Esse método não existe no Web SDK, pois cada página do navegador já serve um único visitante.
O identificador é apoiado por sua própria instância do SDK, configurada com as mesmas opções que você passou para configure. Dessa forma, a identidade e o consentimento de um visitante nunca vazam para a solicitação de outro visitante. Consulte Instâncias e solicitações para obter uma explicação do que cada identificador compartilha com a instância de nível superior.
const visitor = alloy.forRequest({
request: req
});
await visitor.sendEvent({
xdm: {
eventType: "web.webpagedetails.pageViews",
identityMap: {
Email: [{ id: "visitor@example.com", primary: true }]
}
}
});
Opções options
O método forRequest aceita um objeto opcional com as seguintes propriedades:
requestheaders funciona, como um IncomingMessage Node.js, uma solicitação Express ou uma API Fetch Request. O SDK encaminha alguns dos cabeçalhos do visitante para o Edge Network e lê o cabeçalho Referer. Consulte Contexto e cabeçalhos encaminhados.cookiestoragenetwork, runtime, legacy, globalscreateInstance, somente para este identificador. Passa network como uma função que retorna um serviço de rede, e os outros como objetos. Consulte Serviços da plataforma.O identificador nunca reutiliza os serviços cookie ou storage passados para createInstance, pois esses serviços contêm dados de visitantes. Em vez disso, passe-os para forRequest para cada solicitação.
Valor de retorno return
Ao contrário de outros métodos, forRequest não retorna uma promessa. Retorna um identificador imediatamente. O identificador tem os seguintes métodos, que funcionam da mesma forma que na instância de nível superior:
O identificador não tem os métodos configure ou forRequest, porque ele já está configurado.
Crie um novo identificador para cada solicitação. Não reutilize um identificador em solicitações nem o compartilhe entre visitantes.
Erros errors
forRequest aciona um erro se você chamá-lo antes de configure ser resolvido, ou se configure for rejeitado:
forRequest() can only be called after configure() has resolved.
Para evitar esse erro, aguarde a resolução de configure antes que o servidor comece a aceitar solicitações.