FAQ
Below you will find answers to our most commonly asked questions. If you cannot find the answer you are looking for, refer to the community page or Discord channel to explore additional resources.
General
Setting up Zaraz
Zaraz does not appear to be working.
If you are experiencing issues with Zaraz, there could be multiple reasons behind it. First, it’s important to verify that the Zaraz script is loading properly on your website.
To check if the script is loading correctly, follow these steps:
- Open your website in a web browser.
- Open your browser’s Developer Tools.
- In the Console, type
zaraz. - If you see an error message saying
zaraz is not defined, it means that Zaraz failed to load.
If Zaraz is not loading, please verify the following:
- The domain running Zaraz is proxied by Cloudflare.
- Auto Injection is enabled in your Zaraz Settings.
- Your website’s HTML is valid and includes
<head>and</head>tags. - You have at least one enabled tool configured in Zaraz.
I’m seeing some data discrepancies. Is there a way to check what data reaches Zaraz?
Yes. You can use the metrics in Zaraz Monitoring to help you find where in the workflow the problem occurred.
Can I use Zaraz with Rocket Loader?
We recommend disabling Rocket Loader when using Zaraz. While Zaraz can be used together with Rocket Loader, there’s usually no need to use both. Rocket Loader can sometimes delay data from reaching Zaraz, causing issues.
Is Zaraz compatible with Content Security Policies (CSP)?
Yes. To learn more about how Zaraz works to be compatible with CSP configurations, refer to the Cloudflare Zaraz supports CSP blog post.
Does Cloudflare process my HTML, removing existing scripts and then injecting Zaraz?
Cloudflare Zaraz does not remove other third-party scripts from the page. Zaraz can be auto-injected or not, depending on your configuration, but if you have existing scripts that you intend to load with Zaraz, you should remove them.
Does Zaraz work with Cloudflare Page Shield?
Yes. Refer to Page Shield for more information related to this product.
Is there a way to prevent Zaraz from loading on specific pages, like under /wp-admin?
To prevent Zaraz from loading on specific pages, refer to Load Zaraz selectively.
How can I remove my Zaraz configuration?
Resetting your Zaraz configuration will erase all of your configuration settings, including any tools, triggers, and variables you’ve set up. This action will disable Zaraz immediately. If you want to start over with a clean slate, you can always reset your configuration.
- Log in to the Cloudflare dashboard, and select your account and domain.
- Go to Zaraz > Settings > Advanced.
- Click “Reset” and follow the instructions.
Zaraz Web API
Using the zaraz.ecommerce() method returns an undefined error.
E-commerce tracking needs to be enabled in the Zaraz Settings page before you can start using the E-commerce Web API.
How to trigger pageviews manually on a Single Page Application (SPA)?
Zaraz comes with built-in Single Page Application (SPA) support that automatically sends pageview events when navigating through the pages of your SPA. However, if you have advanced use cases, you might want to build your own system to trigger pageviews. In such cases, you can use the internal SPA pageview event by calling zaraz.track("__zarazSPA").
Tools
Google Analytics
After moving from Google Analytics 4 to Zaraz, I can no longer see demographics data. Why?
You probably have enabled Hide Originating IP Address in the Settings option for Google Analytics 4. This tells Zaraz to not send the IP address to Google. To have access to demographics data and anonymize your visitor’s IP, you should use Anonymize Originating IP Address instead.
I see two ways of anonymizing IP address information on the third-party tool Google Analytics: one in Privacy, and one in Additional fields. Which is the correct one?
There is not a correct option, as the two options available in Google Analytics (GA) do different things.
The Hide Originating IP Address option in Tool Settings prevents Zaraz from sending the IP address from a visitor to Google. This means that GA treats Zaraz’s Worker’s IP address as the visitor’s IP address. This is often close in terms of location, but it might not be.
With the Anonymize Originating IP Address available in the Add field option, Cloudflare sends the visitor’s IP address to Google as is, and passes the aip parameter to GA. This asks GA to anonymize the data.
I set up Event Reporting (enhanced measurements) for Google Analytics, but it only reports Page View, Session Start, and First Visit. All other events, such as scroll and outbound, are missing.
This is not a bug. Zaraz does not offer all the automatic events the normal GA4 JavaScript snippets offer out of the box. You will need to build triggers and actions to capture those events. Refer to Get started to learn more about how Zaraz works.
Can I set up custom dimensions for Google Analytics with Zaraz?
Yes. Refer to Additional fields to learn how to send additional data to tools.
Facebook Pixel
I am trying to set up Facebook Pixel on my Zaraz account, but I do not see any data coming through.
It can take between 15 minutes to several hours for data to appear on Facebook’s interface, due the way Facebook Pixel works. You can also use debug mode to confirm that data is being properly sent from your Zaraz account.
Custom HTML
Can I use Google Tag Manager together with Zaraz?
You can load Google Tag Manager using Zaraz, but it is not recommended. Tools configured inside Google Tag Manager cannot be optimized by Zaraz, and cannot be restricted by the Zaraz privacy controls. In addition, Google Tag Manager could slow down your website because it requires additional JavaScript, and its rules are evaluated client-side. If you are currently using Google Tag Manager, we recommend replacing it with Zaraz by configuring your tags directly as Zaraz tools.
Why should I prefer a native tool integration instead of an HTML snippet?
Adding a tool to your website via a native Zaraz integration is always better than using an HTML snippet. HTML snippets usually depends on additional client-side requests, and require client-side code execution, which can slow down your website. They are often a security risk, as they can be hacked. Moreover, it can be very difficult to control their affect on the privacy of your visitors. Tools included in the Zaraz library are not suffering from these issues - they are fast, executed at the edge, and be controlled and restricted because they are sandboxed.
How can I set my Custom HTML to be injected just once in my Single Page App (SPA) website?
If you have enabled “Single Page Application support” in Zaraz Settings, your Custom HTML code may be unnecessarily injected every time a new SPA page is loaded. This can result in duplicates. To avoid this, go to your Custom HTML action and select the “Add Field” option. Then, add the “Ignore SPA” field and enable the toggle switch. Doing so will prevent your code from firing on every SPA pageview and ensure that it is injected only once.
Other tools
I cannot find the tool I need on Zaraz.
The Zaraz engineering team is adding support to new tools all the time. You can also refer to the community space to ask for new integrations.
I cannot get a tool to load when the website is loaded. Do I have to add code to my website?
If you proxy your domain through Cloudflare, you do not need to add any code to your website. By default, Zaraz includes an automated Pageview trigger. Some tools, like Google Analytics, automatically add a Pageview action that uses this trigger. With other tools, you will need to add it manually. Refer to Get started for more information.
I am a vendor. How can I integrate my tool with Zaraz?
The Zaraz team is working with third-party vendors to build their own Zaraz integrations using the Zaraz SDK. To request a new tool integration, or to collaborate on our SDK, contact us at zaraz@cloudflare.com.
Pricing
How is Zaraz pricing structured?
Zaraz pricing is based on two main components: Zaraz Loads and the set of features available in each plan. Please visit our pricing page for more information.
What features are included for free, and what features are part of the Workers Paid plan?
The Zaraz Free plan includes a range of features at no cost, while the Workers Paid plan provides additional advanced features. For a comprehensive list of features included in each plan, please visit our pricing page.
What is a Zaraz Load?
A Zaraz Load is counted each time a web page loads the Zaraz script within it. For single page applications, each URL navigation (i.e., every time the URL changes) is counted as a new Zaraz Load. Zaraz Loads are relevant for determining the usage within the Free and Paid plans.
What happens if I exceed my Zaraz Loads limit under the Free plan?
If your website exceeds the Zaraz Loads limit under the Free plan, Zaraz will be disabled for the remainder of the month.
How can I monitor my Zaraz Loads usage?
The Monitoring page in the dashboard provides insight into the number of Zaraz Loads generated by your website during a specific time period. To monitor your Zaraz Loads usage:
- From the Cloudflare dashboard, select the zone you want to monitor.
- From the navigation menu, select Zaraz > Monitoring.
How can I upgrade from the Free plan to the Workers Paid plan?
To upgrade from the Free plan to the Workers Paid plan, you can visit the Zaraz Plans page on the Cloudflare dashboard. From there, you can choose the Workers Paid plan and follow the prompts to complete the upgrade process. If you encounter any issues or have further questions, please reach out to our support team for assistance.
I was using Zaraz during its beta phase. How does the transition to general availability affect me?
If you were using Zaraz under the free beta, you have a period of two months to adjust and decide how you want to go about this change. Nothing will change until the end of the grace period. In the meantime, we advise you to take the following steps:
- Get more clarity on your Zaraz Loads usage: Visit the Zaraz Monitoring dashboard to check how many Zaraz Loads you had in the previous couple of months. If you are concerned about generating more than 100,000 Zaraz Loads per month, you might want to consider upgrading to the Workers Paid plan via the plans page to avoid any service interruption. If your website generates a significant number of Zaraz Loads, you may also want to reach out to your sales representative to discuss volume discounts. You can contact the Zaraz team for additional support.
- Check if you are using any paid features: Refer to the plans page to see the list of paid features. If you are using any of these features, you would need to upgrade to the Workers Paid plan, starting at $5/month, via the Zaraz Plans section in the dashboard. It’s important to note that these paid features will cease to work after the end of the grace period unless you upgrade.
Please note that as of now, free plan users do not have access to any paid features. However, if you’re already using a paid feature without a Workers Paid plan, you can continue to use it until the end of the grace period. After that, you’ll need to upgrade to keep using any paid features.