Skip to content

My app doesn't get the deep link or campaign data after install ​

Find out why getAttributionData returns organic, no deep link or the wrong data after a campaign install, and fix how and when your app reads it.

At a glance: first check the dashboard. If the install is credited to the campaign there, Linkrunner did its part, and the cause is in when or how your app reads the data. The most common one is calling getAttributionData() right after init, before attribution has finished.

Applies to: apps that read the deferred deep link or campaign details with getAttributionData() after a campaign install. For the setup, see Deferred deep linking.

Check these in order ​

1. Is the install credited to the campaign in the dashboard? ​

Check: find the test install under the campaign in App Campaigns.

Fix: if it shows as organic there too, the app isn't the problem. See My paid installs show as organic. If it's credited there, go on.

2. Did you call getAttributionData right after init? ​

Attribution isn't always finished when init returns. A call made immediately can come back with type ORGANIC and no deep link, even though the dashboard later credits the campaign.

Fix: read the data when you need it, for example when onboarding finishes, instead of at app start. If your backend needs the campaign, use the install webhook instead.

3. Is deferred deep linking on for that campaign? ​

Check: when the campaign has no destination, deeplink is the Linkrunner link the user tapped, so your app gets the tracking URL instead of a screen.

Fix: turn on Enable Deferred deeplinking? and enter a Deeplink Destination. See Open a screen in your app. Meta and Google campaigns have no Linkrunner link, so their deep links are set differently. See the notes in Deferred deep linking.

If the user signs up or logs in first, the screen you meant to open is often gone by the time they finish.

Fix: store the deeplink locally when you read it, and navigate to it after onboarding or login. Your app controls this step. Linkrunner only returns the value.

getAttributionData() returns the deep link from the install. A tap on a link when the app is already installed comes through handleDeeplink instead. See My deep link opens the store instead of my app.

You don't need a campaign for each screen or user. Append your parameters to one campaign link and read them from deeplink. See Track the link as a campaign. For referrals, use the referrer parameter, see Set up referral tracking.

7. Does the campaign name break your code? ​

Campaign names can contain characters outside plain ASCII, such as typographic dashes. Putting the raw name into an HTTP header can fail.

Fix: send campaignData.id to your backend instead of the name, or encode the name before you use it.

Attribution is stored from the first install, so a second link on the same device returns the first link's data.

Fix: uninstall the app before each test, and turn on debug mode. See Why is my test credited to the wrong campaign?

Confirm it's fixed ​

  • On a fresh install from the link, getAttributionData() returns type INORGANIC, the campaign name, and the deeplink you set.
  • Your app opens that screen, including after signup or login.
  • See Getting attribution data for the full response (each SDK guide has the same section).

Still stuck? ​

Email support with:

  • Your project name and the campaign link you tested
  • Your SDK and version
  • The getAttributionData() response from your debug logs, and when in your app you call it
  • The test device and the time of the install

Need help? Contact support@linkrunner.io.