Pinterest Conversions API Addon for Google Analytics 4 PRO
Requires the Google Analytics 4 PRO extension.
Pinterest Conversions API Integration for Magento 2
Transform your Magento 2 store's advertising capabilities with our Pinterest Conversions API integration. This powerful addon establishes a direct, secure connection between your eCommerce data and Pinterest Ads, enabling precise conversion tracking and smarter campaign optimization across Shopping, Performance Max, and paid social placements.
Designed specifically for Magento 2 merchants, this server-side implementation ensures reliable event delivery even in environments with strict privacy controls, Intelligent Tracking Prevention, or ad blockers. Your Pinterest performance data remains accurate, resilient, and ready to power bidding algorithms.
Key Benefits of Pinterest CAPI Integration
Advanced Conversion Tracking
Bridge the Pinterest tag and the Conversions API to capture every critical interaction—purchases, add-to-carts, and checkout steps—even when client-side scripts are blocked.
Enhanced Data Privacy Compliance
Meet modern privacy standards while maximizing Pinterest campaign effectiveness. Server-side data sharing gives you granular control over what is sent, making it easier to document consent preferences.
Future-Proof Implementation
Stay ahead of browser updates with a hybrid tracking approach that combines Pinterest tag flexibility with server-side reliability, ensuring consistent reporting as the advertising ecosystem evolves.
Centralized Data Management
Consolidate your Magento 2 store's Pinterest signals through a single API connection. Streamline pixel implementation, reduce duplication, and keep attribution clean across every funnel touchpoint.
How Pinterest Conversions API Integration Works
Customers interact with your Magento 2 store (product views, add to carts, checkout steps, purchases)
Server-side tracking captures the full event payload with 100% reliability
Secure data transmission to Pinterest occurs through the official Conversions API
Real-time conversion data appears in Pinterest Ads Manager for optimization
The following diagram illustrates the seamless integration between your Magento 2 store, server-side processing, and the Pinterest Conversions API:
Features of the Pinterest Conversions API Addon
Event Tracking
- Server-side Checkout (Purchase) event delivery
- Server-side AddPaymentInfo event tracking
- Server-side AddToCart event tracking
- Server-side InitiateCheckout event tracking
Additional Events
- Server-side PageVisit event tracking
- Server-side AddToWishlist event tracking
- Server-side Search event tracking
- Server-side ViewContent event tracking
- Server-side ViewCategory event tracking
- Server-side Signup event tracking
Powerful Integration
- Track selected events in conjunction with the frontend Pinterest tag
- Option to track events only for logged-in users
- Directly and fully integrated into the Google Analytics 4 PRO extension
- Ability to send data to multiple Pinterest ad accounts
Developer Tools
- Log functionality for in-depth debugging of events sent to the Pinterest Conversions API
- Easy setup with Pinterest API Access Token and Advertiser IDs
- Option to track only specific customer groups
System Compatibility
- Compatible with Magento 2.3.x - 2.4.8
- Works with all Magento editions
- Supports multiple store views
Requirements for using the Pinterest Conversions API Addon
To use the Pinterest Conversions API Addon, you'll need the following:
- A Pinterest Business account with an approved Conversions API access token and advertiser (ad account) ID. Generate these under Business Access → Conversions API.
- The Google Analytics 4 PRO extension enabled and configured.
How to Install the Pinterest Conversions API Addon
Prerequisites
- Ensure your Magento version is compatible (2.3.0 - 2.4.8 and all Security Patches)
- Install on a testing environment first
- Set Magento to developer mode
- Make sure the Google Analytics 4 PRO extension is already installed and configured on your Magento 2 instance. You can find the steps for doing so in the Google Analytics 4 PRO User Guide.
php bin/magento deploy:mode:set developer
File Installation
Copy the extension files to your Magento 2 instance:
app/code/WeltPixel/GA4PinterestSS
Extension Installation
Run the following commands in your Magento root directory:
php bin/magento module:enable WeltPixel_GA4PinterestSS --clear-static-content
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
Cache Management
Production Mode
If your store was in production mode, switch it back:
php bin/magento deploy:mode:set production
Completion
How to Upgrade the Extension
Remove Old Files
app/code/WeltPixel/GA4PinterestSS before upgrading.
The extension may be refactored and old unused files may cause random issues, so it's best to only keep the latest version of the files.
Follow Installation Steps
Follow the normal installation instructions above.
How to Configure the Pinterest Conversions API Addon
Basic Configuration
Important Notice: To gain access to your Pinterest Conversions API Access Token and Advertiser ID, you need a Pinterest Business account with an app approved for the Conversions API. Generate tokens under Business Access → Conversions API, otherwise server-side tracking will not authenticate.
Admin → WeltPixel → Google Analytics 4 Ecommerce PRO → Pinterest Conversions API Settings
Enable Pinterest Server Side Tracking
Toggle this to Yes to activate the Pinterest Conversions API integration. Events selected below will be sent server-to-server in addition to the Pinterest tag firing on the storefront.
Pinterest Account ID
This ID can be found in your Pinterest Ads Manager account under Ad Account Overview → Conversions → Conversions API → Set up API. Add it here so the addon knows which Pinterest account to target.
Pinterest Conversions API Access Token
Paste the Access Token generated in Pinterest Business Access. Each advertiser (ad account) you connect requires a valid token to authorize requests.
Send events only for logged in users
If you only want to forward events when hashed identifiers such as email are available, set this option to Yes. Otherwise, Pinterest will stitch events via the Pinterest tag visitor ID even for guest shoppers.
Track Events
Select the events you wish to send to Pinterest via the API. Available options are:
- PageVisit
- Checkout (Purchase)
- AddPaymentInfo
- AddToCart
- AddToWishlist
- InitiateCheckout
- Search
- ViewContent
- ViewCategory
- Signup
Note: Make sure the Enable Pinterest Pixel Tracking option in the section above is set to Yes, and that you've added your Pinterest Tag ID so the browser and server events can be matched.
Advanced Configuration
Send enabled events via the frontend Pinterest tag as well
Enable this option if you want the selected events to fire both through the Pinterest tag and the Conversions API. Duplicated events are automatically deduplicated via the event ID.
Enable Test Mode
Use this option to send test events to the Pinterest Pixel. Ideal when validating the configuration without polluting production reporting.
Enable File Log
Enable the creation of a log file that shows the pushed event data. The pinterest-api.log file can be found in the var/log directory of your Magento 2 root.
Track Only Specific Customer Groups
If set to Yes, only selected customer groups will be tracked by Pinterest server-side events.
Send eCommerce Event Data to multiple Pinterest endpoints
If set to Yes, you'll be able to add extra Pinterest advertiser IDs to which you want to send eCommerce event data. Each advertiser requires its own Access Token. Note: Adding a new advertiser here will only send the enabled server-side events. If you need PageVisit events for attribution, also add the additional Pinterest Tag IDs in the Pinterest Pixel Tracking section above (comma separated).
Support and Resources
Documentation
Access our comprehensive documentation in the Knowledge Base for detailed setup and configuration instructions.
Technical Support
Our dedicated support team is ready to assist you with any technical issues or questions you may encounter during setup and usage.
Regular Updates
Stay current with regular updates ensuring compatibility with the latest Magento versions and Pinterest API changes.
Frequently Asked Questions
What is the Pinterest Conversions API Addon?
The Pinterest Conversions API Addon enables server-side tracking of customer events from your Magento 2 store to Pinterest, providing accurate conversion data for bidding, attribution, and reporting.
Do I need the Google Analytics 4 PRO extension?
Yes, this addon requires the Google Analytics 4 PRO extension to be installed and configured on your Magento 2 store.
What events can be tracked?
The addon supports tracking of Pinterest events such as PageVisit, Checkout (Purchase), AddPaymentInfo, AddToCart, AddToWishlist, InitiateCheckout, Search, ViewContent, ViewCategory, and Signup.
How secure is the data transmission?
All data is transmitted securely using Pinterest's official Conversions API endpoints with access token authentication and HTTPS encryption.
Change Log
Version History
- Initial release.
Future updates will include additional features and enhancements to the Pinterest Conversions API Addon.