Post-install event data
Unity Ads User Acquisition campaigns that are optimized for acquiring particular kinds of users, such as Retention, Return on Ad Spend (ROAS), and Event campaigns, require information about how users engage with your app after installing it. Post-install event data informs Unity’s models to more accurately show ads to your campaign’s target audience.
When you integrate with an MMP, you can enable your preferred partner to pass post-install event data to Unity. Each type of optimized campaign requires at least one type of post-install event data. However, you can pass data from all event types to any of your campaigns. The recommended best practice is to pass data for all post-install events because the additional data can improve your campaign performance.
Integrated partners can pass the following types of post-install event data:
| Post-install event | Description | Required campaigns |
|---|---|---|
| Session | Your users’ unique visits to your app | Retention |
| Purchase | Purchases users make in your app | |
| Ad revenue | Revenue from ads that your users watch in your app | |
| Level Complete | A specific milestone or completion event your users reach in your app |
Supported post-install events
Most MMPs support passing post-install event data, usually through server postback URLs. To run optimized ad campaigns, use your preferred MMP’s dashboard to set up post-install event passing.
Note: Sharing some event data types might require additional subscriptions with your preferred MMP. Refer to the individual Partner integration guides in this documentation for information about your partner’s requirements.
Refer to the following tables for which event types each of these common integrated partners support:
| MMP | Session | Purchase | Ad revenue | Level Complete |
|---|---|---|---|---|
| AppsFlyer | Yes | Yes | Yes | Yes |
| Adjust | Yes | Yes | Yes | Yes |
| Singular | Yes | Yes | Yes | Yes |
| Tenjin | Yes | Yes | Yes | No |
| branch | Yes | Yes | No | No |
| Kochava | Yes | Yes | No | No |
Important: Ensure that you carefully follow your attribution partner’s integration instructions. Incorrect integrations will result in loss of event data because your servers can’t retroactively send data from events.
Passing data with a custom integration
If you want to integrate directly with your app’s server instead of working with an MMP, you can use a custom server-to-server integration to send engagement and post-install event data. However, custom integrations are more prone to errors and Unity might not be able to support or troubleshoot potential issues encountered with this approach.
Refer to Send attribution links with a custom integration for example postback requests for custom integrations.