Configure an Audience Destination

Audience Destinations specify the locations with which you want to share customer data for further analysis using your own BI tools or for merging with existing data held in your own systems to enrich that data with information about customer behavior and intent. You can share customer data to:

  • a secure FTP location,
  • Azure Blob storage, or
  • Amazon S3.

You can also download data, locally, in Data Export v8 format.

Note: The Download destination for a Space is configured by default and available out-of-the-box
Important: Only users with the Admin or Creator role can create and manage Audience Destinations.

Audience Destinations are specific to an individual Space. they are not shared between multiple Spaces. If you have multiple Spaces you must configure Audiences Destinations for each of those Spaces.

Deciding which customer data to share with an Audience Destination

When you configure an Audience Destination, you can decide which customer data you choose to share with your existing systems, at the individual customer attribute level. This enables you to control the amount of customer data you share. For ease of integration, you can also specify the order in which those attributes are shared. You can choose to share:

  • all attributes, or
  • specific attributes.

You can include or exclude any customer data captured at Attribute Capture Points and saved in the Customer Metadata Data Adapter.

Note: The ability to share specific customer attributes applies only if you are sharing that data in CSV or JSON format.

Create an SFTP Audience Destination (Default Authentication)

  1. In MXO, choose Analyze.
  2. Select Audience Destinations.
  3. Click + Create.
  4. Enter a unique Name for your new destination.For example, BI Reporting.
  5. Optionally, provide a description for your new destination.
  6. Select SFTP from the Destination drop-down.
  7. Select the format in which you want to share the data. Choose one of the following:
    • CSV
    • JSON
    • Data Export v8
  8. Provide the following details about the SFTP server:
    FieldDescription
    ServerURL or IP Address of the SFTP server with which you want to share audience data.For example, ftp-oneserver.emea.cloudapp.azure.com.
    PortSFTP Port number. Typically, either 21 (TCP) or 22 (SSH).
    PathLocation in which to store data, relative to root.For example, /www.
    UsernameUsername required to access the SFTP server.
    Access TypeChoose Password and enter the password required to access the SFTP server.
  9. If you selected CSV or JSON format, choose which attributes to share with this destination. Choose either:
    • All attributes. Go to Step 14.
    • Specific attributes. Go to Step 11.
  10. Click + (Add).
  11. Select the attributes to share and click Select.
  12. If required, drag and drop the attributes in to the preferred order for sharing.
  13. Click Save.

Once your audience destination is configured, you can start sharing audience data.

Example SFTP Configuration (Default Authentication)

TB - FTP config details

Create an SFTP Audience Destination (SSH Authentication)

  1. In MXO, choose Analyze.
  2. Select Audience Destinations.
  3. Click + Create.
  4. Enter a unique Name for your new destination.For example, BI Reporting.
  5. Optionally, provide a description for your new destination.
  6. Select SFTP from the Destination drop-down.
  7. Select the format in which you want to share the data. Choose one of the following:
    • CSV
    • JSON
    • Data Export v8
  8. Provide the following details about the SFTP server:
    FieldDescription
    ServerURL or IP Address of the SFTP server with which you want to share audience data.For example, ftp-oneserver.emea.cloudapp.azure.com.
    PortSFTP Port number. Typically, either 21 (TCP) or 22 (SSH).
    PathLocation in which to store data, relative to root.For example, /www.
    UsernameUsername required to access the SFTP server.
    Access TypeChoose SSH and enter the following details:

    • Host Key. Host public key required to authenticate to the SFTP server.
    • Private Key. Client (user) private key required to authenticate to the SFTP server.
    • Passphrase. Passphrase associated with the client private key.Required only if the client private key was encrypted with a passphrase during initial setup.
  9. If you selected CSV or JSON format, choose which attributes to share with this destination. Choose either:
    • All attributes. Go to Step 14.
    • Specific attributes. Go to Step 11.
  10. Click + (Add).
  11. Select the attributes to share and click Select.
  12. If required, drag and drop the attributes in to the preferred order for sharing.
  13. Click Save.

Once your audience destination is configured, you can start sharing audience data.

Note: If unable to validate the credentials you provide during the creation process, MXO displays an error message to help with troubleshooting.

Example SFTP Configuration (SSH Authentication)

TB - FTP SSH config details

Create an Azure Blob Audience Destination

  1. In MXO, choose Analyze.
  2. Select Audience Destinations.
  3. Click + Create.
  4. Enter a unique Name for your new destination.For example, V8 Extracts.
  5. Optionally, provide a description for your new destination.
  6. Select Azure Blob from the Destination drop-down.
  7. Select the format in which you want to share the data. Choose one of the following:
    • CSV
    • JSON
    • Data Export v8
  8. Provide the following details:
    FieldDescription
    Storage Container Name

    Name of the storage container in which you want to store shared customer data.For example, mycoaudiencedata.

    Note: You must set up your storage container before creating your audience destination.

    Path PatternThe file path to use to write data within the specified storage container.For example, /import/audiencedata.
    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 access key associated with your storage account.
  9. If you selected CSV or JSON format, choose which attributes to share with this destination. Choose either:
    • All attributes. Go to Step 13.
    • Specific attributes. Go to Step 10.
  10. Click + (Add).
  11. Select the attributes to share and click Select.
  12. If required, drag and drop the attributes in to the preferred order for sharing.
  13. Click Save.

Once your audience destination is configured, you can start sharing customer data.

Example Azure Blob Configuration

TB - Azure config details

Create an Amazon S3 Audience Destination

  1. In MXO, choose Analyze.
  2. Select Audience Destinations.
  3. Click + Create.
  4. Enter a unique Name for your new destination.For example, BI Reporting.
  5. Optionally, provide a description for your new destination.
  6. Select Amazon S3 from the Destination drop-down.
  7. Select the format in which you want to share the data. Choose one of the following:
    • CSV
    • JSON
    • Data Export v8
  8. Provide the following details:
    FieldDescription
    RegionRegion in which your A3 bucket resides.
    S3 Bucket Name

    Name of the A3 bucket in which you want to store shared customer data.For example, oneudiencedata.

    Note: If the bucket you specify does not already exist in AWS S3, it is created for you, as long as your AWS user account has the correct permissions.

    Path PatternThe file path to use to write data within the specified bucket.For example, import/audiencedata.
    AWS Access Key IDThe Access key ID associated with your AWS user account.
    AWS Secret KeyThe secret access key associated with your AWS user account.
  9. If you selected CSV or JSON format, choose which attributes to share with this destination. Choose either:
    • All attributes. Go to Step 13.
    • Specific attributes. Go to Step 10.
  10. Click + (Add).
  11. Select the attributes to share and click Select.
  12. If required, drag and drop the attributes in to the preferred order for sharing.
  13. Click Save.

Once your audience destination is configured, you can start sharing customer data.

Example Amazon S3 Configuration

TB - AWS A3 config details

Edit an Audience Destination

  1. In MXO, choose Analyze.
  2. Select Audience Destinations.
  3. Click the Edit icon next to the Audience Destination you want to edit.
  4. Make your required changes and then click Save.

Delete an Audience Destination

  1. In MXO, choose Analyze.
  2. Select Audience Destinations.
  3. Click the Delete icon next to the Audience Destination you want to delete.
  4. Click Yes, delete it.