Microsoft Curate

Use GrowthLoop audiences for Microsoft Curate hashed-email Customer Match segments.

Connect this destination to export audience membership as hashed-email Customer Match segments, for use in Microsoft Curate or Invest campaigns.

This destination writes to your Microsoft Curate account and is a good fit when you want to:

  • Make GrowthLoop audiences available for Invest or Curate campaigns
  • Match contacts on email
  • Send export batches that have at least 100 email rows

This maps to GrowthLoop Audiences and Journeys:

Use it forAudiencesJourneys
Sending hashed-email Customer Match segments to Microsoft Curate

Use these segments in Invest or Curate. Microsoft does not support Customer Match in Monetize. To send Customer Match lists to Microsoft Advertising, use Microsoft Ads.

Prerequisites

Make sure you have:

  • A Xandr API username and password.
  • The numeric Xandr Member ID that owns the Customer Match segments.
  • Permission to share those customer emails with Xandr. Do not upload data from data brokers or web scraping, sensitive personal information, or people who have opted out of sharing.

Set up Microsoft Curate as a destination

  1. In GrowthLoop, click the Destinations tab on the left sidebar.
  2. Click New Destination in the top right corner.
  3. Search for Microsoft Curate and click Add Microsoft Curate.
  4. Enter the required information, then click Create.
FieldDescription
Destination NameName this destination in GrowthLoop. Use a name so your team recognizes its purpose, like "Microsoft Curate".
Sync FrequencySet the default export frequency (for example, daily or weekly). You can override this setting for individual exports.
Xandr usernameYour Xandr API username.
Xandr passwordYour Xandr API password.
Member IDNumeric Xandr member that owns the Customer Match segments.
Membership expiration days (optional)How many days a matched email stays in the segment. The default is -1, which means no expiration. Use -1 or a positive integer.

GrowthLoop validates the connection by authenticating with Xandr. Microsoft Curate then appears in your list of connected destinations.

Export to Microsoft Curate

From within GrowthLoop, export from an audience or from a journey Destination Node. See Export an audience or Build a journey if you need more information on these steps.

After building or selecting an audience, click Export, then search for Microsoft Curate. In a journey, add a Destination Node under Ads and select Microsoft Curate.

Journey Destination Node with export name, match fields, and personalization signals

Map contact identifiers

On an audience or in a journey Destination Node, map Email. This field is required.

GrowthLoop lowercases each email, trims whitespace, removes characters other than letters, numbers, ., @, and -, then hashes it as SHA-256. If the value is already a 64-character hex hash, GrowthLoop leaves it as-is.

This destination does not send additional personalization fields.

Configure the export

This is where you set the campaign type and schedule for audience exports. On a journey Destination Node, you set timing on the journey canvas.

SettingAudience exportJourney Destination Node
Export NameDefaults to the audience name. That is the Xandr segment name unless you change it.Required. Enter a name so you can find the export in GrowthLoop and the segment in Xandr.
Campaign typeChoose a one-time or ongoing export.The journey schedule controls when the journey runs and contacts are sent to Microsoft Curate.
ScheduleSet frequency, start date, end date, and days of the week for ongoing exports.Users reach this node when the journey runs. Add a Delay Node or set Criteria Evaluation to control timing.

Export behavior

This is what GrowthLoop writes when you export an audience.

BehaviorWhat happens
What GrowthLoop writesA Xandr Customer Match segment (object_type customer-match). Direction is GrowthLoop → Microsoft Curate.
When it runsGrowthLoop sends the export as a batch on the next successful run. An export that starts Now runs within about 15 minutes. Journeys send exports on demand when users reach the Destination Node. Membership can take up to 48 hours to become available for targeting.
SegmentGrowthLoop creates an active Customer Match segment named after the export name, or reuses that segment, and uses it on later runs.
Match fieldEmail, hashed as SHA-256.
Minimum batchEach upload must include at least 100 email rows. Smaller batches fail.
AddsGrowthLoop adds the hashed email to the Customer Match segment. That membership lasts for the Membership expiration days set on the destination. -1 means it does not expire.
One-time exportsGrowthLoop sends current membership once.
Ongoing adds and removalsOngoing exports add hashed emails for contacts who enter the audience and remove hashed emails for contacts who leave that segment.
DeletesGrowthLoop does not delete the Xandr segment.

Confirm the export was successful

When the run finishes, confirm you can use the data in Microsoft Curate.

  • Audience export: Open Xandr and look up the Customer Match segment named after the export.
  • Journey Destination Node: Open Xandr and look up the Customer Match segment named after the export.

In GrowthLoop, review counts on the audience Exports tab, or open the Activity tab on the journey Destination Node. See Export an audience or Monitor a journey for more information.

Congrats on successfully exporting to Microsoft Curate!

Troubleshooting

These are the issues we see most often. You can always email us at [email protected] for help.

ProblemCauseResolution
Connection fails to validateXandr username, Xandr password, or Member ID is wrongConfirm the API credentials and numeric Member ID in Xandr
The export fails because the batch is too smallThe upload has fewer than 100 email rowsExport at least 100 emails in that run. Xandr rejects smaller Customer Match files
Member is already uploading a customer match fileAnother Customer Match upload is in progress for that memberWait for the in-progress upload to finish, then export again
Rows fail to exportEmail is not mappedMap Email
You cannot find the segmentYou are searching in Monetize, or for a different nameSearch Invest or Curate for the export name. Microsoft does not support Customer Match in Monetize

What’s Next

Export an audience after you connect a destination

Did this page help you?