ÃÛ¶¹ÊÓƵ

DocumentationExperience PlatformWeb SDK Guide

data

Last update: Tue May 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Developer

The data object allows you to send a payload to ÃÛ¶¹ÊÓƵ that does not match an XDM schema. It is useful in non-XDM scenarios, such as sending data directly to ÃÛ¶¹ÊÓƵ Analytics, ÃÛ¶¹ÊÓƵ Target, or ÃÛ¶¹ÊÓƵ Audience Manager. When data arrives at the datastream, you can use Data Prep mapping to assign XDM fields to each field in the data object.

IMPORTANT
Data within this object must have at least one of the following actions:
  • A service in the datastream must be configured to retrieve data from a given property in the data object.
  • The given property must be mapped to an XDM field using data prep.
If a given property is not mapped to an XDM field or used by a configured service, that data is permanently lost.

Use the data object through the Web SDK tag extension tag-extension

Provide a data element in the Data field within the actions of a tag rule.

  1. Log in to using your ÃÛ¶¹ÊÓƵ ID credentials.
  2. Navigate to Data Collection > Tags.
  3. Select the desired tag property.
  4. Navigate to Rules, then select the desired rule.
  5. Under Actions, select an existing action or create an action.
  6. Set the Extension dropdown field to ÃÛ¶¹ÊÓƵ Experience Platform Web SDK, and set the Action Type to Send event.
  7. Provide the data element containing the desired object in the Data field.
  8. Click Keep Changes, then run your publishing workflow.

Use the data object through the Web SDK JavaScript library library

Set the data object as part of the JSON object within the parameter of the sendEvent command. For data that you plan to map in the datastream, you can structure this object however you’d like. For data used by certain services, make sure that the object hierarchy matches what the service expects. You can include both the data object and the xdm object in the same sendEvent command.

alloy("sendEvent", {
  "data": dataObject
});

Use the data object with ÃÛ¶¹ÊÓƵ Analytics analytics

You can use the data object with ÃÛ¶¹ÊÓƵ Analytics to send data to a report suite without an XDM schema. Variables are configured to use the same syntax as AppMeasurement variables, simplifying the upgrade process to the Web SDK. See Data object variable mapping to ÃÛ¶¹ÊÓƵ Analytics in the ÃÛ¶¹ÊÓƵ Analytics implementation guide for more information.

recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636