Overview

Introduction

PixelFly is a server-side event tracking platform that helps you send conversion events from your website to marketing platforms (Facebook, Google) without being blocked by ad-blockers or browser restrictions.

Choose Your Integration Method

WordPress / WooCommerce

Easiest setup with our plugin

GTM with DataLayer

For Laravel, custom sites with GTM

Server-side API

Direct HTTP API for backends

 Full Control

sGTM Hosting

Managed Server-Side GTM on Google Cloud

Installation

Choose your preferred integration method to start tracking events with PixelFly. We recommend using our WordPress plugin or GTM integration for the best experience.

WordPress / WooCommerce

Install our plugin for automatic e-commerce tracking with no code required.

View setup guide →

GTM with DataLayer

Use Google Tag Manager to send events via the dataLayer.

View setup guide →

Server-side API

Send events directly from your backend using HTTP requests.

View setup guide →

Domain Setup

For first-party tracking (recommended), add a CNAME record pointing to our infrastructure:

Type Name Value
CNAME t track.pixelfly.io

Benefits of Custom Domain

  • • Bypass ad blockers that block third-party tracking
  • • Cookie Life Extension: Extend _fbp, _fbc, _ga cookies from 7 days to 2 years
  • • Better attribution accuracy on Safari and Firefox

Platform Config

Configure your destination platforms in the PixelFly dashboard. We support:

Meta Conversions API

Facebook & Instagram

Enter your Pixel ID and Access Token from Meta Events Manager.

GA4 Measurement Protocol

Google Analytics 4

Enter your Measurement ID and API Secret from GA4 Admin.

TikTok Events API

TikTok Ads

Enter your Pixel Code and Access Token from TikTok Business Center.

LinkedIn Conversions API

LinkedIn Ads

Enter your Access Token and Conversion Rule ID from LinkedIn Campaign Manager.

Snapchat Conversions API

Snapchat Ads

Enter your Pixel ID and Access Token from Snapchat Ads Manager.

Standard Events

ViewContent

Track when a user views a product or content page.

pixelfly('track', 'ViewContent', {
    content_ids: ['SKU123'],
    content_name: 'Product Name',
    content_type: 'product',
    content_category: 'Category',
    value: 2500,
    currency: 'BDT'
});

AddToCart

Track when a user adds a product to their shopping cart.

pixelfly('track', 'AddToCart', {
    content_ids: ['SKU123'],
    content_name: 'Product Name',
    content_type: 'product',
    value: 2500,
    currency: 'BDT',
    quantity: 1
});

InitiateCheckout

Track when a user starts the checkout process.

pixelfly('track', 'InitiateCheckout', {
    content_ids: ['SKU123', 'SKU456'],
    value: 5000,
    currency: 'BDT',
    num_items: 2
});

Purchase

Track when a user completes a purchase. Include user data for better attribution.

pixelfly('track', 'Purchase', {
    content_ids: ['SKU123', 'SKU456'],
    value: 5000,
    currency: 'BDT',
    order_id: 'ORDER-123',
    num_items: 2
}, {
    // User data for better matching
    email: 'customer@example.com',
    phone: '+8801712345678',
    first_name: 'John',
    last_name: 'Doe'
});

Integrations

WordPress / WooCommerce Plugin

Easiest setup • No coding required • Full e-commerce tracking

1

Install the Plugin

Download the PixelFly for WooCommerce plugin and upload it to your WordPress site.

Download WooCommerce Plugin

Go to WordPress Admin → Plugins → Add New → Upload Plugin

2

Configure Plugin Settings

Navigate to WooCommerce → PixelFly and enter your API key from your PixelFly dashboard.

  • Enter your PixelFly API Key
  • Enable DataLayer for GTM (recommended)
  • Enable delayed events for COD orders (optional)
3

Import GTM Container

Download the pre-configured GTM container and import it to Google Tag Manager.

Download GTM Container (WordPress)

In GTM: Admin → Import Container → Choose file

This includes pre-configured tags for all e-commerce events with proper triggers.

4

Publish & Test

Publish your GTM container and test the tracking using GTM Preview mode and PixelFly Event Debugger.

That's it! Your WooCommerce store is now tracking all e-commerce events to Meta CAPI and GA4.

Automatically Tracked Events

page_view view_item add_to_cart view_cart begin_checkout add_payment_info add_shipping_info purchase

GTM with DataLayer

For Laravel, PHP, or any site using Google Tag Manager

1

Setup DataLayer Events

Push e-commerce events to the dataLayer from your application code. Use GA4 standard event format.

// Example: Add to Cart event
dataLayer.push({
  event: 'add_to_cart',
  ecommerce: {
    currency: 'BDT',
    value: 1500,
    items: [{
      item_id: 'SKU123',
      item_name: 'Product Name',
      price: 1500,
      quantity: 1
    }]
  },
  user_data: {
    email: 'customer@example.com',
    phone: '+8801712345678'
  }
});
2

Import PixelFly GTM Container

Download the pre-configured GTM container and import it to Google Tag Manager.

Download GTM Container (Laravel/Custom)

The container includes:

  • PixelFly Server-side Tag (sends to Meta CAPI + GA4)
  • Pre-configured triggers for all e-commerce events
  • DataLayer variables for ecommerce data extraction
3

Configure Your API Key

In GTM, update the PixelFly tag with your API key from the dashboard.

DataLayer Event Reference

// Page View
dataLayer.push({ event: 'page_view' });

// Purchase
dataLayer.push({
  event: 'purchase',
  ecommerce: {
    transaction_id: 'ORDER-123',
    currency: 'BDT',
    value: 5000,
    tax: 0,
    shipping: 100,
    items: [{ item_id: 'SKU123', item_name: 'Product', price: 2500, quantity: 2 }]
  },
  user_data: {
    email: 'customer@example.com',
    phone: '+8801712345678'
  }
});

Server-side API

Direct HTTP API • Any programming language • Full control

API Endpoint

POST https://track.pixelfly.io/e

Or use your custom domain: POST https://t.yourdomain.com/e

Required Headers

Content-Type: application/json
X-PF-Key: YOUR_API_KEY

Request Body

{
  "event": "Purchase",
  "event_id": "unique-event-id-123",
  "value": 5000,
  "currency": "BDT",
  "order_id": "ORDER-123",
  "content_ids": ["SKU123"],
  "user_data": {
    "email": "customer@example.com",
    "phone": "+8801712345678"
  }
}

PHP / Laravel Example

$response = Http::withHeaders([
    'X-PF-Key' => env('PIXELFLY_API_KEY'),
])->post('https://track.pixelfly.io/e', [
    'event' => 'Purchase',
    'event_id' => Str::uuid()->toString(),
    'value' => $order->total,
    'currency' => 'BDT',
    'order_id' => $order->id,
    'user_data' => [
        'email' => $order->email,
        'phone' => $order->phone,
    ],
]);

Response

{
  "success": true,
  "event_id": "unique-event-id-123"
}

Full Control

sGTM Hosting

Managed Server-Side Google Tag Manager on Google Cloud

What is sGTM Hosting? PixelFly provisions and manages a full Google Tag Manager Server Container on Google Cloud. You get all GTM server-side features (Google Ads Enhanced Conversions, any GTM template, preview/debug mode) without needing to manage GCP infrastructure.

1

Create sGTM Container

In your PixelFly dashboard, go to Containers → Create Container and select sGTM as the container type.

2

Enter GTM Container Config

Paste your GTM Server Container Config string. You can find this in Google Tag Manager under Admin → Container Settings of your server container.

Requirements:

  • A GTM Server Container (created in tagmanager.google.com)
  • The Container Config string from GTM server container settings
3

Wait for Provisioning

PixelFly automatically provisions two Google Cloud services: a tagging server and a preview server. The status will update in your dashboard once ready.

4

Add Custom Domain

Add a CNAME record for your sGTM domain:

Type Name Value
CNAME server track.pixelfly.io
5

Configure GTM Web Container

In your GTM Web Container, set the Server Container URL to your custom domain (e.g., https://server.yourstore.com). All server-side tags will now route through PixelFly's infrastructure.

Done! Your sGTM container is now live with Cloudflare edge proxy, bot detection, and auto-scaling Cloud. Use GTM Preview mode to debug your server-side tags.

What's Included

Full GTM Server-Side features
Google Ads Enhanced Conversions
Preview & Debug mode
Bot protection at edge
Auto-scaling Cloud
First-party custom domain

Downloads

Plugins & GTM Templates

Download our official plugins and pre-configured GTM container templates to quickly set up PixelFly on your website.

PixelFly for WooCommerce

WordPress plugin for automatic e-commerce tracking. Pushes all WooCommerce events to the dataLayer for GTM integration.

Download Plugin (.zip)

GTM Container Template - WordPress / WooCommerce

Pre-configured GTM container with Facebook Pixel, GA4, and PixelFly Server-Side tags. Optimized for WordPress and WooCommerce sites.

Facebook Pixel GA4 Events PixelFly CAPI
Download GTM Container (.json)

GTM Container Template - Laravel / Custom Sites

Pre-configured GTM container for Laravel, PHP, or any custom website. Includes all standard e-commerce event tags and triggers.

Facebook Pixel GA4 Events PixelFly CAPI
Download GTM Container (.json)

How to Import GTM Container

  1. 1 Open Google Tag Manager and select your container
  2. 2 Go to Admin (gear icon) in the top navigation
  3. 3 Click Import Container
  4. 4 Choose the downloaded JSON file and select Merge or Overwrite
  5. 5 Update the PixelFly tag with your API key and publish the container

Tools & Support

Debugging

Use these tools to verify your integration is working correctly.

GTM Preview Mode

In Google Tag Manager, click "Preview" to see real-time events firing on your site.

Meta Events Manager

Check "Test Events" in Meta Events Manager to see server-side events arriving.

PixelFly Event Logs

View real-time event logs in your PixelFly dashboard to see all tracked events.

Need Help?

Our support team is here to help you get set up quickly.

Contact Support
Documentation Menu

We use cookies to enhance your experience, analyze site traffic, and for marketing purposes. By continuing to use our site, you consent to our use of cookies. Learn more