Branch tracking link format
The parameters Branch documents for partner click links, checked 25 Oct 2026.
Branch partner links start from https://{app}.app.link/{alias}; the click ID goes in ~click_id, sub-IDs in ~secondary_publisher. Copy the example below or build your own in the generator.
https://example.app.link/summer-campaign?%243p=a_partner&~click_id={click_id}&~secondary_publisher={sub_publisher_id}&~campaign={campaign_name}&~ad_set_name={adset_name}&~creative_name={creative_name}&%24aaid={gaid}
| Parameter | Role | Note |
|---|
Runs entirely in your browser. It builds and checks the link; it does not fire a click or test delivery. Always run a test click before sending traffic.
Parameters
| Parameter | Role | What it carries |
|---|---|---|
$3p | Partner ID | Ad partner ($3p) (required). Designates the ad partner. Set by Branch for your integration. |
~click_id | Click ID | Click ID (required) |
~secondary_publisher | Sub-ID / passthrough | Secondary publisher. Passed by the ad network. |
~campaign | Campaign | Campaign |
~ad_set_name | Ad set | Ad set name |
~creative_name | Creative | Creative name |
$aaid | Device ID | GAID (Android, $aaid). Send only one OS-specific ID per link. |
$idfa | Device ID | IDFA (iOS, $idfa). For iOS links, fill this and leave $aaid empty. |
Rules and gotchas
- Prefixes mean something: $ is Branch reserved, ~ is analytics, + is added by Branch.
- Unfilled macros with braces can break the link in some browsers, so test with real values.
- Keys such as data, password and auth are dropped if appended.
- Impression links use https://impression.link/impression.
Questions
What is the click ID parameter for Branch?
Branch partner links carry the click ID in ~click_id. The MMP returns that value in postbacks so the partner can match each conversion to its click.
Where do sub-publisher IDs go on a Branch link?
Branch documents ~secondary_publisher for sub-IDs and passthrough values. Pass each sub-publisher's ID through your platform's macro instead of creating a separate link per sub-publisher.
What is a tracking link?
A tracking link is the URL an ad network or affiliate sends a user through before the app store, so the advertiser's MMP can record the click and match it to the install. It carries the campaign, the partner's click ID and optional sub-IDs.
What is a click ID?
A click ID is a unique value the partner generates for every click and passes on the tracking link. The MMP returns it in the postback, so the partner can match each conversion back to the exact click it paid for.
Does this generator send anything to a server?
No. The generator runs entirely in your browser. It builds and checks the link locally and never fires a click or contacts any MMP.
Why does my final link still show {click_id}?
Your platform did not replace its macro before redirecting the user. MMPs store an unreplaced macro as plain text, so the conversion cannot be matched to your click. Check the macro syntax your platform expects.