Skip to content

Pixels & Ad Tracking

Pagge provides built-in, zero-code tracking integrations for all major advertising and analytics platforms. You can connect and manage your pixels without writing code or editing templates.


Supported Platforms

Pagge natively supports the following advertising and analytics platforms:

  1. Meta Pixel (Facebook & Instagram): Track ad performance, optimize campaigns for conversions, and build custom audiences.
  2. Google Analytics (GA4): Measure website traffic, user engagement, and e-commerce conversion funnels.
  3. Google Ads: Track conversion actions, ROAS, and remarketing audiences directly from Google Ads campaigns.
  4. TikTok Pixel: Optimize your TikTok ad campaigns and track storefront events in real time.

Standard E-Commerce Events

When a pixel is connected, Pagge automatically tracks standard e-commerce funnel events across your storefront and checkout:

Standard EventWhen It FiresWhat It Measures
page_viewedOn every storefront page loadGeneral store visitors and page impressions
product_viewedWhen a customer views a product page or quick-view modalProduct name, ID, price, and currency
product_added_to_cartWhen a customer clicks "Add to Cart"Item ID, name, quantity, unit price, and total value
checkout_startedWhen a customer opens the checkout pageCart item list, product IDs, subtotal, and currency
purchase_completedWhen an order is successfully placedOrder reference number, total revenue, currency, and line items

Connecting a Pixel

  1. Navigate to Dashboard → Stores → [Your Store] → Settings.
  2. Select the Pixels & Tracking tab from the settings menu.
  3. Locate the platform you want to connect (Meta, Google Analytics, Google Ads, or TikTok).
  4. Choose your preferred connection method:
    • 1-Click Connect: Connect directly with your advertising account in one click.
    • Connect Manually: Enter your Pixel ID or Measurement ID directly.

Where to Find Your IDs

  • Meta Pixel ID: Find your 15–16 digit Pixel ID in Meta Events Manager.
  • Google Analytics 4 (GA4): Find your Measurement ID (starts with G-) in Google Analytics under Admin → Data Streams.
  • Google Ads: Find your Conversion ID (starts with AW-) and optional Conversion Label in Google Ads under Goals → Conversions → Summary.
  • TikTok Pixel ID: Find your alphanumeric Pixel ID in TikTok Ads Manager under Assets → Event.

Testing Your Tracking

Pagge includes an integrated live testing utility so you can verify events before launching ad campaigns:

  1. On any connected platform card, click Test Tracking.
  2. Select the event you wish to simulate (e.g. product_viewed, product_added_to_cart, checkout_started, or purchase_completed).
  3. Click Send Test Event.
  4. You will receive immediate feedback (✓ Event sent successfully) and the timestamp will be recorded on your card.

Conversions API (CAPI) & Deduplication

For maximum tracking reliability, Pagge supports server-side conversion dispatching alongside browser-based tracking:

  • Ad-Blocker Resilience: Purchase events originate directly from verified backend order completions.
  • Deterministic Event IDs: Pagge generates matching event IDs (purchase_{order_number}) for both browser and server payloads, ensuring platforms like Meta and TikTok automatically deduplicate conversions without double-counting revenue.

Security & Encryption

  • Encrypted at Rest: All access tokens, refresh tokens, and API credentials are encrypted with AES-256 in the database.
  • No Code Injection: Storefront tracking scripts are generated safely through strict validation rules, preventing malicious script injection.
  • Private Credentials: Sensitive API keys and tokens are never exposed in storefront HTML markup or client-side bundles.