Unity Ads campaign configuration

At a glance: Unity Ads, an AppsFlyer ad network integrated partner, is a video ad network for iOS and Android. In addition to click-based mobile attribution, Unity Ads offers cost, ad revenue, and view-through attribution, which can be recorded in AppsFlyer.

To configure your campaigns with Unity Ads, follow the steps below.

Setting up Unity Ads

Go to the dashboard of your app and click on Integrated Partners on the left bar.

Enter "Unity Ads" in the search field and click on its logo to open the Unity Ads configuration window.

The Unity Ads configuration window includes 5 tabs: Integration, Attribution link, Cost, Ad Revenue, and Permissions. Click on the items below to read about the tabs setup.

For a detailed description of the Partner Configuration Window Header, click here.

 Tip

  • The General Settings step in the Integration tab is mandatory for all partners.
  • All the rest of the steps are either descriptive or optional.

Integration tab

Activate partners

On the first visit, you will need to turn on the Activate partner toggle to setup the integration. The toggle must remain on for as long as you work with the partner.
For more details about partner activation please click here.

General settings

Sending Device ID (Advertising ID) to Unity

At the top of the Integration tab is a note that says that Unity Ads requires AppsFlyer to send them a postback with the device ID for every install.

Unity_msc_new_2.png

AppsFlyer sends the device ID automatically. You don't have to do anything on your end to send the device ID for every install.

Unity Ads Game ID

Unity Ads requires connecting with AppsFlyer via a unique game ID. If you don't know yours, you can obtain it directly from Unity Ads or you can find it, after uploading the game, under Apps > Campaigns, as shown in the screenshot below.

The Unity Ads Platform maps one app to a single Unity Ads Game ID, per account level (advertisers and agencies will have different Game IDs for the same app). Multiple accounts on the Unity Ads Platform can't run the same app with different Game IDs.

Enable View-Through attribution

Turn on this option to attribute view-through installs from Unity Ads. The view-through lookback slider is available on the attribution link tab (described below).

Unity_ads_msc_new_3.png

Default postbacks

Screen_Shot_2022-07-28_at_13.07.25.png

AppsFlyer can send automatic postbacks to Unity Ads following user installs and re-engagements. Use this section to define the source of the users that allow sending these postbacks:

  • This partner only: for events coming only from users attributed to Unity Ads.
  • All media sources including organic: to have your entire user base available to be reported to Unity Ads. According to Unity Ads, it is recommended to select this option.

 Note

As an all-installs network, The Trade Desk prefers to receive postbacks for all new installs of your app from any source, including organic. It is recommended to select All media sources including organic to send all install postbacks to Unity Ads.

In-app events settings

Map AppsFlyer events with the partner via postbacks. If postback sending is enabled, this includes rejected in-app events (events blocked by Protect360 or events found to be non-compliant by target validation rules).

To configure in-app event postbacks

  1. Enter the game_id. Make sure the game_id is correct and is the same as used for install attribution. 
  2. Turn on In-app event postbacks.
  3. Set the In-app event postback window, if required (read more about in-app event postback window configuration). 
  4. Click Add event to add an SDK or server-to-server event to the list.
  5. Complete the following parameters:
Parameter Name Description
AppsFlyer event

The name of the event, as received by AppsFlyer either from the SDK integrated into your app or from server-to-server events.
Tip: Don't see the event you are looking for?

  • Make sure to activate the event on a device with a non-organic installation and recheck.
  • Type it in AppsFlyer event, then click Create custom. Read more about custom event mapping.
mapped to partner event

The unique name or ID of each event, as defined on the partner's side. Possible mapping configurations are:

  • Text field: Get the corresponding event ID from the partner.
  • Drop-down box: Select the most suitable pre-defined AppsFlyer event.
  • As is: Send the events as they are, without name mapping.
for users from

Select the sending option for the event:

  • This partner only: send postbacks only when this event is attributed to this partner.
  • All media sources, including organic: send postbacks for events attributed to any partner, as well as organic events. According to Unity Ads, this option is recommended.
including
  • No data (default): send only the event itself without the event value.
  • Values and revenue: send all the event parameters, including the revenue value (if exists in the event). According to Unity Ads, this option is recommended.
  • Values without revenue: send all the parameters excluding the revenue value.

 Important!

Select the correct SDK/server-to-server event and the corresponding partner event identifier. Do not duplicate events (do not pass the same events under different SDK/server-to-server event names).

Attribution link tab

Generate and save attribution links and send them to the partner for attributing specific campaigns, ad sets, or single ads - both for UA and retargeting campaigns. You can use either a single-platform link or a OneLink.
More about attribution link structure and parameters.

To generate an attribution link, follow these instructions.

Notes:

Cost tab

AppsFlyer gets cost details by API. See the ad network cost integration table for full details on the supported dimensions, metrics, and features. 

Note:

  • Cost data requires an Xpend subscription.
  • Cost data from Unity Ads can be received only for downloads coming from Google Play or Apple App Store. For Android, cost data for third-party Android app stores isn't supported.
  • Agency cost is only available via click; not via API integration. 

To enable the cost API:

View your cost API status and the last time AppsFlyer managed to pull matching cost data in either the cost (and ad revenue) integration status dashboard, or in the individual ad network dashboard.

Ad revenue tab

This section is relevant if you are acting as a publisher, displaying ads of the partner to your users. As such, you would certainly like to measure the engagement of your users acquired from different sources, to find the most profitable sources for you.

To enable the ad revenue API:

Permissions tab

In this tab, you can select the permissions to grant Unity Ads to perform certain actions. Note that even if attribution is disabled for Unity Ads, the permissions tab is active and you can grant Unity Ads permissions.
Learn more about the permissions you can grant.

Was this article helpful?