Help Center

Appearance

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. Click Connect Manually or paste your snippet directly.

Smart Snippet & ID Auto-Extraction ​

You do not need to manually search for and copy raw IDs:

  • Direct ID: Enter your standalone ID (e.g., 123456789012345 or G-ABC123XYZ4).
  • Verbatim Code Snippet: You can paste the entire tracking script or HTML <script> block copied from Meta Events Manager, Google Tag, or TikTok Ads. Pagge's intelligent platform parser automatically extracts the clean ID without saving unwanted HTML or scripts.

Advanced Credentials & Verification Secrets ​

For enhanced resilience against browser ad blockers and private iOS browsing modes, configure server-side credentials:

  • Meta Pixel (Conversions API):
    • Access Token (Optional): Generate a server token in Meta Events Manager under Settings → Conversions API.
    • Test Event Code (Optional): Enter your temporary code (e.g. TEST12345) found in the Test Events tab of Meta Events Manager to verify server events live.
  • Google Analytics 4:
    • API Secret (Optional): Found in Google Analytics under Admin → Data Streams → Measurement Protocol API Secrets.
  • Google Ads:
    • Conversion Label (Optional): Enter your conversion label (e.g., vKx0CPT_...) to attribute sales to specific Google Ads campaigns.
  • TikTok Pixel (Events API):
    • Access Token (Optional): Found in TikTok Ads Manager under Assets → Events → Web Events → Settings.

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 (page_viewed, 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.
  5. If a Test Event Code is configured for Meta, the event will appear instantly inside your Meta Events Manager Test Events stream.

Managing Pixels with AI Chatbots & MCP ​

You can audit, connect, test, and disconnect tracking pixels directly via ChatGPT, Claude, Gemini, or the Pagge AI Assistant:

  • list_tracking_pixels: Check platform connection status and existing IDs.
  • connect_tracking_pixel: Connect pixels by passing either raw IDs, full script snippets, or server tokens (access_token, conversion_label, test_event_code, api_secret).
  • test_tracking_pixel: Trigger verification test events.
  • disconnect_tracking_pixel: Deactivate a connected platform.

Example AI Prompts: ​

"Connect my Meta Pixel with ID 1414899210152172 and test event code TEST48291."
"Set up Google Analytics 4 with measurement ID G-ABC123XYZ4."
"Test my TikTok pixel tracking."

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, API secrets, and server 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.