Unity Grow

Overview

The Unity Grow connector is a destination that uploads device identifiers to Unity Grow (Supersonic) Audiences. You can either:

• Select an existing Unity Grow audience to update, or
• Create a new audience in Unity Grow and then upload devices into it.

This destination requires a data contract (schema) to be attached to the stream.

Authentication

Unity Grow uses Basic Auth with:

• Username
• Secret key

These credentials are sent as an Authorization: Basic ... header to Unity Grow’s Audience API.

Required credentials

Field	Type	Required	Description
username	string	✅	Unity Grow API username
secret_key	string	✅	Unity Grow API secret key

Setup

1. Collect your Unity Grow API credentials (username and secret key).
2. Create a destination connection using those credentials.
3. Create a stream using the Unity Grow Audiences destination.
4. Attach a data contract that includes the device identifier field(s) you want to upload.
5. In the stream configuration, choose an existing audience or select Create new audience.

Stream configuration

Audience selection

When configuring a stream, you can choose from a dynamically loaded list of existing audiences, plus an option to create a new one.

Field	Type	Required	Description
audience_selection	string	✅	Select an existing audience ID, or choose Create new audience

If you choose Create new audience, additional fields are required.

Create new audience fields

Field	Type	Required	Description
audience_name	string	✅	Name for the new audience
audience_type	string	✅	Audience type to create in Unity Grow
description	string	✅	Audience description
platform	string	➖	Platform for the audience (required for some audience types)
bundle_id	string	➖	Android bundle/package ID (required for Android suppression audiences)
track_id	string	➖	iOS track ID (required for iOS suppression audiences)

Suppression audience validation

For audience_type = suppression_static, the connector enforces:

• platform is required and must be one of: android, ios
• If platform = android, then bundle_id is required
• If platform = ios, then track_id is required

If these requirements are not met, the sync will fail with a configuration error.

Data contract requirement

This destination does not support streams without a data contract. If a stream is not connected to a data contract, the run will fail.

Ensure your stream is attached to a contract that defines the device identifier field(s) you intend to send.

Behavior and limits

• The connector uploads devices to Unity Grow in batches.
• Large uploads are split across multiple requests.

Streams

Unity Grow Audiences (destination)

Uploads device identifiers into a Unity Grow audience.

Typical use cases

• Build and refresh targeting audiences in Unity Grow
• Maintain suppression lists (when supported by your Unity Grow account and audience type)

Configuration

• Choose an existing audience via audience_selection, or create a new one using the fields described above.

Notes

• Audience options are loaded dynamically from Unity Grow at configuration time.
• The connector verifies credentials during login by calling Unity Grow’s audience API.