Pixels

Entrolytics Pixels enable conversion tracking for emails, ads, and third-party platforms where JavaScript tracking isn't possible.

Overview

Pixels are 1x1 transparent images that track:

Email opens - When recipients view your emails
Ad impressions - When ads are displayed
External conversions - Events from third-party platforms
Offline touchpoints - QR codes, print media

Creating Pixels

Via Dashboard

Navigate to Pixels in the sidebar
Click Create Pixel
Enter a name for the pixel
Configure tracking options
Copy the pixel URL

Via API

import { getClient } from '@entro314labs/entro-api'

const client = getClient({
  hostUrl: 'https://cloud.entrolytics.click',
  websiteId: 'your-website-id',
})

const pixel = await client.pixels.create({
  name: 'Newsletter Open',
  type: 'email',
})

// Result includes pixel URL
console.log(pixel.url)
// https://cloud.entrolytics.click/p/abc123.gif

Pixel Types

Email Tracking Pixel

Track email opens by embedding a pixel in your email HTML:

<img
  src="https://cloud.entrolytics.click/p/abc123.gif"
  width="1"
  height="1"
  alt=""
  style="display:none;"
/>

Dynamic Email Pixel

Include recipient information for segmentation:

<img
  src="https://cloud.entrolytics.click/p/abc123.gif?email={{EMAIL}}&campaign={{CAMPAIGN_ID}}"
  width="1"
  height="1"
  alt=""
/>

Ad Tracking Pixel

For ad platforms that support tracking pixels:

https://cloud.entrolytics.click/p/abc123.gif?ad_id={{AD_ID}}&placement={{PLACEMENT}}

Conversion Pixel

Track post-click conversions:

<!-- Place on thank you/confirmation page -->
<img
  src="https://cloud.entrolytics.click/p/abc123.gif?event=purchase&value=99.99"
  width="1"
  height="1"
/>

Pixel Parameters

Add parameters to enrich pixel data:

Parameter	Description	Example
`event`	Event name	`email_open`, `purchase`
`email`	Recipient email (hashed)	`user@example.com`
`campaign`	Campaign identifier	`summer-2024`
`value`	Conversion value	`99.99`
`currency`	Currency code	`USD`
`product`	Product identifier	`prod_123`
Custom	Any custom parameter	`source=newsletter`

https://cloud.entrolytics.click/p/abc123.gif?event=purchase&value=99.99&currency=USD&product=prod_123

Integration Examples

Email Service Providers

Mailchimp

<img src="https://cloud.entrolytics.click/p/abc123.gif?email=*|EMAIL|*&campaign=*|CAMPAIGN_UID|*" width="1" height="1" />

SendGrid

<img src="https://cloud.entrolytics.click/p/abc123.gif?email={{email}}&campaign={{campaign_id}}" width="1" height="1" />

Klaviyo

<img src="https://cloud.entrolytics.click/p/abc123.gif?email={{ email }}&flow={{ flow.id }}" width="1" height="1" />

ConvertKit

<img src="https://cloud.entrolytics.click/p/abc123.gif?email={{ subscriber.email_address }}" width="1" height="1" />

Ad Platforms

Google Ads

Use the pixel URL as a conversion tracking URL in your Google Ads account.

Facebook/Meta Ads

Add the pixel to your landing page or use in server-side tracking:

<img src="https://cloud.entrolytics.click/p/abc123.gif?event=ad_view&ad_id={{ad.id}}" width="1" height="1" />

E-commerce Platforms

Shopify Order Confirmation

Add to your order confirmation template:

<img
  src="https://cloud.entrolytics.click/p/abc123.gif?event=purchase&value={{ total_price | money_without_currency }}&currency={{ currency }}&order_id={{ order.id }}"
  width="1"
  height="1"
/>

WooCommerce Thank You Page

<img
  src="https://cloud.entrolytics.click/p/abc123.gif?event=purchase&value=<?php echo $order->get_total(); ?>&order_id=<?php echo $order->get_id(); ?>"
  width="1"
  height="1"
/>

Pixel Analytics

Viewing Stats

Navigate to Pixels → Click on a pixel to see:

Total fires (impressions)
Unique fires
Timeline chart
Parameter breakdown
Geographic distribution

API Access

// Get pixel with stats
const pixel = await client.pixels.get(pixelId)

// List all pixels with stats
const pixels = await client.pixels.list()

Organization Pixels

Create pixels at the organization level:

// Create org-level pixel
const pixel = await client.pixels.createOrgPixel(orgId, {
  name: 'Company Newsletter Tracking',
  type: 'email',
})

// List all org pixels
const pixels = await client.pixels.getOrgPixels(orgId)

API Reference

Create Pixel

const pixel = await client.pixels.create({
  name: string,           // Pixel name (required)
  type?: 'email' | 'ad' | 'conversion' | 'custom',
})

Get Pixel

const pixel = await client.pixels.get(pixelId)

Update Pixel

const pixel = await client.pixels.update(pixelId, {
  name?: string,
  type?: string,
})

Delete Pixel

await client.pixels.delete(pixelId)

List Pixels

const pixels = await client.pixels.list()

Privacy Considerations

Email Tracking

Many email clients block tracking pixels by default
Apple Mail Privacy Protection loads pixels on proxy servers
Consider pixels as one signal, not definitive opens

Data Minimization

Hash or anonymize email addresses when possible
Don't pass sensitive PII through pixel parameters
Respect user privacy preferences

Compliance

Disclose tracking in your privacy policy
Honor unsubscribe requests
Comply with GDPR, CCPA, and other regulations

Best Practices

Naming

Use descriptive, searchable names:

✅ Newsletter - Weekly Digest - Jan 2024
✅ Facebook Ads - Retargeting Campaign
✅ Order Confirmation - Purchase Pixel

❌ Pixel 1
❌ Test
❌ New pixel

Organization

Group pixels by:

Campaign type (email, ads, conversions)
Time period (Q1 2024, Summer Campaign)
Platform (Mailchimp, Facebook)

Testing

Always test pixels before deploying:

Create a test pixel
Open the pixel URL in your browser
Verify the event appears in your dashboard
Check parameter data is captured correctly

Troubleshooting

Pixel Not Firing

Check if the pixel URL is accessible
Verify the image tag is properly formatted
Check for ad blockers or privacy extensions
Review email client blocking settings

Missing Parameters

Ensure URL encoding for special characters
Check template variable syntax
Verify parameter names match expectations

Low Open Rates

Consider email client privacy features
Compare with other metrics (clicks, replies)
Don't rely solely on pixel data

Pixels

Table of Contents