Skip to main content

Overview

Add query parameters to your Linkrunner subdomain URL to track referrals, campaigns, or custom data. When users click your link and install the app, retrieve these parameters through getAttributionData(). Works for both Android & iOS

Quick Example

Create a link with query parameters:
get.yourdomain.com?referrer=user_123&campaign=summer2024
When the user installs your app, call getAttributionData() to get the full URL and parse the parameters.

Setup

1. Configure Your Subdomain

  1. Go to Linkrunner Settings → Domains
  2. Add your subdomain (e.g., get.yourdomain.com)
  3. Complete domain verification
No need to create campaigns in the dashboard. Just add query parameters to your subdomain URL and they’ll be automatically captured.
Basic referral:
get.yourdomain.com?referrer=user_1
Multiple parameters:
get.yourdomain.com?referrer=user_1&campaign=summer2024&source=instagram
With deep linking:
get.yourdomain.com/product/123?referrer=user_456

Retrieving Data

Call getAttributionData() early in your app lifecycle, then parse the deeplink field to extract your query parameters.
Use android.net.Uri to parse the URL and getQueryParameter() to extract values.See Android Usage Guide →

Common Use Cases

Referral programs: ?referrer=user_12345 Influencer tracking: ?influencer=john_doe&platform=youtube Campaign attribution: ?campaign=summer_sale&source=instagram Promo codes: ?promo=SAVE20&referrer=email_campaign

Testing

  1. Create a test link with query parameters
  2. Uninstall your app completely
  3. Click the link and install from the store
  4. Verify parameters in getAttributionData()
Always uninstall before testing. Attribution data is cached from the first install.

Troubleshooting

No parameters showing up? Verify your subdomain is configured correctly in the dashboard and that the app was installed via your link (not directly from the store). Need help? Contact [email protected]