Search specific term/phrase surrounded by double quotes. e.g. “deep linking”
Exclude records that contain a specific term prefixed with a minus. e.g. Android -Firebase

Troubleshooting Link Formatting Errors

Overview

During testing, you may run into issues with your Branch link not being properly formatted or missing information required for accurate routing and attribution.
Below you will find possible causes for your test link to not work and how to fix the issue.

AAID or IDFA is not correctly formatted

Cause

Attribution will not occur because the device ID on the link must be in an acceptable IDFA or AAID format, or removed altogether. A common cause for this error is leaving link macros on the link that have not been filled in.

Fix

Please ensure you are using a real device ID. If you are testing, please use a correctly formatted dummy ID. If you don't have a device ID and this link is not server to server, you can remove the device ID macro all together and retest.

S2S & no device ID present

Cause

Server to server clicks must-have device IDs for attribution. Point in time modeling is not supported for server to server clicks.

Fix

Please use a device ID macro like $idfa or $aaid.

S2S & both $idfa AND $aaid

The error could also be: ($idfa_sha1 AND $aaid_sha1) or ($idfa_md5 AND $aaid_md5)).

Cause

Server to server clicks cannot have device IDs for both IDFA and AAID. Because S2S clicks do not have user agents, Branch uses the presence of a device ID to set the operating system.

Fix

Remove one of the device ID macros (e.g. $idfa, $aaid, $idfa_sha1, $aaid_md5) that are present on this link so there is only one macro present.