{"id":3623,"date":"2025-04-14T12:15:32","date_gmt":"2025-04-14T10:15:32","guid":{"rendered":"https:\/\/cocos.codes\/?p=3623"},"modified":"2026-01-21T16:09:06","modified_gmt":"2026-01-21T15:09:06","slug":"wordpress-meta-facebook-pixel","status":"publish","type":"post","link":"https:\/\/iarina029.supserv.cozmoslabs.com\/en\/archives\/wordpress-meta-facebook-pixel\/","title":{"rendered":"WordPress Meta Facebook Pixel 1.0"},"content":{"rendered":"<h6>WordPress Meta Facebook Pixel Documentation<\/h6>Comprehensive <a href=\"https:\/\/iarina029.supserv.cozmoslabs.com\/en\/category\/knowledge-base\/wordpress\/documentations\/\" title=\"Documentation\">documentation<\/a> for the plug-in <a href=\"https:\/\/iarina029.supserv.cozmoslabs.com\/en\/product\/wordpress-facebook-pixel-plugin-with-conversions-api\/\" title=\"Cc_facebook_pixel\">cc_facebook_pixel<\/a>.<br \/><br \/><strong>Table of contents<\/strong><br \/>1. introduction<br \/>2 Installation<br \/>3. license activation<br \/>4. basic configuration<br \/>5. tracking modes<br \/>6. server-side tracking<br \/>7. event queuing<br \/>8. custom events<br \/>9. advanced matching<br \/>10. debugging<br \/>11 Troubleshooting<br \/>12 FAQS.<br \/><h6><br \/>1. introduction<\/h6>CC Facebook Pixel is a professional plug-in for <a href=\"https:\/\/wordpress.org\/\" title=\"WordPress\" target=\"_blank\" rel=\"noopener\">WordPress<\/a> enabling full integration of the service with Facebook Pixel and Conversions API. It allows tracking of user activity on both the browser and server side, enabling more accurate and reliable conversion tracking, even when users use ad blockers.<br \/><br \/>The plug-in allows full control over:<ul><li>Integration with Facebook Pixel via JavaScript and\/or Conversions API<\/li><li>Tracking standard events (PageView, ViewContent, etc.).<\/li><li>creation and implementation of custom events<\/li><li>advanced matching of user data<\/li><li>Event queuing for optimal performance<\/li><li>debugging and integration testing<\/li><\/ul><h6><br \/>2 Installation<\/h6><strong>System requirements<\/strong><ul><li>WordPress 5.0 or later<\/li><li>PHP 7.0 or later<\/li><\/ul><strong>Installation process<\/strong><ol><li>Download the ZIP file of the plug-in from <a href=\"https:\/\/iarina029.supserv.cozmoslabs.com\/en\/\" title=\"Official Store\">official store<\/a><\/li><li>Log in to your WordPress admin panel<\/li><li>Go to: <strong>Plugins &gt; Add New &gt; Submit Plugin<\/strong><\/li><li>Select the downloaded ZIP file and click \"Install Now\".<\/li><li>When the installation is complete, click \"Enable plug-in\"<\/li><\/ol><h6><br \/>3. license activation<\/h6>It is necessary to activate the license before using the plug-in:<br \/><ol><li>After installation, go to the tab <strong>Settings &gt; Facebook Pixel<\/strong><\/li><li>Click the tab <strong>License<\/strong><\/li><li>Enter the license key you received after purchase<\/li><li>Click \"Activate License\"<\/li><li>After successful activation, you will see a confirmation message<\/li><\/ol><div class=\"cc-alert cc-alert-warning\"><div class=\"cc-alert-title\">Warning<\/div><div class=\"cc-alert-content\">Without an active license, the plug-in will work in limited mode, without the ability to edit settings and configure tracking.<\/div><\/div><h6><br \/>4. basic configuration<\/h6>To configure the basic settings of the plugin:<br \/><ol><li>Go to: <strong>Settings &gt; Facebook Pixel<\/strong><\/li><li>In the \"Main settings\" section, enter your Facebook Pixel ID<\/li><li>Select the tracking mode (Browser only, Server only, Hybrid)<\/li><li>Enable or disable standard events<\/li><li>Click \"Save Changes.\"<\/li><\/ol><div class=\"cc-code-quote\"><pre><code>\/\/ Example Facebook Pixel ID\r\n123456789012345<\/code><\/pre><\/div><div class=\"cc-alert cc-alert-tip\"><div class=\"cc-alert-title\">Tip<\/div><div class=\"cc-alert-content\">The Facebook Pixel ID can be found in the Facebook Events Manager in the Pixel settings section.<\/div><\/div><h6><br \/>5. tracking modes<\/h6>The plug-in offers three tracking modes that can be selected according to your needs:<br \/><br \/><strong>Browser only (JavaScript Pixel)<\/strong><br \/>In this mode, events are sent only through the JavaScript Pixel in the user's browser. This is a classic tracking method that can be blocked by adblocks.<br \/><br \/><strong>Server only (Conversions API)<\/strong><br \/>In this mode, events are sent only by the server using Facebook Conversions API. This is a more reliable way of tracking that is not blocked by adblockers, but requires additional configuration.<br \/><br \/><strong>Hybrid (browser + server with deduplication)<\/strong><br \/>In this mode, events are sent through both JavaScript Pixel and Conversions API, with a deduplication mechanism that prevents double counting of events. This mode provides the highest tracking accuracy.<br \/><div class=\"cc-alert cc-alert-info\"><div class=\"cc-alert-title\">Info<\/div><div class=\"cc-alert-content\">Hybrid mode is recommended for most sites because it combines the advantages of both tracking methods, providing greater accuracy of conversion data.<\/div><\/div><h6><br \/>6. server-side tracking<\/h6>To set up server-side tracking (Conversions API):<br \/><ol><li>Make sure \"Server only\" or \"Hybrid\" mode is selected.<\/li><li>In the \"Server-Side API Tracking\" section, enter the Access Token<\/li><li>Optionally, enable test mode and enter the test event code<\/li><\/ol><div class=\"cc-alert cc-alert-warning\"><div class=\"cc-alert-title\">Warning<\/div><div class=\"cc-alert-content\">Access Token is a confidential key that should be protected. Do not share it with third parties and do not place it in public places.<\/div><\/div><strong>Obtaining an Access Token<\/strong><ol><li>Go to <a href=\"https:\/\/business.facebook.com\/events_manager2\/\" title=\"Event Manager In Business.facebook.com\" target=\"_blank\" rel=\"noopener\">Event Manager at business.facebook.com<\/a><\/li><li>Choose <strong>\"Data Sources\".<\/strong><\/li><li>Go to <strong>\"Settings\"<\/strong><\/li><li>In the section <strong>\"Configure direct integration\".<\/strong> select link <strong>\"Generate access token\".<\/strong> generate an API access token<\/li><\/ol>If you haven't yet created a Pixel, we recommend checking out the article on our blog: <a href=\"https:\/\/iarina029.supserv.cozmoslabs.com\/en\/articles\/how-to-create-and-deploy-facebook-pixel-on-your-website\/\" title=\"How to Create and Implement a Facebook Pixel on Your Website.\"><strong>How to create and implement a Facebook Pixel on your website<\/strong><\/a><br \/><h6><br \/>7. event queuing<\/h6>The event queuing function allows deferral of server-side event processing, which significantly improves site performance:<br \/><ol><li>In the \"Server-Side API Tracking\" section, enable the \"Event Queuing\" option.<\/li><li>Go to the \"Event Queue\" tab to configure and monitor the queue<\/li><\/ol><strong>Configure a cron job<\/strong><br \/>For optimal performance, we recommend setting up a cron job on the server:<br \/><ol><li>In the \"Event Queue\" tab, copy the URL to cron<\/li><li>Add a cron task on the server that will call this URL every 5 minutes<\/li><\/ol><div class=\"cc-code-quote\"><pre><code>\/\/ Example cron command for wget\r\n*\/5 * * * * wget -q -O \/dev\/null https:\/\/demo.cocos.codes\/cc_facebook_pixel?cc_facebook_pixel_cron=1&amp;key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX &gt;\/dev\/null 2&gt;&amp;1<br \/>\r\n\/\/ Example cron command for curl\r\n*\/5 * * * * curl -s https:\/\/demo.cocos.codes\/cc_facebook_pixel?cc_facebook_pixel_cron=1&amp;key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX &gt;\/dev\/null 2&gt;&amp;1<br \/><\/code><\/pre><\/div><div class=\"cc-alert cc-alert-note\"><div class=\"cc-alert-title\">Note<\/div><div class=\"cc-alert-content\">Event queuing also works without an external cron job, using the built-in WordPress Cron mechanism, but an external cron job provides more reliable and timely event processing.<\/div><\/div><h6><br \/>8. custom events<\/h6>The plugin allows you to add custom JavaScript events:<br \/><ol><li>In the \"Custom Events\" section, enter your own event code<\/li><li>Choose where to insert the code (header or footer of the page)<\/li><\/ol><div class=\"cc-code-quote\"><pre><code>\/\/ Example code for a custom event\r\nfbq('track', 'MyEvent', {\r\n   parameter1: 'value1',\r\n   parameter2: 'value2'\r\n});<\/code><\/pre><\/div><div class=\"cc-alert cc-alert-warning\"><div class=\"cc-alert-title\">Warning<\/div><div class=\"cc-alert-content\">In \"Server Only\" mode, custom JavaScript events will not be sent because Facebook Pixel code is not injected into the page then. Change the tracking mode to \"Hybrid\" or \"Browser Only\" if you want to use custom JavaScript events.<\/div><\/div><h6><br \/>9. advanced matching<\/h6>Advanced matching allows additional user data to be sent to Facebook, improving tracking efficiency:<br \/><ol><li>In the \"Advanced Matching\" section, enable the \"Enable Advanced Matching\" option.<\/li><li>Check the boxes of the user data you want to transfer:<\/li><\/ol><ul><li>Email<\/li><li>Phone<\/li><li>Name<\/li><li>Name<\/li><li>City<\/li><li>Province<\/li><li>Zip code<\/li><li>Country<\/li><\/ul><div class=\"cc-alert cc-alert-tip\"><div class=\"cc-alert-title\">Tip<\/div><div class=\"cc-alert-content\">Advanced matching works best when users are logged into your site. For non-logged-in users, the plugin will try to retrieve data from the forms they fill out.<\/div><\/div><h6><br \/>10. debugging<\/h6>The plugin offers powerful debugging tools to help troubleshoot Facebook Pixel integration issues:<br \/><ol><li>In the \"Debugging Settings\" section, enable the option \"Enable debugging mode\"<\/li><li>Go to the \"Debugging\" tab to access the debugging tools<\/li><\/ol><strong>Debugging tools<\/strong><ul><li><strong>Test Server-Side API<\/strong> - sends a test event through the Conversions API<\/li><li><strong>Test JavaScript Pixel<\/strong> - opens a page with an active JavaScript Pixel<\/li><li><strong>API Logs<\/strong> - displays API request and response logs<\/li><\/ul><div class=\"cc-alert cc-alert-tip\"><div class=\"cc-alert-title\">Tip<\/div><div class=\"cc-alert-content\">In debug mode, the plug-in generates detailed logs that can be used to diagnose problems. The logs are saved in the directory <strong>\/wp-content\/uploads\/cc-facebook-pixel-logs\/.<\/strong>.<\/div><\/div><h6><br \/>11 Troubleshooting<\/h6><strong>Events are not sent<\/strong><ul><li>Verify that the correct Facebook Pixel ID has been entered<\/li><li>Make sure the license is active<\/li><li>Check if the selected tracking mode is suitable for your needs<\/li><li>For server-side tracking, validate the Access Token<\/li><li>Turn on debug mode and check the logs<\/li><\/ul><strong>Problems with event queuing<\/strong><ul><li>Make sure that WordPress Cron is working properly<\/li><li>Consider setting up an external cron job<\/li><li>Verify that the server has the proper permissions to send HTTP requests<\/li><\/ul><strong>Problems with Conversions API<\/strong><ul><li>Verify that the Access Token is correct and active<\/li><li>Make sure the correct version of the API is selected<\/li><li>Turn on test mode and check that test events are sent correctly<\/li><li>Check API logs to identify potential problems<\/li><\/ul><h6><br \/>12 FAQS.<\/h6><strong>What is the Facebook Pixel?<\/strong><br \/>Facebook Pixel is an analytics tool that allows you to track user activity on your website and use that data to target ads on Facebook, Instagram and the Audience Network ad network.<br \/><br \/><strong>What is the difference between JavaScript Pixel and Conversions API?<\/strong><br \/>JavaScript Pixel runs in the user's browser and can be blocked by adblocks. Conversions API runs on the server side and cannot be blocked by adblocks, providing more reliable conversion tracking.<br \/><br \/><strong>Can I use the plugin without an active license?<\/strong><br \/>The plug-in will work in restricted mode without an active license, allowing you to preview settings, but you will not be able to edit the configuration or use advanced features.<br \/><br \/><strong>Does the plug-in slow down the loading of the page?<\/strong><br \/>The plugin has been optimized for performance. The server-side event queuing feature significantly reduces the impact on page loading time.<br \/><br \/><strong>Is the plug-in compliant with RODO\/GDPR?<\/strong><br \/>The plugin itself does not collect personal data, but it does allow data to be sent to Facebook. It is the site owner's responsibility to ensure compliance with RODO\/GDPR, including obtaining appropriate consents from users.<br \/><br \/><strong>Can I exclude specific users from tracking?<\/strong><br \/>Yes, in the \"Debugging settings\" section you can select user roles that will be excluded from tracking.<br \/><br \/><strong>How can I check if Facebook Pixel is working properly?<\/strong><br \/>Enable debug mode and use debug tools to test the integration. You can also use the extension <a href=\"https:\/\/chromewebstore.google.com\/detail\/meta-pixel-helper\/fdgfkebogiimcoedlicjlajpkdmockpc\" title=\"Facebook Pixel Helper\" target=\"_blank\" rel=\"noopener\"><strong>Facebook Pixel Helper<\/strong><\/a> For Chrome browser.<br \/><br \/><strong>What happens if I turn off event queuing?<\/strong><br \/>Server-side events will be processed synchronously, which can slow down page loading, especially with heavy traffic.<br \/><br \/><strong>Where can I get help if I have problems with the plug-in?<\/strong><br \/>Technical support is available to license holders. Contact us via <a href=\"https:\/\/iarina029.supserv.cozmoslabs.com\/en\/support\/\" title=\"Support Page\">support page<\/a>.","protected":false},"excerpt":{"rendered":"Word Press Meta Facebook Pixel Documentation Comprehensive documentation for the cc_facebook_pixel plugin. Table of Contents 1. Introduction 2. Installation 3. License activation 4. Basic configuration 5. Tracking modes 6. Server-side tracking 7.","protected":false},"author":1,"featured_media":3692,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"powered_cache_disable_cache":false,"powered_cache_disable_css_optimization":false,"powered_cache_disable_js_optimization":false,"footnotes":""},"categories":[196],"tags":[197,209,235,210,211,144],"class_list":["post-3623","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-dokumentacje","tag-dokumentacja","tag-facebook","tag-integracja","tag-meta","tag-pixel","tag-wordpress"],"_links":{"self":[{"href":"https:\/\/iarina029.supserv.cozmoslabs.com\/en\/wp-json\/wp\/v2\/posts\/3623","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/iarina029.supserv.cozmoslabs.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/iarina029.supserv.cozmoslabs.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/iarina029.supserv.cozmoslabs.com\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/iarina029.supserv.cozmoslabs.com\/en\/wp-json\/wp\/v2\/comments?post=3623"}],"version-history":[{"count":0,"href":"https:\/\/iarina029.supserv.cozmoslabs.com\/en\/wp-json\/wp\/v2\/posts\/3623\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/iarina029.supserv.cozmoslabs.com\/en\/wp-json\/wp\/v2\/media\/3692"}],"wp:attachment":[{"href":"https:\/\/iarina029.supserv.cozmoslabs.com\/en\/wp-json\/wp\/v2\/media?parent=3623"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/iarina029.supserv.cozmoslabs.com\/en\/wp-json\/wp\/v2\/categories?post=3623"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/iarina029.supserv.cozmoslabs.com\/en\/wp-json\/wp\/v2\/tags?post=3623"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}