Connect this destination to export audience membership onto a Viant Data Platform (VDP) segment, for use in Viant DSP campaigns.

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

• Make GrowthLoop audiences available for Viant DSP campaigns
• Let GrowthLoop create and maintain the Viant segment for each export
• Match contacts on email, physical address, IP, mobile ID, or cookie ID
• Remove contacts from the Viant segment when they leave the audience

This maps to GrowthLoop Audiences:

To send conversion events to Viant for attribution, use Viant Conversions instead.

Prerequisites

Make sure you have:

• A Viant DSP account. See Viant if you need one.
• Username and Password partner credentials for GrowthLoop. Ask your Viant representative. These are not your regular Viant login.
• Your numeric Viant Account ID and one or more numeric Advertiser IDs. Ask your Viant representative if you do not have them.
• An audience with at least 1,000 contacts that Viant can match. Viant requires at least 1,000 matches before a new segment becomes active for targeting. Matches are identifiers Viant recognizes, not the rows GrowthLoop uploads, so plan for an audience larger than 1,000 rows.

📘

Note

Destinations created before Viant Audience API support may not have an Account ID. Those destinations keep using Viant's legacy data-insert endpoint. To move a destination to the Audience API, follow Move a legacy destination to the Audience API.

Set up Viant 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 Viant and click Add Viant.
4. Enter the required information, then click Create.

⚠️

Warning

Use the GrowthLoop partner credentials your Viant representative provides. Do not paste a regular Viant user login.

When you enter an Account ID, GrowthLoop signs in to Viant and checks the Account ID and Advertiser ID before saving the destination. Viant then appears in your list of connected destinations.

Export to Viant

From within GrowthLoop, export from an audience. See Export an audience if you need more information on these steps.

After building or selecting an audience, click Export, then search for Viant.

Map a contact identifier

A Viant segment holds a single identifier type. Map exactly one of the following identifiers. The export fails if you map more than one, or none.

GrowthLoop does not send rows without a valid value for the mapped identifier. It counts them as rejected and reports the reason in the export logs.

📘

Note

UID2, RampID, ID5, Transaction ID, and Sales Amount apply only to legacy destinations without an Account ID. Audience API exports ignore them.

This destination does not send additional personalization fields.

Configure the export

This is where you set the campaign type and schedule for audience exports.

• Export Name: Defaults to the audience name. Use this to find the export in GrowthLoop.
• Campaign type: Choose a one-time or ongoing export.
• Export Inclusion Criteria: All audience members for a full refresh, or Newly added audience members for additions since the last export.
• Schedule: Set frequency, start date, end date, and days of the week for ongoing exports.
• Segment Name: Required. GrowthLoop uses this name when it creates the Viant segment.
• Segment ID: Optional. Leave it blank to have GrowthLoop create a segment for the export. To write to a segment that already exists, enter its VDP segment ID. The segment must belong to the destination's Viant account, hold the identifier type you mapped, and not be archived.
• Adelphic / Viant AID: Optional. Comma-separated advertiser IDs to share a new segment with. Overrides the destination's Advertiser ID for this export.
• Segment ID Type: Applies only to legacy destinations. Audience API exports ignore it.

💡

Tip

Leave Segment ID blank unless you need to fill a segment you manage in Viant. GrowthLoop then creates one segment for the export and reuses it on every run.

Export behavior

This is what GrowthLoop writes when you export an audience.

📘

Note

Viant counts unique values. If your audience has duplicate identifiers, such as several rows with the same email, the Viant segment count is lower than the number of rows GrowthLoop sent.

Confirm the export was successful

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

• Audience export: Sign in to Viant, open Identity Management, look up the Segment Name you entered, and check that the segment is active.

In GrowthLoop, review accepted and rejected counts on the audience Exports tab. See Export an audience for more information. Accepted counts show what Viant received, not whether the segment is active.

📘

Note

If the segment is not active, Viant may still be processing the upload, or the segment may have fewer than 1,000 matches. See Troubleshooting.

Congrats on successfully exporting to Viant!

Legacy destinations without an Account ID

Viant destinations without an Account ID use Viant's legacy data-insert endpoint. They work differently from Audience API exports:

• You must create the segment in Viant first and enter both its Segment Name and Segment ID on the export. The run fails with an error if Segment ID is blank.
• Email is required. You can also map Physical Address, IP, Mobile ID, Cookie ID, UID2, RampID, ID5, Transaction ID, and Sales Amount.
• Segment ID Type sets the segment type: Userpool for an existing DSP userpool, Taxonomy for an existing DSP taxonomy segment, or Third Party for a third-party DSP taxonomy.
• Exports add contacts only. Contacts who leave the GrowthLoop audience stay on the segment.
• If Viant confirms only part of an upload, GrowthLoop reports the rest as failed. If Viant confirms no records, the run fails.

Move a legacy destination to the Audience API

Moving to the Audience API gives each export a new VDP segment. Audience API exports ignore numeric legacy segment IDs, so the new segment starts empty. An existing Newly added audience members export sends only contacts added since its last run, so contacts already in the audience never reach the new segment. You cannot change Segment ID or Export Inclusion Criteria on an existing export, so create a replacement export instead.

1. On the audience Exports tab, uncheck Enabled on each existing Viant export. This stops it from writing an incomplete segment after you add the Account ID.
2. Edit the destination and add your Account ID and Advertiser ID.
3. Create a new Viant export for the same audience. Leave Segment ID blank and set Export Inclusion Criteria to All audience members. See Export to Viant.
4. After the first run, open Viant Identity Management, find the new segment by its Segment Name, and check that it is active and its size matches your audience.
5. Update your Viant campaigns to target the new segment instead of the legacy one.

Troubleshooting

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