{"id":161777,"date":"2022-09-06T18:05:21","date_gmt":"2022-09-06T18:05:21","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/eacmetapixel\/"},"modified":"2025-09-04T14:22:49","modified_gmt":"2025-09-04T14:22:49","slug":"eacmetapixel","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/eacmetapixel\/","author":20183118,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.0.2","stable_tag":"2.0.2","tested":"6.8.5","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"{eac}MetaPixel","header_author":"EarthAsylum Consulting","header_description":"{eac}MetaPixel installs the Facebook\/Meta Pixel to enable tracking of PageView, ViewContent, AddToCart, InitiateCheckout and Purchase events.","assets_banners_color":"b4c5a5","last_updated":"2025-09-04 14:22:49","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/github.com\/sponsors\/EarthAsylum","header_plugin_uri":"https:\/\/eacdoojigger.earthasylum.com\/eacmetapixel\/","header_author_uri":"http:\/\/www.earthasylum.com","rating":0,"author_block_rating":0,"active_installs":40,"downloads":2523,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"kevinburkholder","date":"2022-09-06 18:14:55"},"1.0.1":{"tag":"1.0.1","author":"kevinburkholder","date":"2022-09-28 17:44:27"},"1.0.2":{"tag":"1.0.2","author":"kevinburkholder","date":"2023-03-31 13:53:18"},"1.0.3":{"tag":"1.0.3","author":"kevinburkholder","date":"2023-11-01 21:48:18"},"1.0.4":{"tag":"1.0.4","author":"kevinburkholder","date":"2024-02-10 00:34:47"},"1.0.5":{"tag":"1.0.5","author":"kevinburkholder","date":"2024-04-16 02:21:05"},"1.0.6":{"tag":"1.0.6","author":"kevinburkholder","date":"2024-04-29 20:43:35"},"1.0.7":{"tag":"1.0.7","author":"kevinburkholder","date":"2025-07-21 22:23:13"},"2.0.0":{"tag":"2.0.0","author":"kevinburkholder","date":"2025-08-18 16:49:18"},"2.0.1":{"tag":"2.0.1","author":"kevinburkholder","date":"2025-08-25 14:17:57"},"2.0.2":{"tag":"2.0.2","author":"kevinburkholder","date":"2025-09-04 14:22:49"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":2780864,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":2780864,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":2780864,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":2780864,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.0.2","1.0.3","1.0.4","1.0.5","1.0.6","1.0.7","2.0.0","2.0.1","2.0.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3092456,"resolution":"1","location":"assets","locale":""}},"screenshots":{"1":"MetaPixel Extension"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[212626,157,4184,7855,207498],"plugin_category":[56],"plugin_contributors":[211905],"plugin_business_model":[],"class_list":["post-161777","plugin","type-plugin","status-publish","hentry","plugin_tags-eacdoojigger","plugin_tags-facebook","plugin_tags-facebook-ads","plugin_tags-facebook-pixel","plugin_tags-meta-pixel","plugin_category-social-and-sharing","plugin_contributors-kevinburkholder","plugin_committers-kevinburkholder"],"banners":{"banner":"https:\/\/ps.w.org\/eacmetapixel\/assets\/banner-772x250.jpg?rev=2780864","banner_2x":"https:\/\/ps.w.org\/eacmetapixel\/assets\/banner-1544x500.jpg?rev=2780864","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/eacmetapixel\/assets\/icon-128x128.png?rev=2780864","icon_2x":"https:\/\/ps.w.org\/eacmetapixel\/assets\/icon-256x256.png?rev=2780864","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/eacmetapixel\/assets\/screenshot-1.png?rev=3092456","caption":"MetaPixel Extension"}],"raw_content":"<!--section=description-->\n<p><em>{eac}MetaPixel<\/em> is an <a href=\"https:\/\/eacDoojigger.earthasylum.com\/\">{eac}Doojigger<\/a> extension which installs the Facebook\/Meta Pixel and enables tracking of PageView, Search, ViewContent, AddToCart, InitiateCheckout, AddPaymentInfo, and Purchase events when using <a href=\"https:\/\/woocommerce.com\/\">WooCommerce<\/a>.<\/p>\n\n<h4>What is the Meta Pixel?<\/h4>\n\n<blockquote>\n  <p>The Meta Pixel is a piece of code on your website that can help you better understand the effectiveness of your advertising and the actions people take on your site, like visiting a page or adding an item to their cart. You\u2019ll also be able to see when customers took an action after seeing your ad on Facebook and Instagram, which can help you with retargeting. And when you use the Conversions API alongside the Pixel, it creates a more reliable connection that helps the delivery system decrease your costs.<\/p>\n<\/blockquote>\n\n<p><em>See <a href=\"https:\/\/www.facebook.com\/business\/tools\/meta-pixel\">Meta Pixel<\/a><\/em><\/p>\n\n<p>To retrieve your pixel id, Go to Meta <a href=\"https:\/\/business.facebook.com\/events_manager2\">Events Manager<\/a> \u2192 Data Sources \u2192 Your Pixel \u2192 Settings \u2192 Pixel ID. Copy your pixel id and paste it into the \"Facebook Pixel ID\" field of this extension's settings.<\/p>\n\n<h4>Pixel Events<\/h4>\n\n<ul>\n<li>Page Views\n\n<ul>\n<li>PageView events may occur on all pages or only pages that don't trigger another event.<\/li>\n<\/ul><\/li>\n<li>Site Search\n\n<ul>\n<li>Search result pages.<\/li>\n<\/ul><\/li>\n<li>Content View (archives)\n\n<ul>\n<li>Archive (category and tag) pages.<\/li>\n<\/ul><\/li>\n<li>Content View (products)\n\n<ul>\n<li>Product pages.<\/li>\n<\/ul><\/li>\n<li>Content View (commerce)\n\n<ul>\n<li>Product category, tag, and shop pages.<\/li>\n<\/ul><\/li>\n<li>Content View (cart)\n\n<ul>\n<li>The shopping cart page.<\/li>\n<\/ul><\/li>\n<li>Add To Cart\n\n<ul>\n<li>Buttons and links that add an item to the cart.<\/li>\n<\/ul><\/li>\n<li>Initiate Checkout\n\n<ul>\n<li>The checkout page.<\/li>\n<\/ul><\/li>\n<li>Add Payment Info\n\n<ul>\n<li>Billing information on checkout page.<\/li>\n<\/ul><\/li>\n<li>Purchase Completed\n\n<ul>\n<li>Purchase confirmation page. (a 'Purchase' event is registered as a 'Subscription' if the order includes a subscription).<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<h4>Server Based Conversion API<\/h4>\n\n<p>Support for the Meta <a href=\"https:\/\/developers.facebook.com\/docs\/marketing-api\/conversions-api\">Conversion API<\/a> to track  events directly from your server is included. When using the Conversion API (CAPI), additional information will be passed through the purchase api, including:<\/p>\n\n<ul>\n<li>Customer name (hashed, non-decipherable)<\/li>\n<li>Customer email address (hashed, non-decipherable)<\/li>\n<li>Customer phone number (hashed, non-decipherable)<\/li>\n<li>Customer billing address (hashed, non-decipherable)<\/li>\n<li>Order\/cart details (item, quantity, price)<\/li>\n<\/ul>\n\n<p>To enable the server conversion api, Go to Meta <a href=\"https:\/\/business.facebook.com\/events_manager2\">Events Manager<\/a> \u2192 Data Sources \u2192 Your Pixel \u2192 Settings. Scroll to Conversions API \u2192 Set up manually.<\/p>\n\n<p>Click the \"Generate access token\" link under the \"Get Started\" button. Copy the access token and paste it into the \"Server Access Token\" field of this extension's settings.<\/p>\n\n<blockquote>\n  <p>Note: Server events require a Meta Business Manager.<\/p>\n<\/blockquote>\n\n<p>In most cases, the CAPI event will be sent before the Pixel event. When the page is requested, the Pixel code is added to the page at the same time the CAPI event is sent, then when the page loads in the browser, the pixel fires. If the page is cached, the CAPI event may not be sent. <em>Typically, e-commerce pages are not cached.<\/em><\/p>\n\n<h4>Advantage+ Catalog Ads<\/h4>\n\n<p>The Content View (products), Add To Cart, Initiate Checkout, and Purchase Completed events meet the requirements for <a href=\"https:\/\/www.facebook.com\/business\/help\/606577526529702?id=1205376682832142\">Advantage+ catalog ads<\/a>.<\/p>\n\n<ul>\n<li>content_type : 'product'.<\/li>\n<li>content_ids : array of product skus.<\/li>\n<\/ul>\n\n<h4>Domain Verification<\/h4>\n\n<p>You may, optionally, add the Facebook Brand Safety domain verification meta tag to your home page.<\/p>\n\n<p>Go to Meta <a href=\"https:\/\/business.facebook.com\/settings\/\">Business Settings<\/a> \u2192 Brand Safety \u2192 Domains \u2192 Your Domain \u2192 Add a meta-tag, and copy just the <em>content=<\/em> string.<\/p>\n\n<p>In this example:\n    <code>&lt;meta name=\"facebook-domain-verification\" content=\"xyzzy1ndu84mmhaifl5gawo9ntafn8\" \/&gt;<\/code>\nWe want only <em>xyzzy1ndu84mmhaifl5gawo9ntafn8<\/em> copied and pasted into the \"Domain Verification\" field of this extension's settings.<\/p>\n\n<h4>Actions and Filters<\/h4>\n\n<ul>\n<li><p>Add a custom event to the page.<\/p>\n\n<p>do_action( 'eacDoojigger_meta_pixel_add_event', $eventType, $eventData, $eventID );<\/p><\/li>\n<li><p>Get the script code for a custom event (to attach to a DOM event).<\/p>\n\n<p>$script = apply_filters( 'eacDoojigger_meta_pixel_event_code', $eventType, $eventData, $eventID );<\/p><\/li>\n<li><p>Modify the event-specific data sent with the pixel and capi.<\/p>\n\n<p>add_filter('eacDoojigger_meta_pixel_eventdata', function($eventData, $eventType) {\n    \/\/ modify $eventData array as needed\n    return $eventData;\n}<\/p><\/li>\n<li><p>Modify the user data sent with the capi event.<\/p>\n\n<p>add_filter('eacDoojigger_meta_pixel_userdata', function($userData, $eventData, $eventType) {\n    \/\/ modify $userData array as needed\n    return $userData;\n}<\/p><\/li>\n<li><p>Modify the event ID sent with the pixel and capi.<\/p>\n\n<p>add_filter('eacDoojigger_meta_pixel_eventid', function($eventID, $eventData, $eventType) {\n    \/\/ modify $eventID as needed\n    return $eventID;\n}<\/p><\/li>\n<li><p>Enable console logging for pixel and capi.<\/p>\n\n<p>add_filter('eacDoojigger_meta_pixel_console', function($enabled) {\n    return true;\n}<\/p><\/li>\n<li><p>Enable setting the _fbc cookie when fbclid is passed.<\/p>\n\n<p>add_filter('eacDoojigger_meta_pixel_cookie', function($enabled) {\n    return true;\n}<\/p><\/li>\n<\/ul>\n\n<blockquote>\n  <p>Normally, the pixel code should set the _fbc cookie when first-party cookies are enabled. If this is not getting set, this filter can be used to enable internal code to set the cookie.<\/p>\n<\/blockquote>\n\n<h4>Additional Information<\/h4>\n\n<ul>\n<li>{eac}MetaPixel is an extension plugin to and requires installation and registration of <a href=\"https:\/\/eacDoojigger.earthasylum.com\/\">{eac}Doojigger<\/a>.<\/li>\n<\/ul>\n\n<p>See: <a href=\"https:\/\/business.facebook.com\/business\/help\/402791146561655\">Specifications for Facebook Pixel Standard Events<\/a><\/p>\n\n<h3>Copyright<\/h3>\n\n<h4>Copyright \u00a9 2019-2025, EarthAsylum Consulting, distributed under the terms of the GNU GPL.<\/h4>\n\n<p>This program is free software: you can redistribute it and\/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.<\/p>\n\n<p>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.<\/p>\n\n<p>You should receive a copy of the GNU General Public License along with this program. If not, see <a href=\"https:\/\/www.gnu.org\/licenses\/\">https:\/\/www.gnu.org\/licenses\/<\/a>.<\/p>\n\n<!--section=installation-->\n<p><strong>{eac}Doojigger MetaPixel Extension<\/strong> is an extension plugin to and requires installation and registration of <a href=\"https:\/\/eacDoojigger.earthasylum.com\/\">{eac}Doojigger<\/a>.<\/p>\n\n<h4>Automatic Plugin Installation<\/h4>\n\n<p>This plugin is available from the <a href=\"https:\/\/wordpress.org\/plugins\/search\/earthasylum\/\">WordPress Plugin Repository<\/a> and can be installed from the WordPress Dashboard \u00bb <em>Plugins<\/em> \u00bb <em>Add New<\/em> page. Search for 'EarthAsylum', click the plugin's [Install] button and, once installed, click [Activate].<\/p>\n\n<p>See <a href=\"https:\/\/wordpress.org\/support\/article\/managing-plugins\/#automatic-plugin-installation-1\">Managing Plugins -&gt; Automatic Plugin Installation<\/a><\/p>\n\n<h4>Upload via WordPress Dashboard<\/h4>\n\n<p>Installation of this plugin can be managed from the WordPress Dashboard \u00bb <em>Plugins<\/em> \u00bb <em>Add New<\/em> page. Click the [Upload Plugin] button, then select the eacmetapixel.zip file from your computer.<\/p>\n\n<p>See <a href=\"https:\/\/wordpress.org\/support\/article\/managing-plugins\/#upload-via-wordpress-admin\">Managing Plugins -&gt; Upload via WordPress Admin<\/a><\/p>\n\n<h4>Manual Plugin Installation<\/h4>\n\n<p>You can install the plugin manually by extracting the eacmetapixel.zip file and uploading the 'eacmetapixel' folder to the 'wp-content\/plugins' folder on your WordPress server.<\/p>\n\n<p>See <a href=\"https:\/\/wordpress.org\/support\/article\/managing-plugins\/#manual-plugin-installation-1\">Managing Plugins -&gt; Manual Plugin Installation<\/a><\/p>\n\n<h4>Settings<\/h4>\n\n<p>Once installed and activated options for this extension will show in the 'Tracking' tab of {eac}Doojigger settings.<\/p>\n\n<!--section=changelog-->\n<h4>Version 2.0.2 \u2013 Sep 4, 2025<\/h4>\n\n<ul>\n<li>Don't pass eventID on typically cached page events (PageView and select ViewContent events).<\/li>\n<li>Allow disabling eventID (false) on custom events.<\/li>\n<\/ul>\n\n<h4>Version 2.0.1 \u2013 Aug 25, 2025<\/h4>\n\n<ul>\n<li>Use <code>get_order_number<\/code> rather than <code>order-&gt;id<\/code> when passing order id\/event id.<\/li>\n<li>Add option to only trigger events when click id (fbclid) is present.<\/li>\n<li>Move standard pixel script to constant.<\/li>\n<\/ul>\n\n<h4>Version 2.0.0 \u2013 Aug 18, 2025<\/h4>\n\n<ul>\n<li>Updated to Facebook Graph API Version 23.0.<\/li>\n<li>All events use JavaScript Pixel AND server Conversion API (CAPI).<\/li>\n<li>Include eventID\/event_id with all events.<\/li>\n<li>Include fbc\/fbp (when available) with all events.<\/li>\n<li>Set <code>_fbc<\/code> cookie when <code>fbclid<\/code> url parameter passed.<\/li>\n<li><code>ViewContent<\/code> events include slug\/name as product_group.<\/li>\n<li>Added actions and filters.<\/li>\n<li>Added <code>AddPaymentInfo<\/code> event (on billing_city).<\/li>\n<li>Added <code>console.info()<\/code> for events.<\/li>\n<li>Remove jQuery dependency.<\/li>\n<li>Output script on <code>wp_print_footer_scripts<\/code> not <code>wp_enqueue_scripts<\/code>.<\/li>\n<li>Use <code>wp_print_inline_script_tag<\/code> not <code>wp_add_inline_script<\/code>.<\/li>\n<\/ul>\n\n<h4>Version 1.0.7 \u2013 Apr 19, 2025<\/h4>\n\n<ul>\n<li>Compatible with WordPress 6.8.<\/li>\n<li>Prevent <code>_load_textdomain_just_in_time was called incorrectly<\/code> notice from WordPress.\n\n<ul>\n<li>All extensions - via eacDoojigger 3.1.<\/li>\n<li>Modified extension registration in constructor.<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<h4>Version 1.0.6 \u2013 Apr 23, 2024<\/h4>\n\n<ul>\n<li>Correctly load javascript with jQuery dependency.<\/li>\n<li>Use $this-&gt;minifyString() on inline script;<\/li>\n<li>WordPress Requires at least: 5.7.0<\/li>\n<\/ul>\n\n<h4>Version 1.0.5 \u2013 Apr 10, 2024<\/h4>\n\n<ul>\n<li>Added notice if activated without {eac}Doojigger.<\/li>\n<\/ul>\n\n<h4>Version 1.0.4 \u2013 Feb 9, 2024<\/h4>\n\n<ul>\n<li>Fixed critical coding error in purchase tracking.<\/li>\n<\/ul>\n\n<h4>Version 1.0.3 \u2013 June 8, 2023<\/h4>\n\n<ul>\n<li>Removed unnecessary plugin_update_notice trait.<\/li>\n<\/ul>\n\n<h4>Version 1.0.2 \u2013 November 15, 2022<\/h4>\n\n<ul>\n<li>Updated to \/ Requires {eac}Doojigger 2.0.<\/li>\n<li>Uses 'options_settings_page' action to register options.<\/li>\n<li>Added contextual help using 'options_settings_help' action.<\/li>\n<li>Moved plugin_action_links_ hook to eacDoojigger_load_extensions filter.<\/li>\n<\/ul>\n\n<h4>Version 1.0.1 \u2013 September 25, 2022<\/h4>\n\n<ul>\n<li>Fixed potential PHP notice on load (plugin_action_links_).<\/li>\n<li>Added upgrade notice trait for plugins page.<\/li>\n<\/ul>\n\n<h4>Version 1.0.0 \u2013 September 6, 2022<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"{eac}MetaPixel installs the Facebook\/Meta Pixel to enable tracking of PageView, Search, ViewContent, AddToCart, InitiateCheckout and Purchase events.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/161777","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=161777"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/kevinburkholder"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=161777"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=161777"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=161777"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=161777"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=161777"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=161777"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}