AdPix Blog

AdPix install guide: add the tag, verify data and read your first reports

AdPix install in four steps: copy the tag from Data streams, paste it or fire it in GTM, confirm data with Test installation, then set key events and reports.

Updated 11 min read

Key takeaways

  • An AdPix install has four steps: create the account and website, copy the tag from Admin, Data streams, View tag instructions, paste it high in the head of every template or fire it from Google Tag Manager, then confirm data with Test installation.
  • Install the tag through exactly one path. A copy in the site template plus a copy in Google Tag Manager loads the script twice and inflates page views.
  • Realtime is the quickest check and Test installation is the definitive one: the data stream counts as verified once an event from its domain arrived in the last 30 minutes.
  • Sign-up defines no key events, so conversion columns read zero until you add an objective or mark events under Admin, Key events. Change the website time zone on day one if you are not in Iran.
  • Five reports cover the first week on every plan, Free included: Home, Realtime, Traffic acquisition, Funnel and Path.

An AdPix install takes four steps: create your account and first website, copy the tag from Admin, Data streams, View tag instructions, paste it as high in the <head> of every page template as you can (or fire it from Google Tag Manager), then confirm with Realtime and Test installation that events are arriving. AdPix states that setup takes under five minutes. What decides whether your first month of data is usable is the hour after the install: key events, the website time zone, your office IP and a single install path.

AdPix tag is the short JavaScript snippet that loads the AdPix tracker, starts it with your data stream’s tag ID (a value beginning with AP-) and then sends page views and the events you define to the AdPix collector in small batches.

How do you install AdPix, step by step?

You install AdPix by creating a website in the console and placing its data stream’s tag on every page of the site. The sign-up flow walks you through it, and each step below links to the AdPix doc page it comes from.

  1. Create the account. Open the sign-up page (the Sign up free buttons on adpix.io lead there), enter a work email and a password, and type the 6-digit code from the verification email. AdPix creates your organization and first account for you.
  2. Add your first website. Enter the site’s address without https:// and select Add website. This creates the website and one data stream for that domain. Enter the domain the tag will really run on, because the field’s hint says traffic to other hosts is ignored.
  3. Install the tag. The Install the tag card shows the snippet with a Copy button. If a developer or agency builds your site, Send these instructions to a teammate emails it to them.
  4. Check the install. Select Check installation. When the first hit arrives, or the tag is found in your page source, you see “Tag verified.” and can open Realtime.

The free plan needs no card and has no time limit, so the whole install can happen before anyone discusses budget. If installing the tag is not today’s job, Go to dashboard finishes setup without it, and the snippet waits under Data streams.

Where do you find the AdPix tracking code?

The tracking code lives with the data stream, not the account: open Admin, then Data streams under the Website column, pick your data stream and click View tag instructions. Copy the whole block under Install manually, the one marked Recommended. The data stream’s Tag ID is printed right below it.

AdPix’s docs are blunt about one rule: never copy the snippet from an article, a ticket or another site. The console stamps the current tag version onto it, and a snippet copied from anywhere else almost always differs in some small way. The block has three parts you never edit:

Part Example What it does
id AP-XXXXXXXXXX The data stream’s tag ID, your site’s identity
v 4 The tag version, used as a cache key when the tracker changes
endpoint https://collect.adpix.net Where events go; your own domain if the first-party Tag-Gateway is on

The tag counts page views on its own. Its init call sends the first page_view and handles route changes in single-page apps, so adding a manual page command next to it would count every page twice. Custom events (ap('track', …)) and linking a visitor to a signed-in user (ap('identify', …)) are optional and can wait until the basics work; when you add them, the event tracking guide covers naming, parameters and testing in the Debug view.

Before you paste anything, check the website defaults. A new website starts with the Asia/Tehran time zone, the rial (IRR) as currency and a 360-day attribution window. If your business is not in Iran, change the time zone under Admin, Website details on day one: it defines where “today” and every hourly bucket begin, and changing it later re-buckets your history so daily numbers appear to shift.

Should you paste the tag or use Google Tag Manager?

Both work. Paste the snippet into the site template when you control the code, because it then really runs at the top of the page. Use Google Tag Manager when marketing owns tags and developers are busy. The one thing that never works is both at once.

Site template Google Tag Manager
Where the tag runs As high in <head> as you place it When the container loads and the trigger fires
Who can do it Whoever edits the theme or layout Whoever has publish rights on the container
Typical trap A template that was missed (checkout, client area) A hard-coded copy still sitting in the template
Check before going live View source on each template Preview mode, then Publish

AdPix’s site also describes installing by importing a GTM container. The manual route below works in any existing container and uses only standard Tag Manager steps:

  1. In Tag Manager, click Tags, New, then Tag Configuration, and choose Custom HTML. Google’s help notes that JavaScript must sit inside <script></script> tags; the AdPix block already does.
  2. Paste the block from View tag instructions unchanged.
  3. Set a trigger that fires on every page. AdPix’s FAQ names the All Pages trigger. Tag Manager’s own Initialization - All Pages trigger fires before other page-view triggers, which suits a tag that should run early. If a consent tool sets consent state, Google reserves the Consent Initialization trigger for it.
  4. Click Preview to open Tag Assistant and confirm the tag fires on your key pages, including the thank-you page.
  5. Click Submit, choose Publish and Create Version, and name the version.

The trade-off is timing. A tag fired from a container usually starts later than one hard-coded at the top of <head>, and AdPix’s docs say the later the tag runs, the more quick-exit visitors you lose.

How do you check that AdPix is receiving data?

Open your site with an empty cache (Ctrl + Shift + R on Windows and Linux, Cmd + Shift + R on macOS), then open Realtime in the console. Your own visit should appear within seconds. For the definitive answer, run Test installation from the same View tag instructions drawer.

Test installation checks three separate signals:

Signal What it measures Weight
Data heartbeat Did an event arrive from this data stream’s domain in the last 30 minutes? Definitive
Snippet in page Is the tag in the source of your home page? Advisory
Proxy health Tag-Gateway only: does your metrics subdomain answer? Advisory, but the root cause if red

Once the heartbeat is green, the data stream is stored as verified and you do not need to test again. Two things about Realtime save time: its window comes from the 5, 30 and 60 minute chips rather than the date picker, and it counts unique users, so ten pages opened by you still show one active user.

Why is AdPix not receiving data after install?

Usually one of seven causes, and AdPix’s troubleshooting page lists them from most to least likely. Work down the list and stop at the first match.

  1. The snippet is not on the published page. Search the live page source for your AP- ID. A missed template or a stale server or CDN cache are the usual reasons.
  2. The tag ID is wrong. This is the quietest failure: the collector still answers 200, so developer tools look fine, but the events never reach your website. Compare the ID character by character, watching for a staging ID or a stray space copied from an email.
  3. The data stream’s domain does not match. If the tag runs on another domain, Realtime shows visits while Test installation keeps waiting. Fix the domain or add it in the data stream’s cross-domain settings.
  4. Consent is closed. With the consent module in opt-in mode, nothing is sent until the visitor accepts statistics. The symptom is no /collect request and no __sov_* cookie. Our guide to cookie consent and your analytics numbers covers what this does to your totals.
  5. Your IP is excluded. Requests matching Excluded CIDRs under Admin, Website details are dropped before storage, so they never appear in Realtime either. On a VPN, your public IP may not be the one you expect.
  6. An opt-out cookie or ad blocker. A __sov_x cookie set to 1 stops your browser only. Try a private window with no extensions.
  7. You tested with curl or a headless browser. Those requests go missing by design. Test in a real browser.

What should you set up in the first hour?

Three settings decide whether week-one reports mean anything: key events, traffic filtering and the time zone. None of them is done for you at sign-up.

  • Key events. Sign-up defines none, so every conversion column reads zero. Add an objective under Admin, Website details, Objectives, or mark your sign-up, lead or purchase events under Admin, Key events. Our event and conversion tracking plan in the website tracking guide helps you decide which ones matter. Before you mark anything, ask the question from the conversion tracking guide: if this number doubled tomorrow, would revenue follow? If not, it is an engagement event, and marking it only inflates the conversion column. If buyers pay on a gateway and do not always return to your thank-you page, plan to send the purchase from your server later; the server-side tracking guide covers AdPix’s server-to-server path and what it does and does not count.
  • Office traffic. Add your office or agency IP ranges to Excluded CIDRs. Be precise: excluded requests are discarded, not hidden, and one broad range can drop real customers on the same carrier. Office visits are only one source of noise; bots and invalid ad clicks are covered in the bot traffic detection guide.
  • Campaign tags. AdPix reads channel, source, medium and UTM campaigns in every plan. Tag paid and social links before they go out, with a UTM naming convention your team will follow.
UTM link builderTag campaign links so every click is credited to the right channel.Try it free

This is also the moment to switch on AdPix’s built-in consent banner if your visitors need one; it is included on every plan, Free included. How AdPix cookie consent works covers opt-in versus opt-out, the setup steps and the accept-and-reject test to run before you publish.

Which reports should you open first?

Home, Realtime, Traffic acquisition, Funnel and Path cover the first week, and all five are available on every AdPix plan, including Free. Open them in that order: from “is data arriving” to “where do people get stuck”.

Report The question it answers What to check in week one
Home How many people came and what did they do? Users trend, channel mix and the funnel preview look plausible
Realtime Is data arriving right now? Launch and campaign traffic appear within seconds
Traffic acquisition Which channels bring engaged sessions? Few sessions land in Direct that should be Paid or Social
Funnel Where do visitors drop off before converting? Each step has data; a zero step usually means an event is missing
Path Which pages do people really move between? The checkout or sign-up path matches how you think the site works

Mind the date range. Reports default to the last 30 days, so on install day switch to Today, or the charts look empty. For reading the funnel in depth, see our guide to sales funnel analysis; for how the Funnel report itself handles step order, the completion window and cross-device visitors, see how AdPix funnels work. Once a week or two of data has built up, an AI report pulls these reports into one brief and checks every number in it against them. The Free plan includes 1 AI report a month; how the AdPix AI assistant works shows how to read and check one.

How many page views will your site use on the Free plan?

AdPix’s Free plan includes 100,000 page views a month for each website. Your usage depends on how many pages each session opens: every page a visitor opens counts once, including page changes in a single-page app, and custom events do not use up the allowance.

Take a hypothetical store with 18,000 sessions a month. Assume each session opens about 3 pages. That is 18,000 × 3 = 54,000 page views a month, inside the Free allowance. The product or form events those sessions send are not page views, so adding a second tracked event per session leaves the count at 54,000. Traffic growth to 40,000 sessions at 3 pages each would mean 120,000 page views, past the Free allowance and well within Starter’s 1,000,000.

The 3 is an assumption. After the first week, read your real page_view count in the Events report and multiply it out to a month before you decide on a plan. AdPix pricing lists each plan’s page-view allowance. Retention is the same for every website: events and sessions are kept for 25 months, the raw event archive for 24 months and daily rollups for 38 months (AdPix docs).

Can you install AdPix next to Google Analytics?

Yes. AdPix’s docs say its tag runs independently of other tags and does not affect their data, so you can keep GA4 while you compare. AdPix is a web analytics platform that replaces Google Analytics 4: realtime, acquisition, engagement, conversion and e-commerce reports, plus attribution, lift testing and marketing mix modelling, with no data sampling and a free plan.

Expect small differences, and compare like with like. AdPix defaults to the last 30 days and GA4 to 28, AdPix cuts days in the website’s time zone, and GA4 processes standard reports with a delay. AdPix’s docs suggest comparing a complete day at least two days old. Take the GA4 side from a standard report rather than an exploration, which can be sampled on busy sites; the GA4 data sampling guide explains the limit. Our GA4 data discrepancies guide gives a 30-day side-by-side plan, and the Google Analytics alternative guide covers whether to switch afterwards. If you are also weighing a self-hosted tool, the Matomo vs Google Analytics comparison covers server and plugin costs. If you plan to leave GA4, export your GA4 history first.

Your next step: install the tag on one template, confirm your own visit in Realtime, then roll it out to every other template and run Test installation once more. When the basics hold, the AdPix features overview shows what to switch on next.

UTM link builder

Tag campaign links so every click is credited to the right channel. The free plan covers 100,000 page views a month for each website, no credit card. Setup takes under five minutes.

Frequently asked questions

How long does it take to install AdPix?

AdPix states that setup takes under five minutes: create the account and website, copy the tag from Data streams and paste it into the head of every page template. Your own visit normally appears in Realtime within seconds of the tag going live.

Can I install AdPix with Google Tag Manager?

Yes. AdPix's docs say either the site template or Google Tag Manager works; in Tag Manager, add the snippet as a Custom HTML tag that fires on every page, then preview and publish the container. Remove any hard-coded copy from the template so the tag is not loaded twice.

Why does AdPix show no data after I installed the tag?

Check in this order: the snippet is in the published page source, the tag ID starting with AP- matches the one in Data streams, the consent banner was accepted, your IP is not in Excluded CIDRs, and no ad blocker or opt-out cookie is active in your browser. A wrong tag ID fails silently, so compare it character by character.

Does installing AdPix affect Google Analytics?

No. AdPix's docs say its tag runs independently of other tags and does not change their data, so you can run it next to GA4. Expect the two tools' numbers to differ slightly because session, filtering and consent behavior differ.

Why is the conversion rate zero in AdPix after setup?

Because sign-up defines no key events. Add an objective under Admin, Website details, or mark your sign-up, lead or purchase events under Admin, Key events, and conversions start counting from then.

Sources and methodology

Every AdPix screen name, default and check in this guide comes from the docs.adpix.io pages listed in sources, read on 10 November 2026; plan placement comes from adpix.io/pricing and retention lifetimes from the AdPix docs' Data retention page, both read on 13 November 2026. Google Tag Manager steps come from Google's Tag Manager Help pages, read on 10 November 2026. The page-view example uses hypothetical traffic and a hypothetical pages-per-session figure; the arithmetic is done in this article.

  1. AdPix Docs: Install the measurement tag
  2. AdPix Docs: Create your account and website
  3. AdPix Docs: Verify data is arriving
  4. AdPix Docs: No data is arriving
  5. AdPix Docs: Read your first report
  6. AdPix Docs: The numbers don't match GA4
  7. AdPix Docs: What AdPix Analytics is
  8. AdPix Docs: Data retention
  9. Tag Manager Help: Custom tags
  10. Tag Manager Help: Page view triggers
  11. Tag Manager Help: Preview and debug containers
  12. Tag Manager Help: Publishing, versions, and approvals

This article was drafted with AI assistance and reviewed by the AdPix team before publishing. Editorial policy

About the authorFounder, AdPix · Builder of AdPix

Founder of AdPix, the web analytics platform built for Iranian teams. Every article on this blog is reviewed by the founder before it is published.

Web analyticsAttributionCampaign measurement

Analyze your data, decide with more confidence

With AdPix, analyze campaign performance and grow in step with your business needs.