Deferred Deep Linking

Get Deferred Deep Link Information

post

Retrieves information about the deferred deep linking event after an app install has occurred. This call is performed when the user first opens the app.

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

Unique ID assigned by impact.com to your app (System App ID).

Example: 12345

EventDatestring · date-timeRequired

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

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

IpAddressstringOptional

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

Example: 192.168.1.1

AppleIfastringOptional

Apple's Identifier for Advertising (IDFA). Recommended for iOS.

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

GoogAIdstringOptional

Google Advertising Identifier. Recommended for Android.

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

AppInstallRefstringOptional

Install Referrer from the Google Play Store. Recommended for Android.

Example: utm_source=affiliate&utm_campaign=summer

AppPackagestringOptional

Bundle ID or package name of the app (e.g., 'com.android.chrome' or '535886823').

Example: com.acme.app

CustomProfileIdstringOptional

Third-party web tracking cookie or anonymous user ID.

Example: a1b2c3d4e5f6

Responses

200

The request was processed successfully. The response will contain deep link information if a match was found.

application/json

Contains the deep link information if a match is found, along with connection details.

landingPagestring · uriOptional

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

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

clickIdstringOptional

The unique impact.com click identifier.

Example: QiiWXOVnrQ3SQHl24jQjyxBGUkmzfJ3i1VHrWM0

clickIpAddressstringOptional

IP Address captured at the time of the click.

Example: 192.168.1.1

connectionIpAddressstringOptional

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

Example: 192.168.1.2

400

The request was invalid due to missing or malformed parameters. The response will contain an errors object.

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"
}