Deferred Deep Linking

Get Deferred Deep Link

post

Retrieves deferred deep linking information after a user has installed and opened the app for the first time. This endpoint only accepts a Content-Type of application/x-www-form-urlencoded.

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 (campaign) in impact.com.

Example: 1000

ImpactAppIdintegerRequired

Your app's "System App Id" in the impact.com platform.

Example: 12345

EventDatestring · date-timeRequired

The date and time the app install occurred (ISO 8601).

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

IpAddressstringOptional

Public IP Address of the device. Automatically collected if the call is made from within the app.

Example: 192.168.1.1

AppleIfastringOptional

Apple's Identifier for Advertising (IFA).

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

GoogAIdstringOptional

Google Advertising Identifier (GAID).

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

AppInstallRefstringOptional

The install referrer value from the Google Play Store.

Example: utm_source=affiliate&utm_campaign=summer

AppPackagestringOptional

The unique app/bundle ID from the respective app store.

Example: com.acme.app

CustomProfileIdstringOptional

Your third-party web tracking cookie/identifier.

Example: a1b2c3d4e5f6

Responses

200

The request was processed successfully. The response contains the deep link information.

application/json

landingPagestring · uriOptional

The URL of the web page the user was on before being deferred to the app store.

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

clickIdstringOptional

The unique identifier generated by impact.com for the referring click.

Example: QiiWXOVnrQ3SQHl24jQjyxBGUkmzfJ3i1VHrWM0

clickIpAddressstringOptional

The IP address captured when the user clicked the tracking link.

Example: 192.168.1.1

connectionIpAddressstringOptional

The IP address captured when the app made this API request.

Example: 192.168.1.2

400

The request was invalid due to missing or malformed parameters. The response contains errors and warnings.

application/json

post/DeferredDeepLink

cURL

curl -L \
  --request POST \
  --url 'https://trkapi.impact.com/DeferredDeepLink' \
  --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"
}