{"id":304458,"date":"2026-05-06T11:13:11","date_gmt":"2026-05-06T11:13:11","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/roas-meta-tools-post-product-catalog\/"},"modified":"2026-07-07T22:34:16","modified_gmt":"2026-07-07T22:34:16","slug":"roas-tool-kits-for-meta","status":"publish","type":"plugin","link":"https:\/\/vec.wordpress.org\/plugins\/roas-tool-kits-for-meta\/","author":23487354,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.7.4","stable_tag":"1.7.4","tested":"7.0","requires":"6.0","requires_php":"8.0","requires_plugins":null,"header_name":"ROAS Tool Kits for Meta and Google (Post & Product Catalogue + Pixel, CAPI, GA4 & GTM)","header_author":"ROAS Tool Kit","header_description":"Generate clean XML feeds and deploy standard pixel tracking for your content and products.","assets_banners_color":"","last_updated":"2026-07-07 22:34:16","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/roastoolkit.com\/","header_author_uri":"https:\/\/roastoolkit.com\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":647,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","faq","changelog"],"tags":{"1.4.5":{"tag":"1.4.5","author":"roasmetatools","date":"2026-05-06 21:28:20"},"1.4.7":{"tag":"1.4.7","author":"roasmetatools","date":"2026-05-12 19:59:01"},"1.6.1":{"tag":"1.6.1","author":"roasmetatools","date":"2026-05-16 20:00:20"},"1.6.2":{"tag":"1.6.2","author":"roasmetatools","date":"2026-05-20 23:08:16"},"1.6.4":{"tag":"1.6.4","author":"roasmetatools","date":"2026-06-03 23:23:02"},"1.6.8":{"tag":"1.6.8","author":"roasmetatools","date":"2026-06-13 23:09:59"},"1.7.0":{"tag":"1.7.0","author":"roasmetatools","date":"2026-06-19 14:22:02"},"1.7.1":{"tag":"1.7.1","author":"roasmetatools","date":"2026-06-20 04:00:06"},"1.7.3":{"tag":"1.7.3","author":"roasmetatools","date":"2026-07-01 23:14:46"},"1.7.4":{"tag":"1.7.4","author":"roasmetatools","date":"2026-07-07 22:34:16"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3524819,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.4.5","1.4.7","1.6.1","1.6.2","1.6.4","1.6.8","1.7.0","1.7.1","1.7.3","1.7.4"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3560114,"resolution":"1","location":"assets","locale":"","width":1126,"height":908},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3560114,"resolution":"2","location":"assets","locale":"","width":1036,"height":881},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3560114,"resolution":"3","location":"assets","locale":"","width":1040,"height":730},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3560114,"resolution":"4","location":"assets","locale":"","width":1026,"height":735},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3534027,"resolution":"5","location":"assets","locale":"","width":907,"height":682}},"screenshots":{"1":"The Unified Catalog Feed Engine showing restored UI note blocks.","2":"The Meta Core Setup and Host-Native CAPI configuration.","3":"The High-Intent Event Control Center with custom value configuration arrays.","4":"The Advanced Google Hub and UTM Persistence toggles.","5":"The New Microsoft Clarity Hub setup tab."}},"plugin_section":[],"plugin_tags":[265713,195844,265712,207498,225674],"plugin_category":[],"plugin_contributors":[78154,265714],"plugin_business_model":[],"class_list":["post-304458","plugin","type-plugin","status-publish","hentry","plugin_tags-content-catalog-feed","plugin_tags-conversions-api","plugin_tags-google-ads-tag","plugin_tags-meta-pixel","plugin_tags-product-catalog-feed","plugin_contributors-freemius","plugin_contributors-roasmetatools","plugin_committers-roasmetatools"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/roas-tool-kits-for-meta\/assets\/icon-256x256.png?rev=3524819","icon_2x":"https:\/\/ps.w.org\/roas-tool-kits-for-meta\/assets\/icon-256x256.png?rev=3524819","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/roas-tool-kits-for-meta\/assets\/screenshot-1.png?rev=3560114","caption":"The Unified Catalog Feed Engine showing restored UI note blocks."},{"src":"https:\/\/ps.w.org\/roas-tool-kits-for-meta\/assets\/screenshot-2.png?rev=3560114","caption":"The Meta Core Setup and Host-Native CAPI configuration."},{"src":"https:\/\/ps.w.org\/roas-tool-kits-for-meta\/assets\/screenshot-3.png?rev=3560114","caption":"The High-Intent Event Control Center with custom value configuration arrays."},{"src":"https:\/\/ps.w.org\/roas-tool-kits-for-meta\/assets\/screenshot-4.png?rev=3560114","caption":"The Advanced Google Hub and UTM Persistence toggles."},{"src":"https:\/\/ps.w.org\/roas-tool-kits-for-meta\/assets\/screenshot-5.png?rev=3534027","caption":"The New Microsoft Clarity Hub setup tab."}],"raw_content":"<!--section=description-->\n<p>ROAS Tool Kits is the ultimate attribution, qualitative analytics, and catalog infrastructure for modern media buyers and traffic arbitrage marketers.<\/p>\n\n<p>Whether you are scaling WooCommerce E-commerce or running high-volume Advantage+ Arbitrage campaigns, this plugin restores your attribution data, logs precise behavioral analytics, and seamlessly generates the XML feeds Meta and TikTok need to scale your ads.<\/p>\n\n<h4>Core Free Features<\/h4>\n\n<ul>\n<li>Host-Native Conversions API (CAPI): Route server-side events directly through your own WordPress host. No third-party servers like Stape.io or Google Cloud required.<\/li>\n<li>Unified Catalog Feeds: Instantly generate compliant XML feeds for Meta (Blog Posts &amp; Products), Google Merchant Center, and TikTok Ads Manager.<\/li>\n<li>Meta &amp; TikTok Core: Global tracking for PageView, ViewContent, AddToCart, InitiateCheckout, and Purchase\/CompletePayment.<\/li>\n<li>Microsoft Clarity Hub: Direct, completely free integration for user behavior recordings and heatmaps with zero traffic limits.<\/li>\n<li>Google Hub: One-click deployment for Google Analytics 4 (GA4), Google Tag Manager (GTM), Google Ads Remarketing, and Consent Mode v2.<\/li>\n<li>Dual-Routing Events: Automatically push all standard Meta Pixel events directly into GA4 and TikTok simultaneously.<\/li>\n<\/ul>\n\n<h4>Premium Features (PRO)<\/h4>\n\n<ul>\n<li>[PRO] Advanced Resource Hinting Matrix: High-priority preconnecting and DNS prefetching algorithms injected at priority 1 to accelerate ad tracking handshakes by 100-300ms.<\/li>\n<li>[PRO] Main-Thread Delay Staggering: Postpones scroll and time monitoring loops until after window paint completion to dramatically optimize TBT and TTI page speeds.<\/li>\n<li>[PRO] Clarity Smart Custom Tags: Automatically pushes exact traffic source taxonomies and custom metrics into Microsoft Clarity to filter video playbacks by ad performance.<\/li>\n<li>[PRO] Ad-Blocker Bypass Proxy: Routes frontend JavaScript tracking data to an internal WP endpoint to completely bypass strict browser ad-blockers and recover up to 30% of missing data.<\/li>\n<li>[PRO] TikTok Events API: Route high-intent events server-side to TikTok using Long-Term Access Tokens for maximum attribution accuracy.<\/li>\n<li>[PRO] GA4 Server-Side API: Dual-routes custom events directly to Google\u2019s servers using the Measurement Protocol API secret to restore data lost to iOS tracking restrictions.<\/li>\n<li>[PRO] Automatic Advanced Matching: Automatically detects logged-in WordPress\/WooCommerce users, hashes their emails securely, and injects them into the Meta\/TikTok pipeline to boost Event Match Quality (EMQ).<\/li>\n<li>[PRO] UTM &amp; Click ID Persistence Engine (v6.1): Bulletproof cross-session tracking. Captures UTMs, <code>fbclid<\/code>, <code>gclid<\/code>, and <code>ttclid<\/code> to dynamically stitch them into outbound links or send them directly into CAPI server payloads.<\/li>\n<li>[PRO] Real-Time Feed Invalidation: Move beyond basic 12-hour caching. The XML catalog instantly self-destructs the millisecond a product price changes, goes out of stock, or is moved to the trash, saving wasted ad spend.<\/li>\n<li>[PRO] Algorithmic Event Optimization (VBO): Assign custom monetary values to high-intent micro-conversions (scroll depth, time on site) to train the Meta and TikTok algorithms for higher-quality traffic using Value-Based Optimization.<\/li>\n<li>[PRO] Event Deduplication: Automatically generates and passes synchronized <code>event_id<\/code> hashes between the browser and server to prevent double-counting.<\/li>\n<li>[PRO] High-Intent Custom Triggers: Fire granular events (Scroll Depth 50\/70% with passive listeners, Time on Site up to 5 minutes, Multi-PageViews, and Composite Triggers) to Meta, TikTok, GA4, and Google Ads.<\/li>\n<li>[PRO] Advanced Feed SEO: Automatically pulls Yoast SEO titles and primary categories into your XML Catalog fields.<\/li>\n<li>[PRO] Negative Exclusion Audiences: Server-side tracking for WooCommerce Order Refunded and Order Cancelled events.<\/li>\n<\/ul>\n\n<!--section=faq-->\n<dl>\n<dt id=\"how%20do%20i%20get%20yoast%20seo%20titles%20and%20categories%20into%20my%20xml%20feed%3F\"><h3>How do I get Yoast SEO titles and categories into my XML Feed?<\/h3><\/dt>\n<dd><p>The Free version pulls standard WordPress titles and categories. If you upgrade to Pro, the feed engine automatically detects Yoast SEO (or standard WP hierarchy) and injects your optimized SEO titles into the <code>custom_label_0<\/code> field, and your primary categories into the <code>custom_label_1<\/code> field in your Meta Catalog. Ensure you map these custom fields correctly when setting up your Data Source in Meta Commerce Manager.<\/p><\/dd>\n<dt id=\"do%20the%20high-intent%20custom%20events%20go%20to%20google%20analytics%204%3F\"><h3>Do the High-Intent Custom Events go to Google Analytics 4?<\/h3><\/dt>\n<dd><p>Yes! If you enable GA4 or Google Ads in the Google Hub tab, all High-Intent events (like <code>ScrollDepth70<\/code>, <code>TimeOnSite3Min<\/code>, <code>PageView3<\/code>, and Composite Triggers) are dual-routed. They will fire to Meta, TikTok, and Google automatically, allowing you to build identical high-intent retargeting audiences.<\/p><\/dd>\n<dt id=\"can%20i%20use%20my%20custom%20parameters%20to%20filter%20microsoft%20clarity%20recordings%3F\"><h3>Can I use my custom parameters to filter Microsoft Clarity recordings?<\/h3><\/dt>\n<dd><p>Yes, if you are a PRO user! The plugin automatically pipes your dynamic <code>traffic_source<\/code>, custom events, and composite milestones directly into Clarity as Custom Tags. You can load your Clarity dashboard and instantly filter playbacks to only show users arriving from specific paid ad channels who engaged deeply with your content.<\/p><\/dd>\n<dt id=\"how%20does%20the%20ad-blocker%20bypass%20proxy%20work%3F\"><h3>How does the Ad-Blocker Bypass Proxy work?<\/h3><\/dt>\n<dd><p>Standard ad-blockers block requests going to standard tracking URLs. The Pro version utilizes a custom internal REST API endpoint (<code>\/wp-json\/roas-analytics\/v1\/track\/<\/code>). Events are sent to your own domain first (which ad-blockers ignore), and then your server securely routes the data to Meta CAPI, TikTok Events API, and GA4.<\/p><\/dd>\n<dt id=\"do%20i%20need%20stape.io%20or%20server-side%20gtm%20to%20use%20the%20conversions%20api%3F\"><h3>Do I need Stape.io or Server-Side GTM to use the Conversions API?<\/h3><\/dt>\n<dd><p>No. ROAS Tool Kits features a 100% Host-Native CAPI routing engine. It securely processes and pushes the server payloads directly from your existing WordPress hosting server environment, saving you monthly third-party server costs.<\/p><\/dd>\n<dt id=\"why%20is%20meta%2Ftiktok%20rejecting%20my%20xml%20feed%20url%3F\"><h3>Why is Meta\/TikTok rejecting my XML Feed URL?<\/h3><\/dt>\n<dd><p>If the ad platform returns an error when you paste your URL (e.g., <code>\/feed\/tiktok-catalog\/<\/code>), you simply need to flush your permalinks. Go to your WordPress Dashboard &gt; Settings &gt; Permalinks, and click \"Save Changes\" at the bottom. Test the URL in your browser to verify you see raw XML code, and then paste it into your Ad Manager.<\/p><\/dd>\n<dt id=\"will%20all%20these%20pixels%20slow%20down%20my%20website%20layout%3F\"><h3>Will all these pixels slow down my website layout?<\/h3><\/dt>\n<dd><p>No. Version 1.7.4 introduces critical main-thread offloading. we inject high-priority DNS Resource Hints at priority 1 to establish server connections instantly in the background.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.7.4<\/h4>\n\n<ul>\n<li>Optimization: Core main-thread deferral mapping. Relocated high-intent event matrices and scroll tracking down to window post-load phases, lowering TBT bottlenecks.<\/li>\n<li>Optimization: Switched scroll depth trackers to use native passive event configurations to eliminate scrolling latency on mobile screens.<\/li>\n<li>Feature: Fully integrated Microsoft Clarity Hub supporting basic free tracking setups.<\/li>\n<li>Feature: Added Clarity Custom Tags mapping into PRO tiers to channel traffic source and high-intent logs straight to session dashboards.<\/li>\n<li>Feature: Structured custom date extraction metrics (<code>event_month<\/code>, <code>event_day<\/code>, <code>event_hour<\/code>) inside frontend arrays.<\/li>\n<li>Fix: Restored the missing informational note panels directly back to the Catalogs and Feeds tab interface.<\/li>\n<\/ul>\n\n<h4>1.7.3<\/h4>\n\n<ul>\n<li>Feature: Custom Event Value Architecture. Assign monetary values to micro-conversions (Scroll Depth, Time on Site, PageViews) to power Value-Based Optimization (VBO) in Meta and TikTok algorithms.<\/li>\n<li>Maintenance: Bumped stable version and synced settings matrix.<\/li>\n<\/ul>\n\n<h4>1.7.2<\/h4>\n\n<ul>\n<li>Update: Opt-in mode enabled and configured properly for Freemius tracking.<\/li>\n<\/ul>\n\n<h4>1.7.1<\/h4>\n\n<ul>\n<li>Update: Included expanded global currency index to the Post product feed matrix.<\/li>\n<\/ul>\n\n<h4>1.7.0<\/h4>\n\n<ul>\n<li>Update: Enhanced CAPI \"Pipeline\" structure for cleaner, safer payload sanitation and strict adherence to API schema requirements.<\/li>\n<\/ul>\n\n<h4>1.6.9<\/h4>\n\n<ul>\n<li>Feature: Google Merchant Center Apparel &amp; Taxonomy Engine. Dynamically scrapes and injects <code>g:color<\/code>, <code>g:size<\/code>, <code>g:gender<\/code>, <code>g:age_group<\/code>, <code>g:product_type<\/code>, and <code>g:sale_price<\/code> for live inventory.<\/li>\n<li>Feature: Dynamic WooCommerce Data Payloads. <code>AddToCart<\/code> and <code>InitiateCheckout<\/code> now extract and pass exact <code>content_ids<\/code>, <code>value<\/code>, and <code>currency<\/code> attributes for perfect Dynamic Ads matching.<\/li>\n<li>Fix: Meta CAPI <code>_fbc<\/code> Timestamp Compliance. Upgraded standard server clock formatting to the required 13-digit millisecond string to satisfy strict Meta API validation rules.<\/li>\n<li>Fix: Event Debouncing Engine. Deployed a 500ms cooldown window to prevent <code>AddToCart<\/code> race conditions and duplicate event firing on overlapping theme builders (like Divi).<\/li>\n<li>Fix: Strict ISO Currency Validation. Prevents Meta Conversions API rejections by sanitizing empty string data output and forcing standardized fallbacks.<\/li>\n<\/ul>\n\n<h4>1.6.8<\/h4>\n\n<ul>\n<li>Fix: Restored default <code>value = 0<\/code> data injection to ensure Custom Event Objectives function correctly inside Meta Ads Manager.<\/li>\n<li>Feature: Refined REST API logic with <code>PageView<\/code> server-side suppression logic protecting data alignment and reducing compute costs.<\/li>\n<li>Feature: Extended support within the Server-Side Tracking framework directly accommodating GA4 Event Deduplication parameters (<code>event_id<\/code> string extraction inside proxy handler).<\/li>\n<\/ul>\n\n<h4>1.6.7<\/h4>\n\n<ul>\n<li>Update: Updated GA4 Server tracking.<\/li>\n<\/ul>\n\n<h4>1.6.6<\/h4>\n\n<ul>\n<li>Feature: Added dedicated TikTok Hub (Pixel integration + Events API for Pro users).<\/li>\n<li>Feature: Added TikTok Unified Catalog Feed (<code>\/feed\/tiktok-catalog\/<\/code>) to streamline shop integration.<\/li>\n<li>Update: Updated Freemius integration to handle new Premium Slug (<code>roas-tool-kits-for-meta-google-premium<\/code>).<\/li>\n<\/ul>\n\n<h4>1.6.5<\/h4>\n\n<ul>\n<li>Maintenance: Incremented version number and synced dashboard UI.<\/li>\n<\/ul>\n\n<h4>1.6.4<\/h4>\n\n<ul>\n<li>Update: Integrated official branding and direct documentation links (roastoolkit.com) into the plugin header and dashboard UI.<\/li>\n<li>Security: Strengthened programmatic server-side <code>$is_pro<\/code> gating for custom telemetry tracking to prevent unauthorized database manipulation.<\/li>\n<\/ul>\n\n<h4>1.6.3<\/h4>\n\n<ul>\n<li>Major Upgrade: Added Ad-Blocker Bypass Proxy via custom REST API to ensure server-side tracking survives strict browser extensions.<\/li>\n<li>Feature: Added GA4 Server-Side Measurement Protocol routing (Dual-routes Meta CAPI and GA4 events natively).<\/li>\n<li>Feature: Added Google Ads tag (<code>AW-XXXXXXXXX<\/code>) support with automatic High-Intent event syncing for Google Audience Remarketing.<\/li>\n<li>Feature: Introduced Click ID Recovery (<code>fbclid<\/code>, <code>gclid<\/code>) and automatic server payload stitching for perfect attribution.<\/li>\n<li>Feature: Added Automatic Meta Advanced Matching (automatically hashes logged-in WooCommerce customer emails to boost Event Match Quality).<\/li>\n<li>Feature: Advanced Feed Scheduling with custom cache intervals (Live, 1hr, 6hr, 12hr).<\/li>\n<li>Feature: Bulletproof Real-Time Feed Invalidation instantly clears the XML cache on WooCommerce product edits, stock changes, new variations, or trash deletions.<\/li>\n<\/ul>\n\n<h4>1.6.2<\/h4>\n\n<ul>\n<li>Major Upgrade: Rebuilt UTM &amp; Click ID Persistence Engine (v6.0) to bypass Elementor page-builder redirects.<\/li>\n<li>Feature: High-Intent events now dual-route directly to Google Analytics 4 (<code>gtag<\/code> global bridge).<\/li>\n<li>Feature: Added extended engagement triggers (Time on Site: 3 Min, 5 Min &amp; PageViews: 4, 5).<\/li>\n<li>Feature: Added new high-value composite events (2Mins + 2PV, 3Mins + 3PV).<\/li>\n<li>Feature: Advanced ViewContent dynamic data injection (passes exact price, currency, category, and IDs for Dynamic Ads).<\/li>\n<li>Fix: Universal Click Interceptor deployed for WooCommerce Add-To-Cart buttons (captures AJAX and custom Elementor clicks).<\/li>\n<li>UI: Rebuilt dashboard with a cleaner, color-coded, tabbed interface and unified \"Pro\" badges.<\/li>\n<li>UI: Added 1-Click Copy buttons to Catalog Feed URLs.<\/li>\n<li>Update: Moved permalink flush warning and added explicit <code>custom_label_0<\/code> and <code>custom_label_1<\/code> SEO mapping instructions to the dashboard.<\/li>\n<\/ul>\n\n<h4>1.6.1<\/h4>\n\n<ul>\n<li>Initial stable release of the unified tracking and feed engine.<\/li>\n<\/ul>","raw_excerpt":"Generate a WP content &amp; product catalog for dynamic ads. Easily deploy the Meta Pixel, Conversions API, GA4, Google Ads, GTM, TikTok Pixel\/Events  &hellip;","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/304458","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=304458"}],"author":[{"embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/roasmetatools"}],"wp:attachment":[{"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=304458"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=304458"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=304458"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=304458"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=304458"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=304458"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}