[Alpha]{class="badge informative"}
forRequest (SDK de servidor)
El método forRequest devuelve un identificador con ámbito en una única solicitud entrante. Llámelo una vez por cada solicitud que administre su servidor y, a continuación, llame a métodos como sendEvent en el identificador. Este método no existe en Web SDK porque cada página de explorador ya sirve a un único visitante.
El identificador está respaldado por su propia instancia de SDK, configurada con las mismas opciones que pasó a configure. De este modo, la identidad y el consentimiento de un visitante nunca se filtran a la solicitud de otro visitante. Consulte Instancias y solicitudes para obtener una explicación de lo que cada identificador comparte con la instancia de nivel superior.
const visitor = alloy.forRequest({
request: req
});
await visitor.sendEvent({
xdm: {
eventType: "web.webpagedetails.pageViews",
identityMap: {
Email: [{ id: "visitor@example.com", primary: true }]
}
}
});
Opciones options
El método forRequest acepta un objeto opcional con las siguientes propiedades:
requestheaders funciona, como un Node.js IncomingMessage, una petición Express o una API de recuperación Request. SDK reenvía algunos de los encabezados del visitante a Edge Network y lee el encabezado Referer. Ver Contexto y encabezados reenviados.cookiestoragenetwork, runtime, legacy, globalscreateInstance, solo para este identificador. Pase network como una función que devuelve un servicio de red y los demás como objetos. Consulte Servicios de plataforma.El identificador nunca reutiliza los servicios cookie o storage que pasó a createInstance, ya que dichos servicios contienen datos de visitantes. En su lugar, páselos a forRequest para cada solicitud.
Valor devuelto return
A diferencia de otros métodos, forRequest no arroja una promesa. Devuelve una manija de inmediato. El identificador tiene los siguientes métodos, que funcionan del mismo modo que en la instancia de nivel superior:
El identificador no tiene configure ni forRequest métodos, porque ya está configurado.
Cree un nuevo identificador para cada solicitud. No reutilice un identificador entre solicitudes ni lo comparta entre visitantes.
Errores errors
forRequest genera un error si lo llama antes de que configure se resuelva o si configure rechaza:
forRequest() can only be called after configure() has resolved.
Para evitar este error, espere a que configure se resuelva antes de que el servidor empiece a aceptar solicitudes.