Azure Blob Storage Data Adapter

The Azure Blob Storage Data Adapter enables MXO to push data to Azure Blob storage for analysis in an external system.

This enables an organization to store data captured for a customer by MXO in the cloud for analysis using an Azure analytics service or other external system.

For more information about Azure Blob storage, see the Azure Blob storage documentation, on the Microsoft Azure website.

Examples

A bank want to gather insights about their customers for analysis in an external BI tool. They want to push data for the following events:

  • When a Search Attribute Capture Point is triggered, to provide them with details about a customer's last 5 searches.
  • When a customer moves from the Gold credit card journey to the Silver credit card journey.
  • To collect information about the furthest lifecycle stage a customer has reached across all journeys.
  • To collect information about customer sign-up during recent campaigns.

Container Names

When creating your Azure Blob Data Adapter, you must provide a name for the storage container in which you want to save data from MXO . A container name must be a valid DNS name and conform to the following rules:

  • Container names must start with a letter or number.
  • Container names can contain only letters, numbers, and the dash (-) character.
  • Every dash (-) character must be immediately preceded and followed by a letter or number; consecutive dashes are not permitted in container names.
  • Container names must be lowercase.
  • Container names must be between 3 and 63 characters long.

for more information, see Naming and Referencing Containers, Blobs, and Metadata, on the Microsoft Azure website.

Data Adapter Timeout Period

Requests from the Azure BLOB Storage Data Adapter are configured to timeout after one second. If MXO does not receive a response to a request within one second, the request will fail.

To create an Azure BLOB Storage Data Adapter

  1. In MXO, choose Collect.

  2. Select External Data, click Create.

  3. Choose Azure BLOB Storage 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
    Storage Account NameName of your Windows Azure storage account. This is the DNS prefix you used when creating your storage account. For example, for the account mycostorage.blob.core.windows.net, the account name is mycostorage.
    Storage Account Access KeyThe storage account access key associated with your storage account.
    Note: If you provide an access key, you do not need to provide an SAS token.
    Storage Account SAS TokenThe SAS token associated with your storage account.
    Note: If you provide an SAS token, you do not need to provide an access key.
    Storage Container NameName of the storage container in which you want to save data from MXO .
    Path PatternThe file path to use to write data within the specified storage account. Select the path prefix pattern to use. Choose from YYYY-MM-DD/HH (default setting - recommended), YYYY-MM-DD, YYYY/MM/DD, YYYY/MM/DD/HH.
  7. Click Test configuration. This tests and verifies that the new configuration details are valid.

  8. Click Apply.

  9. Click Save.