Documentation

Tagioo reference docs

Technical detail for every part of the platform. New here? Start with the full setup guide instead — this page is for reference once you're up and running.

Getting Started

Every Tagioo account starts on the Free plan (15,000 events/month, forever). Launch flow, top to bottom:

  • Create your Tagioo account and a GTM Server container
  • Point a subdomain at Tagioo via one CNAME record
  • Create a container in your Tagioo dashboard
  • Generate and import Web + Server GTM templates via Setup Assistant
  • Connect your store (WooCommerce plugin, or manual dataLayer)
  • Test in Meta Events Manager and confirm events in your dashboard

See the full step-by-step walkthrough for screenshots and detail on each step.

WooCommerce Plugin

Download the Tagioo plugin from your dashboard's Setup Assistant, upload it under Plugins → Add New → Upload Plugin in WordPress, activate, and paste your container's tracking ID when prompted. No GTM4WP or manual dataLayer coding needed.

Once active, it automatically pushes these events to the dataLayer on every relevant page:

  • page_view — every page load, with page_location and page_title set explicitly
  • view_item — product page views
  • add_to_cart — cart additions, with product ID, price, quantity
  • begin_checkout — checkout page reached
  • purchase — completed order, with transaction ID, value, and items
  • Hashed user_data (email, phone) on purchase for Meta CAPI match quality, where available

GTM Setup Assistant

Prefer to follow along? Watch the complete Tagioo server-side tracking setup video ↗.

A 4-step wizard in your dashboard that generates two ready-to-import JSON files:

  • web.json — imports into your Web GTM container: dataLayer listeners, the Custom Loader tag, and Consent Mode v2 defaults
  • server.json — imports into your Server GTM container: GA4 client + tags, Meta CAPI tag, Google Ads conversion tags, and TikTok Events API tag, pre-filled with your credentials

In GTM, use Import Container → Merge → Rename conflicting tags, review in Preview mode, then Publish both containers.

First-party Domain & SSL

Point a subdomain you own at Tagioo with a single CNAME record:

track.yoursite.com CNAME bd.tagioo.com

Once DNS propagates (usually minutes, sometimes up to a few hours), Tagioo automatically provisions an SSL certificate via Let's Encrypt and renews it silently — no action needed from you. This is also the domain the Custom Loader uses to serve gtm.js/gtag.js first-party, which is what lets tracking survive Brave and most ad-blockers.

Offline Conversions

Available on Pro and Enterprise. Upload a CSV of phone, COD, or in-store orders from your dashboard's Offline Conversions view. Expected columns:

order_id, value, currency, email, phone, event_time

Email and phone are hashed client-side before upload. You'll see a validation preview before confirming, and every upload is logged with a per-batch history so you can see exactly what was sent to Meta CAPI and when.

Purchase Gap Alert

Tagioo compares today's purchase count against your trailing 7-day average, scaled for time of day so it doesn't false-positive at 9am. If today's count runs more than 50% below that baseline, a red banner appears in your dashboard the same day — instead of you noticing days later via a bad ROAS number.

On the Free plan, usage against your 15,000 events/month cycle is tracked the same way: you're notified by email and WhatsApp as you approach the limit (at rising thresholds from 10K events), and your container pauses if you reach 15,000 until the 30-day cycle resets or you upgrade.

Troubleshooting

Events not showing up in Meta Test Events? Confirm your Server GTM container is published (not just saved), check the container status in your Tagioo dashboard is "Running," and verify your domain's SSL certificate is issued (a padlock on https://track.yoursite.com).

Purchases missing after a WooCommerce order? Check the WordPress plugin is active and its container tracking ID matches your dashboard. Use the Purchase Inspector in your dashboard to search by order ID and see exactly which destinations (Meta, GA4) received it.

ROAS suddenly dropped? Check the dashboard's Purchase Gap Alert first — it's built for exactly this. If it's not flagging anything, check your 30-day table for a spike in errors on the affected day.

Still stuck? Message us on WhatsApp — free setup help.