EngageServer.identity(eventData, req[, extensionData])
Note
This is a server-side function used for implementing server-side tracking. If you want to implement client-side tracking instead, use the client-side functions.
The identity()
function sends an IDENTITY event. The IDENTITY event is used to resolve the identity of an anonymous user of your app and turn them into a known user.
Example 14. Next app
Here's an example of how to use the identity()
function in a Next app.
RequestResponse
export async function middleware(req) {
const res = NextResponse.next();
// Load Engage API
const engageSettings = {
clientKey: "<client_key_PLACEHOLDER>",
targetURL: "<stream_api_target_endpoint_PLACEHOLDER>",
pointOfSale: "<point_of_sale_PLACEHOLDER>"
};
const engageServer = await initServer(engageSettings);
// Send IDENTITY event
const eventData = {
channel: "WEB",
currency: "EUR",
identifiers: [
{
id: "123456",
provider: "BXLP"
}
]
};
const extensionData = {
customKey: "customValue"
};
await engageServer.identity(eventData, req, extensionData);
return res;
};