Integration best practices
Configure your integration correctly to ensure that you share the required data with your campaign.
Read time 4 minutesLast updated 16 hours ago
When you integrate your preferred Mobile Measurement Partner (MMP) with your Unity Ads User Acquisition campaign, ensure that you configure your integration correctly. You must follow these best practices to ensure your campaign receives the necessary data. Failing to send the correct data can negatively impact your campaign performance. Use these best practices as you complete your integration set up to ensure you configure your data-sharing settings correctly:
Share install data from all sources
When you share install data with Unity, ensure that you include data from your entire user base, including attributed, unattributed, and organic installs. Refer to the Introduction to Attribution for definitions of each attribution type. Each MMP has unique terminology for this setting. Refer to the following examples of how to share data from all sources in supported MMP dashboards:Use these steps to share data from all sources in the Adjust dashboard:
- Go to the Campaign Lab tab > Partners page.
- From the What sources of data do you want to share options, select Data from all attribution sources.
Map post-install events correctly
When you share post-install event data with your campaign, ensure that you correctly map the post-install events. Correct mapping means that you align the Unity Ads event name with the correct MMP event name.Warning
If you use any MMP other than Singular, don't combine ad revenue events with in-app purchase (IAP) events.If your MMP account supports ad revenue data-sharing, send this data as a dedicated ad revenue event. Sending ad revenue as a different event type can cause campaign optimization to stop working.Refer to the partner-specific Integration guides for detailed mapping instructions.
Map your post-install events in the Map events to share with Unity Ads section of the Adjust integration as follows:
Important
If your Adjust account supports ad revenue data-sharing, send this data as a dedicated event.Otherwise, don't send ad revenue events. Mapping ad revenue events as other event types, such as , can cause campaign optimization to stop working.
ad_revenuepurchaseEvent type | Unity Ads | Adjust |
|---|---|---|
| In-app purchase (IAP) | | |
| Milestone completion | | |
| Session | | |
Share both values and revenue for purchase and revenue events
When you share Purchase or Ad revenue event data with Unity, ensure that you share both values and revenue for each event. Sharing this complete data improves Unity's User Acquisition models and can improve campaign performance. Your MMP might use different terminology for these settings. Refer to the following examples:To share both values and revenue with your post-install events, follow these steps in the AppsFlyer dashboard:
- Go to the Integration tab > In-app event postbacks section.
- From the including dropdown for each event, select Values & revenue.
Set postback windows to lifetime
If your MMP supports lifetime postback windows, always set the window to lifetime. Otherwise, set your postback window to the maximum length. Setting your postback window to lifetime allows your campaign to learn from your app's entire install history and can improve campaign performance. Your MMP might use different terminology for the postback window settings. Refer to the following examples:To set lifetime postback windows with AppsFlyer, do the folllowing in your integration setup:In the In-app event settings section, set the In-app event postback window to lifetime.