Integration troubleshooting

• Your campaign receives install data within two days of launch.
• Your campaign receives post-install event data within seven days of launch.

• Adjust
• Airbridge
• AppsFlyer
• ByteBrew
• Singular
• Tenjin

No install data in two days

Integration-blocking issues detected for one or more campaigns. These issues can severely impact performance. Resolve this issue to ensure accurate tracking and delivery: Within 2 days of launch, campaigns must receive at least one install postback.

Cause

Resolutions

Share install data from all sources

Review integration setup

Complete the following steps to correctly integrate Adjust and share data with your User Acquisition campaign:

1

Activate Unity Ads in the Adjust dashboard

To activate the integration with Unity Ads, follow these steps:

1. In the Adjust dashboard, go to Campaign Lab > Partners.
2. Select + New partner and search for Unity Ads.
3. Choose your app and select Next.
4. Enter your advertiser Game ID in the GAME ID field. To copy your Game ID from the Unity Dashboard, refer to the following steps:

Copy your Game ID from the Unity Dashboard

To copy your Game ID from the User Acquisition Dashboard, follow these steps:

1. Go to Apps from the left navigation menu of the dashboard. The provided table lists each of your organization's apps.
2. Scroll or search to locate the desired app.
3. Select Settings () at the end of the app row to open the app details page.
4. Go to the MMP settings section.
5. Select copy () next to Game ID to copy the ID to your clipboard.

Note

Enter your Game ID exactly as shown in the User Acquisition dashboard. Mismatched Game IDs prevent Unity from receiving events correctly.

2

Choose data to share with Unity

To select which data Adjust can share with your campaign, follow these steps in the Adjust integration:

1. From the What sources of data do you want to share options, select Data from all attribution sources.
2. From the What other data do you want to share? section, select all options:

• Sessions
• Uninstalls and reinstalls
• In-app revenue
• Parameters

3. In the Parameters data options, select Send all parameters.

Important

You must share all data types to enable Return on Ad Spend (ROAS) and Event optimization campaigns.

3

Map events and parameters

To share in-app events with your User Acquisition campaign, do the following in the Adjust integration:

1. Go to Data sharing > Map your events and select + Map event.
2. Choose the event you want Adjust to share with Unity from the Adjust event list.

3. To map the same events for all platforms, select Use global mapping.
4. Select or enter the Unity event that corresponds with the correct Adjust event in the Partner event > Name field.

Refer to the following table for correct Adjust event mapping:

Adjust event mapping

Event type	Adjust App event	Unity Partner event	Mapping notes
In-app purchase (IAP)	purchase	purchase	-
Ad revenue	ad_revenue	ad_revenue	If your Adjust account supports ad revenue data-sharing, send this data as a dedicated ad_revenue event. Otherwise, don't send ad revenue events. Mapping ad revenue events as other event types can cause campaign optimization to stop working.
Milestone completion	{milestone_event}	level_complete_{NameOfEvent}	You can use any custom defined event name for the Adjust App event. Ensure that you use the provided formatting for the partner event Name. The NameOfEvent must not contain spaces.
Session	session launch	session	Session events for Retention campaigns don't require event mapping.

purchase

ad_revenue

level_complete

session

Complete the following steps to correctly integrate AppsFlyer and share data with your User Acquisition campaign:

1

Activate the Unity Ads integration

To activate Unity Ads in the AppsFlyer dashboard, follow these steps:

1. In the AppsFlyer dashboard, go to Collaborate > Partner Marketplace.
2. Search for Unity Ads and select Set up integration to open in the Integration tab.
3. Activate the Activate Partner toggle.
4. Some advertisers might have an Advanced Privacy toggle in the Integration tab. If your dashboard contains this toggle, ensure that you deactivate it.

Important

If Advanced Privacy is active in your integration setup, AppsFlyer can't share any event data with your campaign.

2

Configure general integration settings

To configure your general integration settings, follow these steps in the Integration tab > General settings section:

1. Activate the Share organic/non-organic indication toggle.

2. Enter your Unity Game ID in the Unity Ads Game ID field. To copy your Game ID from the Unity Dashboard, refer to the following steps:

Copy your Game ID from the Unity Dashboard

To copy your Game ID from the User Acquisition Dashboard, follow these steps:

1. Go to Apps from the left navigation menu of the dashboard. The provided table lists each of your organization's apps.
2. Scroll or search to locate the desired app.
3. Select Settings () at the end of the app row to open the app details page.
4. Go to the MMP settings section.
5. Select copy () next to Game ID to copy the ID to your clipboard.

Note

Enter your Game ID exactly as shown in the User Acquisition dashboard. Mismatched Game IDs prevent Unity from receiving events correctly.

3

Configure attribution settings

To set up attribution for your integration, follow these steps in the Integration tab of your AppsFlyer integration:

1. Go to the Install attribution section.
2. Set the Install engaged click-through lookback window to Days.
3. Using the slider, set the click-through window to 2 Days.
4. Activate the Install view-through attribution toggle.
5. Set the Install engaged view-through lookback window to Days.
6. Using the slider, set the view-through window to 7 Days.

7. To set the users for Install events, go to the Default postbacks section.
8. Select for users from > All media sources, including organic

4

Configure data-sharing settings

To set up secondary postbacks for post-install events, follow these steps in the Integration tab:

1. Go to the In-app event settings section
2. Enter your Game ID in the game_id field. To copy your Game ID from the Unity Dashboard, refer to the following steps:

Copy your Game ID from the Unity Dashboard

To copy your Game ID from the User Acquisition Dashboard, follow these steps:

1. Go to Apps from the left navigation menu of the dashboard. The provided table lists each of your organization's apps.
2. Scroll or search to locate the desired app.
3. Select Settings () at the end of the app row to open the app details page.
4. Go to the MMP settings section.
5. Select copy () next to Game ID to copy the ID to your clipboard.

Note

Enter your Game ID exactly as shown in the User Acquisition dashboard. Mismatched Game IDs prevent Unity from receiving events correctly.

3. Activate the In-app event postbacks toggle.
4. Set the In-app event postback window to Lifetime

5. Map your post-install events to Unity events in the mapped to partner event column as follows:

• Session events to

  session

• Level Complete events to

  level_complete

• Ad Revenue events to

  ad_revenue

• In-app Purchase events to

  purchase

Refer to the following table for suggested AppsFlyer event names and required Unity event names:

Event type	Suggested AppsFlyer event	Required Unity partner event	Mapping notes
Session	af_app_opened	session	-
Ad revenue	af_ad_revenue	ad_revenue	If your AppsFlyer account supports ad revenue data-sharing, enable ad revenue sharing with the Get ad revenue data toggle in the Ad revenue tab. Otherwise, don't send ad revenue events. Mapping ad revenue events as other event types can cause campaign optimization to stop working. Refer to the AppsFlyer Ad revenue attribution documentation for details and instructions.
In-app purchase	af_purchase	purchase	Don't map revenue events to purchase events.
Milestone completion	af_level_achieved {custom_milestone_event}	level_complete	You must enter level_complete in the mapped to partner event field. You can enter custom SDK event names in the AppsFlyer event field.

You must enter the required Unity event name in the mapped to partner event field. You can enter custom SDK event names in the AppsFlyer event field. However, the recommended best practice is to use the Suggested AppsFlyer event names provided here.

If you want to send ad revenue data for Return on Ad Spend (ROAS) Ad revenue or Hybrid campaigns, you must enable ad revenue data-sharing in your integration.

To share ad revenue event data with your campaign, follow these steps:

Enable ad revenue data-sharing

1

Activate ad revenue sharing

To activate ad revenue data-sharing, follow these steps in the AppsFlyer dashboard:

1. Go to Collaborate > Partner Marketplace and search for

   Unity Ads

   to open your Unity Ads integration.
2. In the Ad revenue tab, activate the Get ad revenue data toggle.

2

Configure ad revenue data-sharing

To configure your ad revenue data-sharing settings, follow these steps in the AppsFlyer dashboard:

1. From the AppsFlyer dashboard side menu, go to Settings > Revenue Settings.

Important

To access the Revenue Settings menu, you need an AppsFlyer ROI360 subscription. Refer to the AppsFlyer Ad revenue attribution documentation for details and instructions.

2. In the Revenue settings > Ad revenue tab, select New ad revenue integration.
3. Select Unity Ads from the list of revenue partners.
4. In the partner configuration, select Impression-level (via SDK) with Device-level (via S2S API) as the report type.

3

Enter your API credentials

To finish your ad revenue data-sharing setup, follow these steps in the AppsFlyer dashboard Revenue Settings:

1. Enter your Unity Game ID in the App key field. To retrieve your Game ID from the Unity Dashboard, refer to the following steps:

Copy your Game ID from the Unity Dashboard

To copy your Game ID from the User Acquisition Dashboard, follow these steps:

1. Go to Apps from the left navigation menu of the dashboard. The provided table lists each of your organization's apps.
2. Scroll or search to locate the desired app.
3. Select Settings () at the end of the app row to open the app details page.
4. Go to the MMP settings section.
5. Select copy () next to Game ID to copy the ID to your clipboard.

2. Enter your Unity API Service account secret key in the Secret key field. To retrieve your secret key from the Unity Dashboard, refer to the following steps:

Copy your secret key from the Unity Dashboard

Note

Only Organization Owners or Organization Managers can create service accounts and secret keys. Refer to User types, roles, and permissions for more information.

To retrieve your Secret key and Key ID from the User Acquisition dashboard, follow these steps:

1

Create or open your service account

To generate API keys, you need a service account. To access your service account, follow these steps:

1. Go to Settings > API management.

2. In the Stats API v2.0 section, select Service account.
3. On the Service accounts page, select your account from the table. If you don't have a service account, select + New to create one.

2

Generate keys

To generate a secret key and key ID, follow these steps:

1. From your service account page, go to the Keys section.
2. Select + Add key to generate a Key ID and Secret key. You can't view previously-generated keys.
3. Select the copy buttons following the Key ID and the Secret key to copy both credentials.

Important

The dashboard displays the Secret key only once. Store the Key ID and Secret key together somewhere secure. If you lose the Secret key, you must create a new key.

3

Assign the organization role

A service account with no role assigned can still authenticate, but every request it makes fails with a

403

error and an Invalid Credentials message. You must assign the Advertise Stats API MMP Viewer role to your service account before you use its credentials.

To assign this role, follow these steps from your service account:

1. In the Organization roles section, select + Manage organization roles.
2. Open the User Acquisition category and select Advertise Stats API MMP Viewer.
3. Select Save.

5

Set partner permissions

In the Permissions tab, configure the following permissions settings:

1. Activate the Toggle Ad Network Permissions toggle to enable all other toggles.
2. Activate the following toggles:

• Configure integration
• Configure in-app event postbacks
• Access retention report
• Access aggregate conversions and in-app event data
• Access aggregate revenue data
• View validation rules
• Access Protect360 dashboard and raw data
• Access ad revenue raw data (UA signals)

For descriptions of each permission, refer to the Permissions tab documentation in the AppsFlyer Help Center.

Complete the following steps to correctly integrate Singular and share data with your User Acquisition campaign:

1

Activate Unity Ads in the Singular dashboard

To activate your integration in the Singular dashboard, follow these steps:

1. Go to Attribution Setup > Partner Configuration.
2. Select Add a Partner. Search for and select Unity Ads.
3. Enter your advertiser Game ID in the Unity Ads Game ID field. To copy your Game ID from the Unity Dashboard, refer to the following steps:

Copy your Game ID from the Unity Dashboard

To copy your Game ID from the User Acquisition Dashboard, follow these steps:

1. Go to Apps from the left navigation menu of the dashboard. The provided table lists each of your organization's apps.
2. Scroll or search to locate the desired app.
3. Select Settings () at the end of the app row to open the app details page.
4. Go to the MMP settings section.
5. Select copy () next to Game ID to copy the ID to your clipboard.

Note

Enter your Game ID exactly as shown in the User Acquisition dashboard. Mismatched Game IDs prevent Unity from receiving events correctly.

2

Configure data-sharing settings

To configure data-sharing settings, follow these steps:

1. In the Attribution Postbacks & Settings tab, go to the Attribution Postbacks table.
2. Select the Install checkbox in the Attribution Event column.
3. In the same row, select the following checkboxes:

• Send View Through
• Send All
• Send Fraud Postbacks

3

Map post-install events

Map Singular events based on whether they include revenue. Map events that include Revenue in the Revenue Events Postbacks section, and map events that don't include revenue in the Events Postbacks section:

Event type	Revenue values included	Mapping location
Ad revenue In-app purchase	Yes	Revenue Events Postbacks
Session Milestone completion	No	Events Postbacks

Refer to the following mapping instructions:

Revenue values includedNo revenue values included

To send ad revenue and in-app purchase event data, follow these steps in the Revenue Events Postbacks section of the In-app Events Postback tab:

1. Select your Singular events in the SDK Event Name column and map them to Unity events in the Event Name column as follows:

Event type	Singular SDK Event Name	Unity Event Name	Mapping notes
In-app purchase (IAP)	__iap__ {custom_purchase_event_name}	purchase	You can use either the default purchase name, __iap__, or enter a custom-defined name in the SDK Event Name field for in-app purchase events.
Ad revenue	__ADMON_USER_LEVEL_REVENUE__	ad_revenue	Don't map revenue events to __REVENUE__.

2. To share data from your entire user base, select the Send all checkbox for each event.
3. In the Postback Window Starting Point column, select Unlimited for each event.
4. If you have a Singular Enterprise account, set the Postback Window (days) to Unlimited . Otherwise, set the window to

   30

   days.
5. Select the Include Revenue checkbox for each event.

To send milestone completion and session event data, follow these steps in the Events Postbacks section of the In-app Events Postback tab:

1. Select your Singular events in the SDK Event Name column and map them to Unity events in the Event Name column as follows:

Event type	Singular SDK Event Name	Unity Event Name	Mapping notes
Milestone completion	{custom_milestone_event_name}	level_complete	You can use any custom-defined SDK event name in the SDK Event Name field for milestone completion events.
Session	__SESSION__	session	-

2. To share data from your entire user base, select the Send all checkbox for each event.
3. In the Postback Window Starting Point column, select Unlimited for each event.
4. If you have a Singular Enterprise account, set the Postback Window (days) to Unlimited . Otherwise, set the window to

   30

   days.

Complete the following steps to correctly integrate Tenjin and share data with your User Acquisition campaign:

1

Copy credentials from the Unity Dashboard

You need the following Unity account credentials to complete your Tenjin integration:

Game ID

To retrieve your Game ID from the Apps page of the User Acquisition dashboard, follow these steps:

1. From the dashboard left navigation menu, go to Apps. The provided table lists each of your organization's apps. Following each app name, the dashboard displays the app platform and Game ID.
2. Select the Copy symbol next to the ID to copy it to your clipboard.
3. Optionally, hover over the app name to copy the Campaign Set ID and Store ID as well.

Note

Enter your Game ID exactly as shown in the User Acquisition dashboard. Mismatched Game IDs prevent Unity from receiving events correctly.

Secret Key and Key ID

Note

Only Organization Owners or Organization Managers can create service accounts and secret keys. Refer to User types, roles, and permissions for more information.

To retrieve your Secret key and Key ID from the User Acquisition dashboard, follow these steps:

1

Create or open your service account

To generate API keys, you need a service account. To access your service account, follow these steps:

1. Go to Settings > API management.

2. In the Stats API v2.0 section, select Service account.
3. On the Service accounts page, select your account from the table. If you don't have a service account, select + New to create one.

2

Generate keys

To generate a secret key and key ID, follow these steps:

1. From your service account page, go to the Keys section.
2. Select + Add key to generate a Key ID and Secret key. You can't view previously-generated keys.
3. Select the copy buttons following the Key ID and the Secret key to copy both credentials.

Important

The dashboard displays the Secret key only once. Store the Key ID and Secret key together somewhere secure. If you lose the Secret key, you must create a new key.

3

Assign the organization role

A service account with no role assigned can still authenticate, but every request it makes fails with a

403

error and an Invalid Credentials message. You must assign the Advertise Stats API MMP Viewer role to your service account before you use its credentials.

To assign this role, follow these steps from your service account:

1. In the Organization roles section, select + Manage organization roles.
2. Open the User Acquisition category and select Advertise Stats API MMP Viewer.
3. Select Save.

Organization core ID

To retrieve your Organization core ID from the Settings page of the User Acquisition dashboard, follow these steps:

1. Go to the Organization section of the Settings page.
2. Copy the numeric ID next to Organization core ID.

Note

Ensure that you copy the numeric Organization core ID, not the alphanumeric Organization ID.

2

Activate Unity Ads in the Tenjin dashboard

To integrate Unity with Tenjin, follow these steps in the Tenjin dashboard:

1. Go to the Configure tab and select Channels.
2. Search for Unity Ads in the Marketing Channel Name field.
3. In the New Marketing Channel setup for Unity Ads, enter the Unity account credentials you copied from the Unity dashboard and give your account a name.
4. In the Tenjin navigation menu, go to the Campaigns tab and select Create Campaign.
5. Select Unity Ads from the Marketing Account dropdown.
6. Choose your app from the App dropdown and give your campaign a descriptive Name.
7. When the system prompts you with a Callback to be created message, follow the provided link to continue and generate an attribution link.

3

Configure data-sharing settings

With Tenjin, configuring the data-sharing settings also maps your in-app events. To configure data-sharing settings and map events with Tenjin, do the following as you finish the activation workflow:

1. After you follow the link in the Callback to be created message, select Unity Ads from the Channels and Partners dropdown.
2. In the Channel callbacks section, activate the following toggles:

• Unity Ads ad revenue
• Unity Ads app open
• Unity Ads IAP
• Unity Ads install

Important

Don't map ad revenue events as In-App Purchase events. If your Tenjin account supports ad revenue data-sharing, send this data as a dedicated Ad Revenue Impression event.

If your account doesn't support ad revenue data-sharing, don't send ad revenue as a different event type, as this event mismatching can cause campaign optimization to stop working.

3. For each event callback, select all users from the User filter dropdown.

No post-install event data in seven days

Integration-blocking issues detected for one or more campaigns. These issues can severely impact performance. Resolve this issue to ensure accurate tracking and delivery: Within 7 days of launch, campaigns must receive at least one post-install event postback.

Causes

Attribution configured incorrectly

Ad revenue reporting disabled

• In-app Purchase (IAP) Return on Ad Spend (ROAS)
• Ad Revenue ROAS
• Hybrid ROAS
• Payer Event Optimization

Resolutions

Map post-install events correctly

purchase

purchase

ad_revenue

ad_revenue

ad_revenue

{milestone_event}

level_complete_{NameOfEvent}

NameOfEvent

session

purchase

ad_revenue

session

af_app_opened

session

af_ad_revenue

ad_revenue

af_purchase

purchase

level_complete

level_complete

purchase

ad_revenue

session

purchase

ad_revenue

level_complete

{custom_milestone_event_name}

session

purchase

ad_revenue

session

Configure data-sharing correctly

Complete the following steps to correctly integrate Adjust and share data with your User Acquisition campaign:

1

Activate Unity Ads in the Adjust dashboard

To activate the integration with Unity Ads, follow these steps:

1. In the Adjust dashboard, go to Campaign Lab > Partners.
2. Select + New partner and search for Unity Ads.
3. Choose your app and select Next.
4. Enter your advertiser Game ID in the GAME ID field. To copy your Game ID from the Unity Dashboard, refer to the following steps:

Copy your Game ID from the Unity Dashboard

To copy your Game ID from the User Acquisition Dashboard, follow these steps:

1. Go to Apps from the left navigation menu of the dashboard. The provided table lists each of your organization's apps.
2. Scroll or search to locate the desired app.
3. Select Settings () at the end of the app row to open the app details page.
4. Go to the MMP settings section.
5. Select copy () next to Game ID to copy the ID to your clipboard.

Note

Enter your Game ID exactly as shown in the User Acquisition dashboard. Mismatched Game IDs prevent Unity from receiving events correctly.

2

Choose data to share with Unity

To select which data Adjust can share with your campaign, follow these steps in the Adjust integration:

1. From the What sources of data do you want to share options, select Data from all attribution sources.
2. From the What other data do you want to share? section, select all options:

• Sessions
• Uninstalls and reinstalls
• In-app revenue
• Parameters

3. In the Parameters data options, select Send all parameters.

Important

You must share all data types to enable Return on Ad Spend (ROAS) and Event optimization campaigns.

3

Map events and parameters

To share in-app events with your User Acquisition campaign, do the following in the Adjust integration:

1. Go to Data sharing > Map your events and select + Map event.
2. Choose the event you want Adjust to share with Unity from the Adjust event list.

3. To map the same events for all platforms, select Use global mapping.
4. Select or enter the Unity event that corresponds with the correct Adjust event in the Partner event > Name field.

Refer to the following table for correct Adjust event mapping:

Adjust event mapping

Event type	Adjust App event	Unity Partner event	Mapping notes
In-app purchase (IAP)	purchase	purchase	-
Ad revenue	ad_revenue	ad_revenue	If your Adjust account supports ad revenue data-sharing, send this data as a dedicated ad_revenue event. Otherwise, don't send ad revenue events. Mapping ad revenue events as other event types can cause campaign optimization to stop working.
Milestone completion	{milestone_event}	level_complete_{NameOfEvent}	You can use any custom defined event name for the Adjust App event. Ensure that you use the provided formatting for the partner event Name. The NameOfEvent must not contain spaces.
Session	session launch	session	Session events for Retention campaigns don't require event mapping.

purchase

ad_revenue

level_complete

session

Complete the following steps to correctly integrate AppsFlyer and share data with your User Acquisition campaign:

1

Activate the Unity Ads integration

To activate Unity Ads in the AppsFlyer dashboard, follow these steps:

1. In the AppsFlyer dashboard, go to Collaborate > Partner Marketplace.
2. Search for Unity Ads and select Set up integration to open in the Integration tab.
3. Activate the Activate Partner toggle.
4. Some advertisers might have an Advanced Privacy toggle in the Integration tab. If your dashboard contains this toggle, ensure that you deactivate it.

Important

If Advanced Privacy is active in your integration setup, AppsFlyer can't share any event data with your campaign.

2

Configure general integration settings

To configure your general integration settings, follow these steps in the Integration tab > General settings section:

1. Activate the Share organic/non-organic indication toggle.

2. Enter your Unity Game ID in the Unity Ads Game ID field. To copy your Game ID from the Unity Dashboard, refer to the following steps:

Copy your Game ID from the Unity Dashboard

To copy your Game ID from the User Acquisition Dashboard, follow these steps:

1. Go to Apps from the left navigation menu of the dashboard. The provided table lists each of your organization's apps.
2. Scroll or search to locate the desired app.
3. Select Settings () at the end of the app row to open the app details page.
4. Go to the MMP settings section.
5. Select copy () next to Game ID to copy the ID to your clipboard.

Note

Enter your Game ID exactly as shown in the User Acquisition dashboard. Mismatched Game IDs prevent Unity from receiving events correctly.

3

Configure attribution settings

To set up attribution for your integration, follow these steps in the Integration tab of your AppsFlyer integration:

1. Go to the Install attribution section.
2. Set the Install engaged click-through lookback window to Days.
3. Using the slider, set the click-through window to 2 Days.
4. Activate the Install view-through attribution toggle.
5. Set the Install engaged view-through lookback window to Days.
6. Using the slider, set the view-through window to 7 Days.

7. To set the users for Install events, go to the Default postbacks section.
8. Select for users from > All media sources, including organic

4

Configure data-sharing settings

To set up secondary postbacks for post-install events, follow these steps in the Integration tab:

1. Go to the In-app event settings section
2. Enter your Game ID in the game_id field. To copy your Game ID from the Unity Dashboard, refer to the following steps:

Copy your Game ID from the Unity Dashboard

To copy your Game ID from the User Acquisition Dashboard, follow these steps:

1. Go to Apps from the left navigation menu of the dashboard. The provided table lists each of your organization's apps.
2. Scroll or search to locate the desired app.
3. Select Settings () at the end of the app row to open the app details page.
4. Go to the MMP settings section.
5. Select copy () next to Game ID to copy the ID to your clipboard.

Note

Enter your Game ID exactly as shown in the User Acquisition dashboard. Mismatched Game IDs prevent Unity from receiving events correctly.

3. Activate the In-app event postbacks toggle.
4. Set the In-app event postback window to Lifetime

5. Map your post-install events to Unity events in the mapped to partner event column as follows:

• Session events to

  session

• Level Complete events to

  level_complete

• Ad Revenue events to

  ad_revenue

• In-app Purchase events to

  purchase

Refer to the following table for suggested AppsFlyer event names and required Unity event names:

Event type	Suggested AppsFlyer event	Required Unity partner event	Mapping notes
Session	af_app_opened	session	-
Ad revenue	af_ad_revenue	ad_revenue	If your AppsFlyer account supports ad revenue data-sharing, enable ad revenue sharing with the Get ad revenue data toggle in the Ad revenue tab. Otherwise, don't send ad revenue events. Mapping ad revenue events as other event types can cause campaign optimization to stop working. Refer to the AppsFlyer Ad revenue attribution documentation for details and instructions.
In-app purchase	af_purchase	purchase	Don't map revenue events to purchase events.
Milestone completion	af_level_achieved {custom_milestone_event}	level_complete	You must enter level_complete in the mapped to partner event field. You can enter custom SDK event names in the AppsFlyer event field.

You must enter the required Unity event name in the mapped to partner event field. You can enter custom SDK event names in the AppsFlyer event field. However, the recommended best practice is to use the Suggested AppsFlyer event names provided here.

If you want to send ad revenue data for Return on Ad Spend (ROAS) Ad revenue or Hybrid campaigns, you must enable ad revenue data-sharing in your integration.

To share ad revenue event data with your campaign, follow these steps:

Enable ad revenue data-sharing

1

Activate ad revenue sharing

To activate ad revenue data-sharing, follow these steps in the AppsFlyer dashboard:

1. Go to Collaborate > Partner Marketplace and search for

   Unity Ads

   to open your Unity Ads integration.
2. In the Ad revenue tab, activate the Get ad revenue data toggle.

2

Configure ad revenue data-sharing

To configure your ad revenue data-sharing settings, follow these steps in the AppsFlyer dashboard:

1. From the AppsFlyer dashboard side menu, go to Settings > Revenue Settings.

Important

To access the Revenue Settings menu, you need an AppsFlyer ROI360 subscription. Refer to the AppsFlyer Ad revenue attribution documentation for details and instructions.

2. In the Revenue settings > Ad revenue tab, select New ad revenue integration.
3. Select Unity Ads from the list of revenue partners.
4. In the partner configuration, select Impression-level (via SDK) with Device-level (via S2S API) as the report type.

3

Enter your API credentials

To finish your ad revenue data-sharing setup, follow these steps in the AppsFlyer dashboard Revenue Settings:

1. Enter your Unity Game ID in the App key field. To retrieve your Game ID from the Unity Dashboard, refer to the following steps:

Copy your Game ID from the Unity Dashboard

To copy your Game ID from the User Acquisition Dashboard, follow these steps:

1. Go to Apps from the left navigation menu of the dashboard. The provided table lists each of your organization's apps.
2. Scroll or search to locate the desired app.
3. Select Settings () at the end of the app row to open the app details page.
4. Go to the MMP settings section.
5. Select copy () next to Game ID to copy the ID to your clipboard.

2. Enter your Unity API Service account secret key in the Secret key field. To retrieve your secret key from the Unity Dashboard, refer to the following steps:

Copy your secret key from the Unity Dashboard

Note

Only Organization Owners or Organization Managers can create service accounts and secret keys. Refer to User types, roles, and permissions for more information.

To retrieve your Secret key and Key ID from the User Acquisition dashboard, follow these steps:

1

Create or open your service account

To generate API keys, you need a service account. To access your service account, follow these steps:

1. Go to Settings > API management.

2. In the Stats API v2.0 section, select Service account.
3. On the Service accounts page, select your account from the table. If you don't have a service account, select + New to create one.

2

Generate keys

To generate a secret key and key ID, follow these steps:

1. From your service account page, go to the Keys section.
2. Select + Add key to generate a Key ID and Secret key. You can't view previously-generated keys.
3. Select the copy buttons following the Key ID and the Secret key to copy both credentials.

Important

The dashboard displays the Secret key only once. Store the Key ID and Secret key together somewhere secure. If you lose the Secret key, you must create a new key.

3

Assign the organization role

A service account with no role assigned can still authenticate, but every request it makes fails with a

403

error and an Invalid Credentials message. You must assign the Advertise Stats API MMP Viewer role to your service account before you use its credentials.

To assign this role, follow these steps from your service account:

1. In the Organization roles section, select + Manage organization roles.
2. Open the User Acquisition category and select Advertise Stats API MMP Viewer.
3. Select Save.

5

Set partner permissions

In the Permissions tab, configure the following permissions settings:

1. Activate the Toggle Ad Network Permissions toggle to enable all other toggles.
2. Activate the following toggles:

• Configure integration
• Configure in-app event postbacks
• Access retention report
• Access aggregate conversions and in-app event data
• Access aggregate revenue data
• View validation rules
• Access Protect360 dashboard and raw data
• Access ad revenue raw data (UA signals)

For descriptions of each permission, refer to the Permissions tab documentation in the AppsFlyer Help Center.

Complete the following steps to correctly integrate Singular and share data with your User Acquisition campaign:

1

Activate Unity Ads in the Singular dashboard

To activate your integration in the Singular dashboard, follow these steps:

1. Go to Attribution Setup > Partner Configuration.
2. Select Add a Partner. Search for and select Unity Ads.
3. Enter your advertiser Game ID in the Unity Ads Game ID field. To copy your Game ID from the Unity Dashboard, refer to the following steps:

Copy your Game ID from the Unity Dashboard

To copy your Game ID from the User Acquisition Dashboard, follow these steps:

1. Go to Apps from the left navigation menu of the dashboard. The provided table lists each of your organization's apps.
2. Scroll or search to locate the desired app.
3. Select Settings () at the end of the app row to open the app details page.
4. Go to the MMP settings section.
5. Select copy () next to Game ID to copy the ID to your clipboard.

Note

Enter your Game ID exactly as shown in the User Acquisition dashboard. Mismatched Game IDs prevent Unity from receiving events correctly.

2

Configure data-sharing settings

To configure data-sharing settings, follow these steps:

1. In the Attribution Postbacks & Settings tab, go to the Attribution Postbacks table.
2. Select the Install checkbox in the Attribution Event column.
3. In the same row, select the following checkboxes:

• Send View Through
• Send All
• Send Fraud Postbacks

3

Map post-install events

Map Singular events based on whether they include revenue. Map events that include Revenue in the Revenue Events Postbacks section, and map events that don't include revenue in the Events Postbacks section:

Event type	Revenue values included	Mapping location
Ad revenue In-app purchase	Yes	Revenue Events Postbacks
Session Milestone completion	No	Events Postbacks

Refer to the following mapping instructions:

Revenue values includedNo revenue values included

To send ad revenue and in-app purchase event data, follow these steps in the Revenue Events Postbacks section of the In-app Events Postback tab:

1. Select your Singular events in the SDK Event Name column and map them to Unity events in the Event Name column as follows:

Event type	Singular SDK Event Name	Unity Event Name	Mapping notes
In-app purchase (IAP)	__iap__ {custom_purchase_event_name}	purchase	You can use either the default purchase name, __iap__, or enter a custom-defined name in the SDK Event Name field for in-app purchase events.
Ad revenue	__ADMON_USER_LEVEL_REVENUE__	ad_revenue	Don't map revenue events to __REVENUE__.

2. To share data from your entire user base, select the Send all checkbox for each event.
3. In the Postback Window Starting Point column, select Unlimited for each event.
4. If you have a Singular Enterprise account, set the Postback Window (days) to Unlimited . Otherwise, set the window to

   30

   days.
5. Select the Include Revenue checkbox for each event.

To send milestone completion and session event data, follow these steps in the Events Postbacks section of the In-app Events Postback tab:

1. Select your Singular events in the SDK Event Name column and map them to Unity events in the Event Name column as follows:

Event type	Singular SDK Event Name	Unity Event Name	Mapping notes
Milestone completion	{custom_milestone_event_name}	level_complete	You can use any custom-defined SDK event name in the SDK Event Name field for milestone completion events.
Session	__SESSION__	session	-

2. To share data from your entire user base, select the Send all checkbox for each event.
3. In the Postback Window Starting Point column, select Unlimited for each event.
4. If you have a Singular Enterprise account, set the Postback Window (days) to Unlimited . Otherwise, set the window to

   30

   days.

Complete the following steps to correctly integrate Tenjin and share data with your User Acquisition campaign:

1

Copy credentials from the Unity Dashboard

You need the following Unity account credentials to complete your Tenjin integration:

Game ID

To retrieve your Game ID from the Apps page of the User Acquisition dashboard, follow these steps:

1. From the dashboard left navigation menu, go to Apps. The provided table lists each of your organization's apps. Following each app name, the dashboard displays the app platform and Game ID.
2. Select the Copy symbol next to the ID to copy it to your clipboard.
3. Optionally, hover over the app name to copy the Campaign Set ID and Store ID as well.

Note

Enter your Game ID exactly as shown in the User Acquisition dashboard. Mismatched Game IDs prevent Unity from receiving events correctly.

Secret Key and Key ID

Note

Only Organization Owners or Organization Managers can create service accounts and secret keys. Refer to User types, roles, and permissions for more information.

To retrieve your Secret key and Key ID from the User Acquisition dashboard, follow these steps:

1

Create or open your service account

To generate API keys, you need a service account. To access your service account, follow these steps:

1. Go to Settings > API management.

2. In the Stats API v2.0 section, select Service account.
3. On the Service accounts page, select your account from the table. If you don't have a service account, select + New to create one.

2

Generate keys

To generate a secret key and key ID, follow these steps:

1. From your service account page, go to the Keys section.
2. Select + Add key to generate a Key ID and Secret key. You can't view previously-generated keys.
3. Select the copy buttons following the Key ID and the Secret key to copy both credentials.

Important

The dashboard displays the Secret key only once. Store the Key ID and Secret key together somewhere secure. If you lose the Secret key, you must create a new key.

3

Assign the organization role

A service account with no role assigned can still authenticate, but every request it makes fails with a

403

error and an Invalid Credentials message. You must assign the Advertise Stats API MMP Viewer role to your service account before you use its credentials.

To assign this role, follow these steps from your service account:

1. In the Organization roles section, select + Manage organization roles.
2. Open the User Acquisition category and select Advertise Stats API MMP Viewer.
3. Select Save.

Organization core ID

To retrieve your Organization core ID from the Settings page of the User Acquisition dashboard, follow these steps:

1. Go to the Organization section of the Settings page.
2. Copy the numeric ID next to Organization core ID.

Note

Ensure that you copy the numeric Organization core ID, not the alphanumeric Organization ID.

2

Activate Unity Ads in the Tenjin dashboard

To integrate Unity with Tenjin, follow these steps in the Tenjin dashboard:

1. Go to the Configure tab and select Channels.
2. Search for Unity Ads in the Marketing Channel Name field.
3. In the New Marketing Channel setup for Unity Ads, enter the Unity account credentials you copied from the Unity dashboard and give your account a name.
4. In the Tenjin navigation menu, go to the Campaigns tab and select Create Campaign.
5. Select Unity Ads from the Marketing Account dropdown.
6. Choose your app from the App dropdown and give your campaign a descriptive Name.
7. When the system prompts you with a Callback to be created message, follow the provided link to continue and generate an attribution link.

3

Configure data-sharing settings

With Tenjin, configuring the data-sharing settings also maps your in-app events. To configure data-sharing settings and map events with Tenjin, do the following as you finish the activation workflow:

1. After you follow the link in the Callback to be created message, select Unity Ads from the Channels and Partners dropdown.
2. In the Channel callbacks section, activate the following toggles:

• Unity Ads ad revenue
• Unity Ads app open
• Unity Ads IAP
• Unity Ads install

Important

Don't map ad revenue events as In-App Purchase events. If your Tenjin account supports ad revenue data-sharing, send this data as a dedicated Ad Revenue Impression event.

If your account doesn't support ad revenue data-sharing, don't send ad revenue as a different event type, as this event mismatching can cause campaign optimization to stop working.

3. For each event callback, select all users from the User filter dropdown.