Dev guideAPI Reference
Dev guideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

Send Optimizely Data Platform data using Advanced Audience Targeting for the React SDK

Describes the sendODPEvent method, which sends Optimizely Feature Experimentation event data to the Optimizely Data Platform (ODP) server.

πŸ‘

Beta

Advanced Audience Targeting is currently in beta. Apply on the Optimizely beta signup page or contact your Customer Success Manager.

Prerequisites

You must enable Advanced Audience Targeting before sending events to ODP from Feature Experimentation.

Minimum SDK version

3.0.0 or higher

Description

The Optimizely Client method sendOdpEvent lets you send data to the ODP server. You can then use this data to analyze user behavior and optimize experiences across different channels and touchpoints.

Use the sendOdpEvent method to:

  • Merge or stitch users together and determine which event is associated with which customer.
  • Send various types of events and actions, such as pageviews, clicks, form submissions, and others. You can include additional data to provide more context and information about the event being tracked.

For example, by connecting an email address identifier with a fs_user_id identifier, you can use the sendOdpEvent method to send events that are associated with both identifiers. This enables you to track and analyze the behavior of a specific user across different touchpoints and devices.

You cannot create or update user profile data like name or address with sendODPEvent. Instead, you can use the ODP Create and update customers API endpoint or ODP UI to manage customer profiles.

Sending events to Optimizely Data Platform

πŸ“˜

Notes

  • The React SDK discards the event immediately if there are any errors (sdkNotReady, odpNotIntegrated, or odpNotEnabled).
  • The React SDK discards all events (implicit or explicit) with a warning log if requested before the datafile is ready. The datafile should be fully ready before you accept decision requests.

Parameters

This table lists the required and optional parameters for the sendODPEvent method.

ParameterTypeDescription
action
required
stringSpecifies the subcategory of the event type, used to track the app and user lifecycle.
typestringThe type of event to be sent and is "fullstack" for all SDK-generated events if not specified.
identifiersMap<string, string>A key-value map of user identifiers. Must have at least one key-value pair.
dataMap<string, unknown>The event data in a key-value map. The value can be any type (string, number, or boolean.) Although allowed, null values are empty strings.

The SDK adds default event data to the given data dictionary. Sending the same key when creating your Map overwrites the default data values.

  • "idempotence_id":<UUID created by the React SDK>

  • "data_source_type":"sdk"

  • "data_source":"react-sdk"

  • "data_source_version":<React SDK version implemented>

Returns

This method sends event data to the Optimizely Data Platform (ODP) server. It does not provide return values.

Example

sendOdpEvent(action: string, type?: string | undefined, identifiers?: Map<string, string> | undefined, data?: Map<string, unknown> | undefined): void

const identifiers = new Map([["fs_user_id", "user123"], ["email", "[email protected]"]]);
const data = new Map([["count", 1]]);

try {
  optimizelyInstance.sendOdpEvent("purchased", "fullstack", identifiers, data);
} catch (error) {
  // handle error here
}

The following diagram shows the network calls between your application, the React SDK, and the ODP server when calling the sendOdpEvent method:

  1. Your application calls the sendOdpEvent method.
  2. The React SDK makes a POST request to ODP.
  3. ODP responds with acknowledgement or relevant error.

Source files

The language and platform source files containing the implementation for the React SDK are available on Github.