Capture Customer Data

Attribute Capture Points collect customer profile data, including customer keys, using Customer Attributes and metadata on events using Activity Attributes. Attribute Capture Points can capture data from interactions across a variety of channels and touchpoints such as websites, mobile apps, contact centers, and chat services..

Create a Page Element Attribute Capture Point (MXO UI)

Create Page Element Attribute Capture Points to capture data from an HTML element on a web page such as from web form fields or displayed text.

  1. Select the desired Interaction Point from the Collect menu to create an Attribute Capture Point.
  2. Click the Add icon for Attribute Capture Points.

  3. Select Page Element.

  4. Enter a Name for your capture point.

  5. Select the type of page element you want to capture data from. Choose one of the following:

    FieldDescription
    Text FieldCaptures text field values on page load and user input.
    Display ElementCaptures display element values on page load.
    Checkbox/Radio ButtonCaptures checkbox/radio button selections on page load and user interaction.
    Dropdown ListCaptures selected dropdown list values on page load and user selection.
  6. Optionally, click the Edit icon to configure the following:

    FieldDescription
    Delay Data Capture By:Set a delay (0-5 seconds) for data capture using the slider..
    Select the value you want to capture

    Choose Input Value or Element Attribute Value.

    For Element Attribute Value, specify the attribute name.

  7. Enter the unique identifier for the element, such as '#location1' for HTML element IDs or CSS selectors. For automated capture using the MXO Extension or iOS SDK, the identifier is pre-filled. Supported selectors are detailed in Supported Selectors for Element Paths.

  8. Select a storage option for the data: as a Customer Attribute or an Activity Attribute. For details on attribute types, see Introduction to Attributes.

  9. Choose to store the captured value as an existing attribute or create a new one, as outlined below:

    OptionProcedure
    Existing AttributeSelect the attribute to store the data. Ensure it matches the data type if capturing a key attribute.
    New AttributeProvide a unique name and data type for the new attribute. Options include Text, Boolean, or Number. Duplicate names are not allowed.
  10. Click Save.

Create a Page Element Attribute Capture Point (MXO Extension)

Create Page Element Attribute Capture Points to capture data from an HTML element on a web page such as from web form fields or displayed text. For more information, refer to MXO Bookmarklet.

  1. Enable the MXO Extension on your website's page to start capturing customer data. Note that the page must be configured as an Interaction Point.
  2. In the toolbar, select EDIT to modify the Attribute Capture Point.

  3. Click the Add icon, then select Page Element from the Attribute Capture menu to proceed with data capture. This temporarily closes the window and returns you to the web page.

    CP - Page Element
  4. Hover over the page element to capture data, then click Set Selection to open the main MXO UI.

  5. Click Set Selection to open the main MXO UI.

  6. Name your capture point.
  7. Select the page element type for data capture:

    FieldDescription
    Text FieldCaptures text input or default text on page load.
    Display ElementCaptures text displayed on page load.
    Checkbox/Radio ButtonCaptures selections on page load or change.
    Dropdown ListCaptures selected options on page load or change.
  8. Optionally, click the Edit icon to configure the following:

    FieldDescription
    Delay Data Capture By:Set a delay (0-5 seconds) using the slider.
    Select the value you want to capture

    Choose Input Value or Element Attribute Value.

    For Element Attribute Value, specify the attribute name.

  9. Select a storage option for the captured data: Customer Attribute or Activity Attribute. For distinctions between attribute types, see Introduction to Attributes.

  10. Select storage for the captured data: choose an existing attribute or create a new one. For existing attributes, ensure compatibility with the data type. For new attributes, provide a unique name and data type. See Introduction to Attributes for details.

    FieldDescription
    An existing attributeChoose an existing attribute to store the data, ensuring it's a key attribute if necessary.
    A new attributeName the new attribute and select its data type from Text, Boolean, Number. Ensure the attribute name is unique to avoid duplicates.
  11. Click Save.

Supported Selectors for Element Paths

For web touchpoints, MXO fully supports CSS selectors. Consider the following when crafting CSS selectors:

  • Selectors must be unique. If multiple elements match, MXO uses the first one in the DOM.
  • Ensure selectors are cross-browser compatible. Not all features are supported by every browser. For more details, refer to https://caniuse.com/?search=CSS selector

For documentation on CSS selectors, refer to https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelector

For mobile touchpoints, MXO also supports pseudo-XPATH selectors that start with a forward slash `/`.

Create a URI/API Parameter Attribute Capture Point (MXO UI)

Create Attribute Capture Points for URI/API parameters to collect data from web address query parameters or API call properties.

  1. Navigate to MXO and select Collect.
  2. Choose Interaction Points.
  3. Identify the Interaction Point to add an Attribute Capture Point.
  4. Click the Add icon for Attribute Capture Points.
  5. Select URI/API Parameter.
  6. Assign a Name to your capture point.
  7. Input the URI or API parameter for data capture.
  8. Determine the data storage option, either as a Customer Attribute or an Activity Attribute. Refer to Introduction to Attributes for more details.

  9. Decide if the captured value will be stored as an existing attribute or a new one, as outlined below:

    OptionProcedure
    An existing attributeChoose an appropriate attribute to store the data, ensuring it's compatible with the data type.
    A new attributeProvide a unique name and select a data type for the new attribute from options such as Text, Boolean, or Number.
  10. Click Save.

Create a URI/API Parameter Attribute Capture Point (MXO Extension)

Create Attribute Capture Points for URI/API parameters to collect data from web address query parameters or API call properties.

  1. Enable the MXO Extension on your website to capture customer data.

  2. Select Edit on the toolbar.

  3. Click the Add icon, choose URI/API parameter from the Attribute Capture menu, and open the main MXO UI.

    CP - URL API Parameter

  4. Name your capture point.

  5. Enter the URI or API parameter for data capture.

  6. Choose a storage option for the data: Customer Attribute or Activity Attribute, detailed in Introduction to Attributes.

  7. Decide on storage: use an existing attribute or create a new one, as outlined below.

    OptionProcedure
    An existing attributeSelect the attribute to store the data, ensuring it matches the data type if capturing a key attribute.
    A new attributeProvide a unique name and data type for the new attribute. Options include Text, Boolean, or Number.
  8. Click Save.

Capture Data from Cookies (MXO UI)

This section outlines the steps to create Cookie Attribute Capture Points for capturing data from cookies present on a webpage.

  1. Select the desired Interaction Point from the Collect menu to create an Attribute Capture Point.
  2. Click Add for Attribute Capture Points.

  3. Select Cookie Value.

  4. Name your Capture Point.

  5. Specify the cookie name for data capture.

  6. Choose storage as either a Customer Attribute or an Activity Attribute, detailed in Introduction to Attributes.

  7. Decide on storage: use an existing attribute or create a new one, as outlined below.

    OptionProcedure
    An existing attributeSelect the attribute to store the data, ensuring it matches the data type if capturing a key attribute.
    A new attributeProvide a unique name and data type for the new attribute. Options include Text, Boolean, or Number.
  8. Confirm changes with Save.

Create a Cookie Attribute Capture Point

  1. Enable the MXO Extension on your website's page.
  2. Use the toolbar to select Edit.
  3. Click the Add icon, choose Cookie from the Attribute Capture menu, and access the main MXO UI.
  4. Name the capture point and specify the cookie for data capture.
  5. Choose storage as either a Customer Attribute or an Activity Attribute, detailed in Introduction to Attributes.

  6. Decide on storage: use an existing attribute or create a new one, as outlined below.

    OptionProcedure
    An existing attributeSelect the attribute to store the data, ensuring it matches the data type if capturing a key attribute.
    A new attributeProvide a unique name and data type for the new attribute. Options include Text, Boolean, or Number.
  7. Confirm changes with Save.

Note: Only first-party cookies without the HttpOnly flag can be read by the MXO Tag.

Capturing Attributes on a Global (Wildcard) Interaction Point

Customer and Activity Attributes can be globally captured using a Wildcard Interaction Point.

A Global Interaction Point employs wildcards to cover various interactions, simplifying configuration and enabling the reuse of capture rules across multiple points on a Touchpoint. For more details, refer to Using Wildcards in Interaction Points.

Global Interaction Points store captured Customer Attributes in the customer's profile.

Activity Attributes are stored with the activity record of the Interaction Point that initiates the capture. For instance, a global Interaction Point defined as /* may have the following capture points:

Capture Points on Global InteractionAttributes Captured
Attribute CaptureActivity Attribute - Selected Color
Activity CaptureActivity - Research (Type) + iPhone (Proposition)

Manage Attribute Capture Points

Modify or remove Attribute Capture Points as needed to keep your data capture configuration up to date.

  1. In MXO, select Collect.
  2. Choose Interaction Points.
  3. Find and select the Interaction Point you wish to modify or delete.
  4. To edit, click the Edit icon for the desired Attribute Capture Point, make the necessary changes, and click Save.
  5. To delete, click the Delete icon for the desired Attribute Capture Point and confirm deletion by selecting Yes, delete it.