The Paved conversion pixel is a small code snippet that you add to your website to track conversions (like purchases or sign-ups) resulting from your Paved email ad campaigns.
By recording what users do after clicking on your sponsored email content, the pixel provides real-time data on ad performance, helping you measure ROI and optimize campaigns.
In other words, it lets you attribute Shopify actions back to a Paved ad, which is crucial for tracking email sponsorship conversions.
1. Retrieve Your Paved Pixel ID
First, you'll need to retrieve your unique Pixel ID from your Paved account:
Log in to Paved.
Click your name and select Conversion Pixels from the drop-down.
Click View.
Copy the Pixel ID to your clipboard.
Note: Disregard the Pixel Code section. The setup process works differently for Shopify stores, so we'll walk you through it in the next step.
2. Create a Custom Paved Pixel Code
Next, you'll create a custom pixel code using your Paved Pixel ID:
In a new window, open your Notepad app.
Copy this code snippet and paste it into your notepad:
!function(e,t,n,o,p,i,a){e[o]||((p=e[o]=function(){p.process?p.process.apply(p,arguments):p.queue.push(arguments)}).queue=[],p.t=+new Date,(i=t.createElement(n)).async=1,i.src="https://pvdpix.com/pixel.js?t="+864e5*Math.ceil(new Date/864e5),(a=t.getElementsByTagName(n)[0]).parentNode.insertBefore(i,a))}(window,document,"script","pvd"),pvd("init","#########"); analytics.subscribe("checkout_completed", event => { const checkout = event.data.checkout; const checkoutTotalPrice = checkout.totalPrice?.amount; pvd("event","purchase", {value: checkoutTotalPrice}); });In the code snippet, replace the placeholder, #########, with your Pixel ID.
Copy the full code to your clipboard.
3. Connect your custom pixel
Follow these steps to add your new pixel code to your Shopify store:
In a new tab, open your Shopify admin page.
In the left sidebar, click the gear icon to open Settings.
Click Customer Events.
Click Add custom pixel.
Enter a descriptive name for your pixel and click Add pixel.
In the Code box or editor that appears, paste the pixel code you created.
Click Connect to activate the pixel.
Confirm any prompts (Shopify may ask you to acknowledge their terms for custom pixels). The pixel’s status will change to Connected, meaning it’s now live on your store and will begin tracking events.
After connecting, your Paved pixel is installed! Shopify will now load this pixel on the relevant pages and begin sending data to Paved as customers interact with your newsletter advertising campaigns.
4. Track Events Using the Paved Pixel
You can use your Paved Pixel to track various events on your website. Before you start, the pixel's base code must already be installed on every page where you want to track conversions.
All standard events are tracked by calling the pixel's pvd('event') function, with the event name, and (optionally) a JSON object as its parameters. For example, here's a function call to track when a visitor has completed a purchase event, with currency and value included as a parameter:
pvd('event', 'purchase', {currency: "USD", value: 30.00});
We currently support the following events:
Event Type | Event Parameter | Additional Parameters |
Purchase | purchase | currency (string)value (decimal) |
Sign Up | sign_up | account_type (string) |
Download | download | file (string) |
Search | search | search_term (string) |
We also support custom events. Feel free to change the event parameter to whatever you want to track.
Note: If you're working with a Paved Ad Network campaign, be sure to select Enable Conversion Tracking in the Budget step of the Ad Builder.
Optional Step: Enhanced User Matching
Optionally, you can add additional details to help identify the user.
Enhanced user matching is recommended for conversion tracking and highly recommended for building audiences.
We can accept the following identifiers:
Parameter | Description | Example |
lowercase email address | ||
md5_email | MD5 hash of lowercase email address | ede11e58ccb2a69be895ebf43bdbfe11 |
sha256_email | SHA256 hash of lowercase email address | 29ad0bc7b86878af75a07a31f2e24d50 |
These can be sent alongside any event parameters, including the Page Load event in the base code:
pvd("event","pageload", {md5_email: "ede11e58ccb2a69be895ebf43bdbfe11"})
