Custom integration postback request reference
Review the following parameters when you send postbacks from your app’s server using a custom integration to ensure your request is formatted correctly.
The following identification parameters must be relayed in your custom integration postback request:
| Parameter | Description | Example | Notes |
|---|---|---|---|
advertisingTrackingId (iOS) | The Identifier for Advertising (IDFA) in uppercase form. | 1A2B3C4D-5E6F-7G8H-9I10-J9K8L7M65N4P | The IDFA is compulsory for all installs. You can use the raw or hashed form of the ID. |
advertisingTrackingIdMD5 (iOS) | The Identifier for Advertising (IDFA) in hashed, lowercase form. | fce1e02f2ca0498021ec67f2f22dfcea | The IDFA is compulsory for all installs. You can use the raw or hashed form of the ID. |
advertisingTrackingId (Android) | The Google Advertising ID in lowercase form. | a1b2-c3d4-e5f6-g7h8 | The Advertising ID is compulsory for all installs. You can use the raw or hashed form of the ID. |
advertisingTrackingIdMD5 (Android) | The Google Advertising ID in MD5 hashed, lowercase form. | 6fbff11856d5f0200d473af3cabd346d | The Advertising ID is compulsory for all installs. You can use the raw or hashed form of the ID. |
gamerId | The unique Unity Ads identifier that is mandatory for attributing users that have Limited Ad Tracking (LAT) on. | 00000000-0000-0000-0000-000000000000 | The value of the gamer_id parameter should be taken from starts, views, or clicks sent for attribution.If the gamerID is not formatted correctly, a malformed error will appear, with response code 400: Malformed or missing input data. |
installTimeEpoch | Install time in seconds since epoch. | 1615973128 | This parameter is mandatory for some campaign types. |
rawAndroidId | The Android ID in its original lowercase form. | 3f4a92b6c1d8e90f | The rawAndroidID parameter isn’t recommended because it’s not required if the Android device has correctly integrated Google Play Services and has Google Play installed. It is, however, compulsory for all Android installs that don't have a Google Advertising ID. |
androidId | The Android ID in MD5 hashed form. | 4a969d593d2a3e1d602fefe8e75a4d80 | This isn’t recommended because it’s not required if the Android device has correctly integrated Google Play Services and has Google Play installed. It is, however, compulsory for all Android installs that don't have a Google Advertising ID. |
attributed | A flag indicating whether this install is attributed to Unity Ads and can be charged. |
| The default value (attributed=1) indicates that the condition is true. If the condition is false (attributed=0), the install is unattributed and won't be charged.Only use this parameter if you send event data for all installs, as opposed to only sending installs attributed to Unity. |