Deferred Deep Linking

Retrieve a deferred deep link

post

Retrieves information about the deferred deep linking event. This call should be performed when the consumer first opens the app. It provides deep link data but does not log a conversion event.

Authorizations

basicAuth

AuthorizationstringRequired

Use your AccountSID as the username and AuthToken as the password.

Body

application/x-www-form-urlencoded

CampaignIdintegerRequired

Unique identifier for your program.

Example: 1000

ImpactAppIdintegerRequired

The System App Id assigned to your app in impact.com.

Example: 12345

EventDatestring · date-timeRequired

Date and time the app install happened (ISO 8601).

Example: 2026-09-10T22:55:32-08:00

IpAddressstringOptional

Hashed public IPv4 or IPv6 address. Automatically collected if called in-app.

Example: 192.168.1.1

AppleIfastringOptional

Apple Identifier for Advertising (IDFA).

Example: 38400000-8cf0-11bd-b23e-10b96e40000d

GoogAIdstringOptional

Google Advertising Identifier.

Example: 38400000-8cf0-11bd-b23e-10b96e40000d

AppInstallRefstringOptional

Unique Install Referrer retrieved from Google Play Store.

Example: utm_source=affiliate&utm_campaign=summer

AppPackagestringOptional

Unique app ID or bundle ID.

Example: com.acme.app

CustomProfileIdstringOptional

Third party web tracking cookie.

Example: a1b2c3d4e5f6

Responses

200

OK - Returns success attributes even if no match was found.

application/json

landingPagestring · uriOptional

URL of the web page the consumer was redirected to before the app store.

Example: https://www.acme.com/products/tennis-balls

clickIdstringOptional

Unique identifier generated by impact.com for the referring click.

Example: QiiWXOVnrQ3SQHl24jQjyxBGUkmzfJ3i1VHrWM0

clickIpAddressstringOptional

IP Address captured prior to the app store redirect.

Example: 192.168.1.1

connectionIpAddressstringOptional

IP Address captured when the connection to this endpoint is made.

Example: 192.168.1.2

400

Bad Request - Returns an array of errors or warnings.

application/json

post/AppInstall

cURL

curl -L \
  --request POST \
  --url 'https://trkapi.impact.com/AppInstall' \
  --user '{AccountSID}:{AuthToken}' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'Accept: */*'

{
  "landingPage": "https://www.acme.com/products/tennis-balls",
  "clickId": "QiiWXOVnrQ3SQHl24jQjyxBGUkmzfJ3i1VHrWM0",
  "clickIpAddress": "192.168.1.1",
  "connectionIpAddress": "192.168.1.2"
}