Skip to main content

URLs and data

https://dl.aquagen.co.in/d/ABCD1234?utm=whatsapp&data=eyJlbWFpbCI6ImphbmVAZXhhbXBsZS5jb20ifQ
└──────────────────────┘ └┘ └──────┘ └──────────┘ └──────────────────────────────┘
handler prefix link id utm tags data (base64)

Only the link id is required. utm and data are optional extras you add per share.

UTM tags​

  • Comma separated: utm=email,weekly. Up to 10 tags, 50 characters each.
  • They label the visit in Mixpanel (which channel, which campaign).
  • If the URL has utm, those tags replace the link's default tags. They are not added to them. If the URL has no utm, the defaults are used by themselves, so you never need to repeat them.
  • Example: the link's defaults are email. ?utm=whatsapp records just whatsapp, not email, whatsapp. To keep email as well, write ?utm=email,whatsapp.

data (dynamic params)​

data carries values for one person or one send. It is a small JSON object, base64url-encoded:

{"email":"jane@example.com"}   →   eyJlbWFpbCI6ImphbmVAZXhhbXBsZS5jb20ifQ

Rules:

  • Only the names listed under Dynamic params on the link are used. Anything else is ignored. data can never change where a link goes.
  • Values must be text, numbers or true/false. Nested objects are ignored.
  • If a name is saved on the link and sent in data, the data value is used. The saved value is only a fallback for when the URL doesn't provide one.
    • Example: the link saves range = week and allows range. With no data, the app uses week. With data of {"range":"month"}, it uses month.
    • If range is not in Dynamic params, data cannot change it: week always applies. That is how you keep a value fixed.
  • Keep values under 200 characters.

Don't want to encode by hand? Use Customize link on the link's page. Type the values, copy the URL.

All the combinations​

You addWhat happens
nothingOpens what the link was created with, with its default UTM tags
?utm=whatsappSame destination, tagged whatsapp instead of the defaults
?data=…Fills the allowed dynamic params
?utm=email&data=…Both. Typical for emails the backend builds, one per recipient
data with a name that is not allowedThat name is dropped
data with a name that is also saved on the linkThe data value wins

Prefixes​

PrefixSite
dAquaGen
arAquaRecycle
lpLakePulse
rwiRain Water Intelligence
iEmail open pixel (different address, see Email pixel)

Always copy the URL from the link instead of typing it, so the prefix matches the link.