Setting up 1P Domain Tracking

Once you have subscribed to 1P Domain Tracking, you need to configure your domain settings depending on where your website is hosted.

Initial Steps

1. Go to the account for which you’ve subscribed to 1P Domain Tracking.
2. Navigate to Settings → 1P domain tracking and click on + Add domain.

3. Add a Naked Domain by entering the domain name without http://, https://, or www and choose whether your website is a,

• Shopify hosted website
• Non-shopify hosted website

Tip

For example, if your website is https://www.customerlabs.com, enter only customerlabs.com.

4. Click Next.

Depending on your website platform, choose the appropriate setup procedure below.

---

Shopify Hosted Websites

If your website/domain is hosted on the Shopify, follow these steps:

1. After the naked domain is added, the subdomain is auto-populated with other necessary details.

2. Log in to your DNS (Domain Name System) provider, Verify the CNAME and SSL certificates.

Tip

Use the respective DNS providers (like GoDaddy, Namecheap, Route53, etc.) documentation to verify the CNAME and SSL certificates.

3. After the CNAME and SSL Certificate are added to your DNS provider, return to CustomerLabs and click Verify DNS to verify the domain.

4. After successful DNS verification, go back to the home screen.
5. Click on the 1P Domain Tracking Code tab, and click on the Shopify card.

6. Continue with the steps mentioned in the Shopify installation to complete the set up.

Tip

Here is the step-by-step guide to install the CustomerLabs app on your Shopify store: Install CustomerLabs App on Shopify

---

Non-Shopify Websites (Custom-built or other platforms)

If your website/domain is self-hosted, on WordPress, or any platform other than Shopify, follow these steps:

1. After adding the naked domain, choose Non-Shopify.
2. Click Next.

3. Add sub-domain for the CDN for the domain and click Next.

This CDN can be managed in one of two ways:

1. Managed Service – Cloudflare account managed by CustomerLabs (Recommended)
2. Adding your own Cloudflare account

Option A: Managed Service

If you choose to use the Managed Service, you first have to verify that you are the owner of the domain before proceeding with the DNS migration to our Cloudflare network. (Note: Verification must be done within 7 days)

1. After verifying ownership of the domain in your DNS provider, click Verify DNS in CustomerLabs.

2. Once DNS verification is done, you will be prompted to enter an email address to provide access to the Cloudflare account. (Note: You can only choose an admin user’s email address from the drop-down)
3. Click Save.

4. You will be sent an invite from CustomerLabs to access your Cloudflare account (If you don’t receive an email within 24 hours, please contact support@customerlabs.co)
5. After accepting the Cloudflare invite, map the assigned name servers in your domain registrar.

6. Once the name servers are mapped, go back to the 1P Domain Tracking dashboard in CustomerLabs and click Verify now against the domain you recently added.

7. Finally, go to the CustomerLabs home screen, click the 1P Domain Tracking Code tab, and reinstall the tracking script on your website.

Option B: Adding your own Cloudflare Account

Caution

If you are using your own Cloudflare account, you are responsible for managing the pricing and rate limits. If you are on the Free Worker plan, we highly recommend upgrading to a paid plan capable of handling data requests from CustomerLabs to ensure uninterrupted data tracking.

1. Click on the “Add your own Cloudflare” hyperlink during the setup.

2. You will be asked to enter your Cloudflare Account ID and API Token.

Finding your Cloudflare Account ID

1. Log in to your Cloudflare account.
2. Go to Websites → Choose your domain.

3. Click Overview from left sidebar. The Account ID can be found in the right-sidebar (as shown on screenshot below).

4. Copy the Account ID from the right sidebar and paste it into the Cloudflare Account ID field in CustomerLabs.

Generating a Cloudflare API Token

To allow CustomerLabs to manage Workers and DNS records on your Cloudflare zone, generate an API token with the correct permissions:

1. Under the Overview tab, click on “Get your API token” on the right sidebar.

2. Click “Create Token” button.

3. From the list of templates, find “Edit Cloudflare Workers” and click “Use template”.

4. Click ”+ Add more” to add an additional Zone permission.

5. For the Zone permission, set DNS → Edit (required to create DNS records that link the Worker to your domain).

6. Under Account Resources, set Include → select the Cloudflare account you want to link.
7. Under Zone Resources, set Include → Specific Zone → select the domain you are adding.

8. Click “Continue to Summary” to review the permissions.

9. Confirm the summary and click “Create Token”.

10. Copy the generated API token.

Caution

The API token is only shown once. Copy and store it securely before closing the page.

10. Paste the API token into the Cloudflare API Token field in CustomerLabs and click Save. You will be redirected to the 1P Domain Tracking dashboard.

11. After integrating your Cloudflare account, go back to the CustomerLabs home screen.
12. Click the 1P Domain Tracking Code tab, copy the updated tracking code, and reinstall it on your website.

---

Verification

DNS Verification

You can check the “Verified” status in the 1P Domain Tracking dashboard in CustomerLabs to ensure that your DNS records are active and correctly mapped.

Installation Verification

To verify that 1P Domain Tracking is successfully installed and functioning, inspect the cookies set in your browser’s developer tools:

• Before 1P Domain Tracking: The CustomerLabs cookie is set from the default tracking domain — io.v2.customerlabs.co — even for your own domain (e.g., example.com).
• After 1P Domain Tracking: The CustomerLabs cookie will now be set directly from your own domain (e.g., www.example.com), confirming that all data collection is happening first-party.

You can verify this by:

1. Opening your website in Chrome.
2. Opening Website Inspect → Network tab.
3. In the filter search bar, type /cl.
4. Perform the activities and you will be able to see the events in the network tab.
5. Under the headers, the request URL will be in the format of https://<sub-domain>.<your-domain>.com/<tracking-id>/cl instead of https://io.v2.customerlabs.co/cl.

Tip

If the cookie domain still shows io.v2.customerlabs.co after setup, ensure you have reinstalled the 1P Domain Tracking code snippet on your website. The standard tracking code does not use 1P domain tracking.

Note

If there is any downtime in cloudflare, the tracking will happen through standard tracking domain io.v2.customerlabs.co as a fallback.