Custom integration attribution links
Review the format and parameters for custom server-to-server integration attribution links
Read time 1 minuteLast updated 2 months ago
To pass engagement and attribution data to Unity using a custom server-to-server integration, use server requests to generate attribution tracking links. Refer to this article for GET requests you can use to send attribution links to Unity.
Send links with postback requests
Use the following HTTP GET requests to send install postbacks to Unity. Refer to the Custom integration postback request reference table to ensure you include the required parameters.iOS
Use the following postback request URL to send iOS postbacks:https://postback.unityads.unity3d.com/games/[game_id]/install?advertisingTrackingId=[YOUR_MACRO_FOR_IDFA]&gamerId=[unity_gamer_id]&attributed=[attributed]
Android
Use the following postback request URL to send Android postbacks:Review the following postback parameters to ensure your Android postback request is formatted correctly:https://postback.unityads.unity3d.com/games/[game_id]/install?advertisingTrackingId=[YOUR_MACRO_FOR_GOOGLE_AD_ID]&gamerId=[GAMER_ID]&attributed=[ATTRIBUTED]
Parameter name | Requirement | Format | Description | Notes |
|---|---|---|---|---|
| Required | String | Your Unity advertiser Game ID. | Ensure that you retrieve your advertiser Game ID from the User Acquisition dashboard. Don't use the publisher Game ID used in SDK integration from the Monetization dashboard. |
| Optional | String | The unique Unity identifier mandatory for attributing users that have Limited Ad Tracking (LAT) on. You can find the | The |
| Optional | Integer ( | A flag indicating whether this install is attributed to Unity and can be charged. | The default value ( |
URL formatting
To ensure your attribution works correctly, ensure you format your links according to the following requirements:- Use HTTPS for the URL and any redirects.
- Include the dynamic custom token. Refer to the Dynamic custom tokens reference to review supported tokens.
{ifa} - Use HTTP 3XX redirect codes. Don't use HTML or JavaScript redirects.
- Don't redirect URLs to the Apple App Store or the Google Play Store.