Datastores Data Adapter

The Datastores Data Adapter provides you with access to reference data uploaded and stored in a MXO Datastore. Storing the data within your MXO environment provides fast access and performance gains for accessing the data, in real-time, for decisioning.

You can access information available in the Datastores Data Adapter from the Data Item Picker for use in decisioning.

Note: You can retrieve up to 50 rows of data per customer key or fixed primary key.

When accessing data in a Datastore, you can provide both a primary key and secondary key as reference for retrieving that data.

For more information about working with Datastores, see the Example Use Case.

Retrieving Customer Data

The primary key identifies a specific set of data in your datastore and is used to look up data for decisioning. Typically, this is a customer identifier such as a Customer key. The secondary key provides an additional way to look up data. This may be an identifier that can reference multiple records in your datastore. For example, productid.

Retrieving Non-Customer Data

If you want to retrieve non-customer data for use in decisioning, such as additional information about your Propositions, you can provide a fixed value for the primary key, a fixed primary key. This enables MXO to retrieve the same set of data for all customers. If you use a fixed primary key, you must also provide a secondary key.

To create a Datastores Data Adapter

  1. In MXO, choose Collect.

  2. Select External Data, click Create.

  3. Choose Datastores Adapter as the type of Data Adapter you want to add.

  4. Enter a name for the Data Adapter you are adding. Using a descriptive name makes it easier for you and your team members to know when to use the Data Adapter.

  5. Enter a brief description of the Data Adapter you are adding and when it should be used.

  6. Enter the configuration details that define the adapter's behavior.

    FieldDescription
    Select the attribute to use as a keyDo one of the following: * Select the captured data attribute to use as the primary key for accessing data for a single customer in your datastore.
    Note: Captured data attributes are stored in the Customer Metadata Data Adapter. * Select Fixed Primary Key to specify a fixed value and retrieve the same set of data for all customers.
    Use as Action SourceSpecify whether or not to use this datastore as an Action Source for a Dynamic Actions template. You can select: - Not set, which acts as if False is selected, - True, use this datastore as an Action Source for a Dynamic Actions template, or - False, do not use this datastore as an Action Source for a Dynamic Actions template.
    Test Key or Primary Key ValueSpecify the fixed key value to use for accessing data in your datastore, when using a Fixed Primary Key.
    Important: You must use this value as the primary key for each row of data when you populate your Datastore using the Example Use Case
    API nameThe name of the Datastore from which you want to read data for use in decisioning. Select the required Datastore from the drop-down list provided.

  7. Click Test configuration. This tests and verifies that the new configuration details are valid.

  8. Click Apply.

  9. Click Save.