Merge tags and signed uid
A personal timer gives each subscriber their own countdown — “24 hours from when you open this email”. Your email platform tells tikio who is opening by filling in a merge tag.
Subscriber ID merge tags
Pick Personal timer in Get code and choose your platform: the code comes with the
right tag in uid. The platform replaces it with each subscriber's ID when it sends
the email; the first open starts that subscriber's clock, and reopening shows the same countdown.
https://t.tikio.io/e/<link-id>.gif?uid=*|UNIQID|*| Platform | Subscriber ID tag |
|---|---|
| Mailchimp | *|UNIQID|* |
| Klaviyo | {{ person.id }} |
| HubSpot | {{ contact.hs_object_id }} |
| SendGrid | {{contact_id}} |
| ActiveCampaign | %SUBSCRIBERID% |
| Brevo | {{ contact.ID }} |
| Braze | {{${user_id}}} |
| Unisender | ${user_id} |
| Kit (ConvertKit) | {{ subscriber.id }} |
| Customer.io | {{customer.id}} |
| Iterable | {{userId}} |
| Marketo | {{lead.Id}} |
| Salesforce Marketing Cloud | %%SubscriberKey%% |
| Keap | ~Contact.Id~ |
| Mailjet | [[data:subscriber_id]] |
| beehiiv | {{subscriber_id}} |
| Amazon SES | {{userId}} |
| GetResponse | {{CONTACT `subscriber_id`}} |
We don't know a subscriber ID tag for Constant Contact, Omnisend, AWeber, MailerLite, Campaign Monitor, Drip, Moosend. Their usual tags
hold the email address, and we don't recommend putting that in an image URL. If your account has a
contact ID field, use its merge tag. Without a uid, an evergreen timer restarts on
every open.
A different deadline for each subscriber
If your platform stores a date per contact (a trial end, a renewal date), a link can take its
deadline from that date's merge tag, added to the code as target. It must render as
unix seconds or an ISO date with a time zone. This timer type is set up through the API; the dashboard shows it read-only.
https://t.tikio.io/e/<link-id>.gif?target={{ person.trial_end }}Signed uid
Without signing, anyone who can guess another subscriber's uid can see that person's
countdown. When the timer guards something valuable, like a personal discount or a trial window, a
link can require a signature next to every uid, made on your server with the link's
key. It is set up through the API — see Signed uid in the API reference.
Leave it off when the timer is decoration.