Documentation

Adbot Guides

Choose a guide below to get started.

Coming soon — preview only. The Shopify app is in review with Shopify. This guide is published early so you can see what setup will look like. To install Adbot today, use the WordPress plugin.

Join the waitlist →

Shopify App

Installation & Setup Guide

Install Adbot on your Shopify store, connect Google Analytics 4 and Google Tag Manager, and start monitoring your tracking.

No technical background required · Last updated May 2026

1. What is Adbot?

Adbot is a tracking management platform that helps Shopify merchants and their agencies ensure Google Analytics and Google Tag Manager are set up correctly — and stay that way.

Feature	Description
GTM Audit	Scans your GTM container and produces a health score with a list of missing tags, broken triggers, and compliance gaps
GTM Setup Automation	Builds a setup plan and publishes the correct GA4 and e-commerce tags to your container automatically
GA4 Monitoring	Watches your GA4 property every day for data anomalies, missing events, or unexpected traffic drops
Alerts	Sends notifications when something goes wrong with your tracking

Platform components

Shopify App — Embedded inside your Shopify admin. Used for billing and as your entry point.
Adbot Dashboard — A web workspace where you run audits, configure GTM, and view reports.
Client Portal — A read-only view if your agency manages Adbot on your behalf.
WordPress Plugin — An optional add-on for merchants who also run a WordPress site.

2. Before You Begin — Prerequisites

Required

An active Shopify store on any plan (Basic and above)
A Google account with access to your GA4 property and/or GTM container
Google Analytics 4 (GA4) set up for your store — at minimum a GA4 property must exist
Access to a modern web browser (Chrome or Firefox recommended)

3. Installing the Shopify App

In the left sidebar, click Apps, then Shopify App Store

Search for “Adbot” and open the listing

Permission	Why it is needed
Read your store's analytics data	To pull e-commerce event data into Adbot's monitoring
Read products	To check your product catalogue against GTM tracking rules
Read orders	To verify purchase event tracking is firing correctly

Your data is safe. Adbot only reads the data needed for tracking analysis. It never modifies your orders, products, or customer records.

Click Install app to approve. Adbot securely stores your access token (AES-256-GCM encrypted) and redirects you into the embedded app.

4. Setting Up Your Subscription

Charges appear on your regular Shopify invoice — no separate payment account needed.

Plan	Price	Billing Cycle
Adbot Pro	$29 / month	Monthly (every 30 days)

Open the Adbot app inside Shopify and click Billing

Review the plan and click Approve

Confirm the recurring charge — your subscription is active immediately

If you uninstall Adbot, your subscription is automatically cancelled and your data is retained for 30 days before permanent deletion.

5. Connecting Your Google Account

Click Connect Google Account

Select the Google account that has access to your GA4 property and GTM container

Review the permissions and click Allow

Category	Permission	Why
Identity	View email and basic profile	Required to log in
Google Analytics 4	View Analytics data	Read metrics and health snapshots
Google Analytics 4	Edit and manage Analytics accounts	Configure properties and data streams
Google Analytics 4	Provision new Analytics accounts	Create GA4 properties if needed
Google Tag Manager	View GTM containers	List accounts and run audits
Google Tag Manager	Manage GTM containers	Write tags, triggers, and variables
Google Tag Manager	Publish GTM containers	Push changes live

Google access tokens expire periodically. When this happens, Adbot will prompt you to reconnect — your data and configuration will not be affected.

6. Linking a GA4 Property

In the Adbot Dashboard, click Analytics → Add Property

Select the GA4 property that belongs to your Shopify store

Click Add to Monitoring

Monitoring	Description
Daily health snapshot	Captures session counts, event counts, and key metrics each day
7-day trend	Tracks whether traffic and events are increasing or decreasing
Real-time window	Checks events recorded in the last 30 minutes for sudden drops
Baseline comparison	Flags when today's data deviates significantly from your historical average

7. Linking a GTM Container

In the Adbot Dashboard, click Tag Manager → Connect Container

Select the GTM container installed on your Shopify store

Click Connect

Adbot reads your container in real time from the GTM API. Audit results are stored as snapshots so you can compare over time.

8. Running Your First GTM Audit

Click Tracking, select your GTM container, then click the Assessment tab

Click Run Audit — the audit takes 10–30 seconds

Score	Colour	Meaning
80–100	Green	Healthy — minor gaps only
60–79	Yellow	Moderate issues — some tracking may be missing
0–59	Red	Critical gaps — key events are likely not tracked

9. Automating GTM Setup

Publishing changes to GTM affects your live store tracking. Review the plan carefully before publishing. All changes create a new GTM version you can instantly roll back.

Click Tracking, select your container, then the Setup tab

Click Generate Plan — Adbot lists exactly which tags, triggers, and variables it will add

Click Preview to review changes without applying them

Click Execute then Publish — your tags are now live

To roll back: go to Setup → History, find the run, and click Rollback.

10. GA4 Health Monitoring & Alerts

Severity	Meaning
Info	Informational — no action required
Warning	Something looks unusual — investigate when you can
Critical	Tracking has likely stopped — investigate immediately

Action	What it does
Acknowledge	Marks the alert as seen
Resolve	Marks the issue as fixed and archives the alert
Snooze	Hides the alert for a set period

Adbot checks all monitored GA4 properties once per day overnight. Real-time data is fetched on demand when you open the Monitoring dashboard.

11. User Roles

Capability	Admin	Client
Run GTM audits & publish changes	Yes	No
Configure GA4 monitoring	Yes	No
Manage all client accounts	Yes	No
View own audit history & alerts	Yes	Yes
View own GA4 analytics	Yes	Yes
Invite team members	Yes	No

12. Uninstalling Adbot

In your Shopify admin, go to Apps

Find Adbot and click Delete, then confirm

Data	What happens
Shopify access token	Deleted immediately and securely
Audit history	Retained for 30 days, then permanently deleted
GA4 monitoring data	Retained for 30 days, then permanently deleted
GTM container contents	Not affected — Adbot never deletes GTM data

13. Troubleshooting

Google account isn't connecting

Make sure you are using a Google account with at least Editor access to your GA4 property and GTM container — read-only accounts cannot complete authorisation.

Clear your browser cookies and cache, then try again. If the issue persists, go to Settings → Google Connection, click Disconnect, and reconnect from scratch.

Audit isn't running / Audit failed

Confirm you have a GTM container linked under Tag Manager. Check that your Google account shows a green “Connected” indicator in Settings → Google Connection.

Wait 60 seconds and retry — GTM API rate limits occasionally cause temporary failures.

No GA4 data in the monitoring dashboard

GA4 monitoring data refreshes once per day overnight. If you just linked a property today, check again tomorrow morning.

Verify your GA4 Measurement ID is installed on your store — check in GA4 under Admin → Data Streams → Your Stream.

Subscription isn't activating

Charges can take a few minutes to process. Make sure your Shopify account has a valid payment method. If you declined the charge, open the Adbot app in Shopify and click Billing to re-initiate.

14. Frequently Asked Questions

Can I connect multiple Shopify stores?

Yes. Adbot supports multi-store use. Each store tracks its GTM container and GA4 property independently.

Is my data secure?

Yes. All tokens are encrypted at rest using AES-256-GCM. All communication uses HTTPS and webhooks are HMAC-SHA256 verified.

Which Shopify API version does Adbot use?

Adbot uses Shopify API 2025-01, updated periodically to stay within Shopify’s supported range.

How often does GA4 data refresh?

Daily health snapshots run once per day overnight. Real-time data is fetched on demand. The 7-day trend is derived from accumulated daily snapshots.

Can I monitor GA4 without GTM?

Yes. GA4 monitoring works independently of GTM. GTM is only required for container audits and automated tag publishing.

My agency manages Adbot for me — do I need to do anything?

If your agency set up Adbot on your behalf, you likely only need the Client Portal to view results and alerts.

← Back to Adbot·Last updated May 2026