Skip to content
Esc
↑↓navigate↵open⌘Jpreview
On this page

Tracking

Count opens and clicks, add UTM parameters, and serve tracked links from your own domain.

BillionSend can record when a recipient opens an email or clicks a link in it. Tracking is set per domain and is off by default: with it off, your links and HTML are sent untouched.

Turn it on

In the dashboard, open the domain and go to its Links tab:

  • Track clicks rewrites each link so it goes through the tracking host, which records the click and sends the recipient on to your original URL. The event is email.clicked.
  • Track opens adds a 1×1 transparent image to the HTML. When it loads, the event is email.opened.
  • Rewrite links in plain-text part also tracks the links in the plain-text version. It needs click tracking.

Through the API, use click_tracking and open_tracking on the domain:

curl -X PATCH https://api.billionsend.com/domains/$DOMAIN_ID \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "click_tracking": true, "open_tracking": true }'

Notes:

  • Only http and https links are tracked. mailto: and tel: links, and the unsubscribe link, are left alone.
  • Each event shows on the email’s timeline and can be sent to a webhook.
  • Mail sent from a people inbox is never tracked.

UTM parameters

Set utm_source, utm_medium and utm_campaign in the Links tab, and BillionSend adds them to every tracked link that does not already have them. In a value, {{broadcast_name}} stands for the broadcast’s name. On a transactional email, which has no broadcast, a value that uses it is left out. UTM parameters apply to tracked links, so click tracking must be on.

How reliable are opens

An open is a hint, not an exact count.

  • Prefetches are not opens. Apple Mail downloads every image in the background, Gmail can load images while the inbox is open, and security scanners fetch images within seconds of delivery. These are recorded as prefetched. They show on the timeline and on their own line under the open rate, but they never count as an open and never send email.opened. A webhook can opt in to email.prefetched.
  • A click counts as an open. If someone clicks a link, they must have seen the email. When a click arrives with no open yet, BillionSend records the open as well. For recipients on Apple Mail, this is often the only open you will see.
  • Machine clicks are not clicks. Scanners follow every link in a message right after delivery. BillionSend recognizes them and does not count them.
  • Opens are under-counted when the recipient blocks images, when the email has no HTML part, or when Gmail clips a message over about 102 KB.

Clicks are the more reliable signal. For purely transactional mail, such as receipts and password resets, consider leaving open tracking off.

Tracking host

Tracked links and the open image are served from a tracking host:

  • Shared host. The default is t.billiondns.com, shared by all teams. It is available on every plan, and it is the only option on Free.
  • Your own subdomain. Serve them from links.example.com or any name on your domain. Links then match your sending domain, which helps trust. It needs a paid plan.

Set up your own subdomain

  1. In the domain’s Links tab, enter a label such as links. With the API, send tracking_subdomain on POST /domains or PATCH /domains/{id}. An empty string clears it.
  2. Add the CNAME the DNS tab shows: links.example.com pointing at cname.billiondns.com. On Cloudflare, keep it DNS only (grey cloud), otherwise it cannot be verified.
  3. Wait a few minutes. The HTTPS certificate is issued automatically once the CNAME resolves. If your domain has CAA records, they must allow Let’s Encrypt and Google Trust Services.

The subdomain goes from Pending to Active (tracking_status on the domain). Until then, links use the shared host, and the domain shows as Partial: verified for sending, own host not yet live. If it does not activate within 72 hours, it shows Failed with the reason in tracking_error. Fix the CNAME and press Try again, or send the same label again.

Good to know:

  • The label cannot be the same as the domain’s return-path subdomain.
  • Ad blockers block tracking host names. Use a different label for the unsubscribe subdomain, so an unsubscribe link is not blocked with them. The same label works too, and then one CNAME serves both.
  • Your host serves only your domain’s links. If you change the subdomain or delete the domain, links already sent through the old host stop working.
  • Free teams cannot set a new own subdomain: it answers 403 plan_limit_reached. A subdomain you already set keeps working after a downgrade.

Mail on your own tracking host also scores better in Deliverability Insights.

Plans

Free Starter, Pro and Scale
Open and click tracking Yes Yes
UTM parameters Yes Yes
Tracking host Shared host only Shared host, or your own subdomain

Was this page helpful?