Custom integration postback request reference

Read time 3 minutes

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:

ParameterDescriptionExampleNotes

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.
  • attributed=1
  • attributed=0

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.