Request Data Adapter

The Request Data Adapter allows you to capture incoming parameters from web URLs or on API calls.

This enables an organization to capture, for example, a campaign code on the customers current interaction, passed in by the URL for the current page. Alternatively, this could be parameters passed in on any of our Customer Event APIs, such as a customer's current segment value or outbound campaign contexts.

An organization can use this information in Eligibility Rules to display appropriate content to users who are redirected to their Touchpoints from a search engine or other web request.

Example

A customer searches online for a new credit card deal. Their search returns a link to a promotional offer from a local bank. When the customer clicks on that link they are redirected to a page containing all the relevant supporting information for that offer.

The mobile phone company uses the campaign code passed in from the pay-per-click offer in an Eligibility Rule to ensure the customer is presented with the most relevant Action for them on that Touchpoint.

To create a Request Data Adapter

  1. In MXO, choose Collect.

  2. Select External Data, click Create.

  3. Choose Request 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. Click Let's get started.

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

    FieldDescription
    AliasesGroups a list of attributes into a single data item for use in Eligibility Rules. For example: CampaignCode =gclid, cmpid
  8. Click Test configuration. This tests and verifies that the new configuration details are valid.

  9. Click Apply.

  10. Click Save.