How to set up your subdomain in Cloudflare for Onetagger

Edited 5 days ago

Using your own subdomain with Onetagger is a smart move: it improves tracking reliability, helps avoid ad blockers, and ensures your data flows through your own branded domain.

This guide explains step by step how to create the necessary DNS record in Cloudflare.

Preparation: Choose your subdomain

First, decide on the subdomain you want to use — for example:

track.mywebsite.be

When setting up your container in Onetagger, select Use custom subdomain, and enter this subdomain. After entering it, you will see the required DNS configuration details (e.g., the IP address or target hostname) that you need to set up in Cloudflare.


Step 1️⃣ Log in to Cloudflare

  • Go to Cloudflare and log in to your account.

  • Select the domain you want to use (e.g., mywebsite.be) from your list of sites.


Step 2️⃣ Add a new DNS record

  • In the top navigation menu, click DNS.

  • Click Add record.

Enter the following details:

  • Type: A (or CNAME if instructed by Onetagger)

  • Name: Enter your subdomain prefix (e.g., track) — Cloudflare automatically appends your main domain, so track becomes track.mywebsite.be.

  • IPv4 address: Enter the IP address provided by Onetagger (if using an A record).

  • Proxy status: Set to DNS only (gray cloud icon), not proxied. This ensures correct verification and avoids interference with SSL setup.

Important:
✅ Always set Proxy status to "DNS only" during initial setup. Once everything is validated and working, you may consider enabling proxying if explicitly supported by Onetagger.

  • Click Save.


Step 3️⃣ Wait for DNS propagation

DNS changes can take anywhere from a few minutes to 24 hours to propagate globally. You can check the status using a tool like WhatsMyDNS.


Step 4️⃣ Verify in Onetagger

  • Go back to your Onetagger dashboard.

  • Click Verify (or Validate) next to your custom domain setup.

  • On success, you’ll see a confirmation message.


Step 5️⃣ Check the health endpoint

Open your browser and visit:

https://track.mywebsite.be/healthz

You should see:

  • HTTP status code: 200 OK

  • Response text: ok

If you don’t see this, double-check your DNS record, make sure there are no conflicting entries, and verify that your Proxy status is set to "DNS only".


Troubleshooting tips

  • Clear your browser cache or try incognito mode if you still see old content.

  • Flush your local DNS cache if needed.

  • Check that there are no old or conflicting DNS records for the same subdomain.

  • Make sure the record is not set to "Proxied" during setup, as this may block proper verification.


✅ You’re all set!

Once everything is verified, your subdomain is ready for server-side tracking with Onetagger.

Was this article helpful?