===Facebook Pixel by PixelYourSite - Standard Events & WooCommerce=== Contributors: PixelYourSite, c0d3fev3r, themister Tags: Facebook Pixel, New Facebook Pixel, Facebook Conversion Pixel, Facebook Pixel Events, Facebook, New Facebook Pixel Events, Dynamic Events, Standard Events, Facebook Events, Facebook Standard Events, Facebook Dynamic Product Ads, WooCommerce, WooCommerce Facebook Pixel, Facebook Custom Events, Facebook Conversion Value, WooCommerce Affiliate Products, Facebook Pixel PayPal Requires at least: 3.0.1 Tested up to: 4.5.2 Stable tag: 3.0 License: GPLv3 License URI: http://www.gnu.org/licenses/gpl-3.0.html Insert the new Facebook Pixel on WordPress, add Standard Events, enjoy superb WooCommerce Facebook Pixel integration == Description == Manage the New Facebook Pixel With Just a Few Clicks
As you probably know, Facebook will retire the old Facebook Conversion Pixel in 2016. They recommend us to use the New Facebook Pixel for conversion tracking, optimization and remarketing. **PixelYourSite will help you insert the pixel code on every page with just one click** and set up Custom or Standard Events on any page or post. There is an **out of the box WooCommerce setup** that will configure all the necessary standard events for you. **Facebook Dynamic Ads are fully supported on WooCommerce**, with ViewContent, AddToCart and Purchase events being added on the corresponding pages (content_ids and content_type are pulled automatically by the plugin). The plugin is **Custom Audience super-friendly**, extracting content_name, content_type, content_ids on every page of your site. We also have a guide that you can download for free on how to handle this option and how to build Custom Audiences. There is a **[Learning Section](http://www.pixelyoursite.com/learn)** on our website, with helpful articles that answer to our users common (and sometimes uncommon) questions, together with top notch “how to”pages. Find more info [about how to use the FB pixel plugin - Click here](http://www.pixelyoursite.com/facebook-pixel-plugin-help) Not ready to install yet? Read on some of the key features that make PYS a powerful tool in any Facebook marketer arsenal. PixelYourSite Key Features:
* You can **insert the pixel on every page of your website with just a few clicks**. No need to edit any posts or pages * **Search Event** on the search page with the search string pulled as parameter - super useful for creating search based Custom Audiences * You can turn ON/OFF the pixel based on user roles (remove it for admins, editors and so on) * You can **set up and track Standard or Custom Events** and add parameters for each of them * **Dynamic Events:** optimize your Facebook Campaigns for actions on your website (CLICKS on links, buttons, forms). Works with **Contact Form 7** and any other form or pop-up plugins. ([Pro Version](http://www.pixelyoursite.com)) * Track **conversion value** for standard or custom events * We automatically add a TimeOnPage event that measures the time each visitor spends on every page. It can be used for Custom Audiences ([Pro Version](http://www.pixelyoursite.com)) * You have a General Event option that you can customize. It is triggered on every page and automatically tracks content_type, content_id and content_name. Extremely useful for Custom Audiences > How to create powerful Custom Audiences with PixelyourSite > You can use the General Event option to create powerful Custom Audiences based on events (Custom Combination). > Because this is such a useful feature, we made a special guide that you can download for free: [Click here for the guide](http://www.pixelyoursite.com/general-event) Superb WooCommerce Integration
* You can **insert the Facebook pixel and start tracking events on any WooCommerce** website with just a few clicks (Purchase, ViewContent, AddToCart, InitiateCheckout) * Out of the box **Facebook Dynamic Ads** setup for your Woocommerce website (we also have a dedicated feed plugin for Facebook Dynamic Ads Product Catalog) * **Dynamic AddToCart** is fully supported (the AddToCart event will fire on add to cart button click) * **Track conversion value for WooCommerce** ([Pro Version](http://www.pixelyoursite.com)) * **WooCommerce Conversion Value Optimization:** You can include or exclude TAX for all the WooCommere events and Shipping cost for the Purchase event. You can use the full product price or just a percent of the price for each event Value. You can also set a general value for each event. * You can turn ON/OFF each WooCommerce event. * You can turn ON/OFF value for each WooCommerce event. * **Super Powerful Custom Audiences for WooCommerce:** we automatically track product name and product category (you can create audiences based on them), together with customer's city, state and country. Additionally we track payment and shipping methods. Use of coupons and coupon names are also automatically extracted. With this data you can unleash some fantastic retargeting campaigns based on highly granulated audiences. ([Pro Version](http://www.pixelyoursite.com)) * **Advance Matching** is supported for the Purchase Event - this is a useful feature from Facebook that increases the chances to correctly identify users visiting your website without being logged to their Facebook accounts ([Pro Version](http://www.pixelyoursite.com)) * **WooCommerce Affiliate Products Events:** you can add a dynamic event that will trigger on affiliate button clicks ([Pro Version](http://www.pixelyoursite.com)) * **WooCommerce PayPal Standard Events:** you can add a dynamic AddPaymentInfo event that will trigger on WooCommerce PayPal button clicks ([Pro Version](http://www.pixelyoursite.com)) * Fully tested with WooCommerce 2.6 and above What's next We are working on some new handy features for the plugin and we will release them soon. Pixel Helper False Errors If you are testing your pixel with Pixel Helper Chrome Extension, it is possible that you will see some **false** errors: **Event ID: AddToCart**: Facebook Pixel did not load. You can safely ignore it. It is a normal error trigger by the dynamic AddToCart event that will disappear after you click on the add to cart button. **Event ID: GeneralEvent**: Content_type is missing, should be either 'product' or 'product_group' You can safely ignore it. It’s a Dynamic Ads warning, but this event is not meant to be used for Dynamic Ads. It is completely dedicated to Custom Audiences and works perfectly. If you are using WooCommerce, there is a ViewContent event fully ready for the Dynamic Ads job. For more details on how to use Facebook Pixel Helper and how to interpret its reported errors [read this special article](http://www.pixelyoursite.com/facebook-pixel-helper-errors) **Let’s start now!** Join other thousands of users and instal the plugin, because it is easy to use, and will help you with your Facebook campaigns for real == Installation == * From the WP admin panel, click \"Plugins\" -> \"Add new\". * In the browser input box, type \"PixelYourSite\". * Select the \"PixelYourSite\" plugin (authored by \"PixelYourSite\"), and click \"Install\". * Activate the plugin. OR... * Download the plugin from this page. * Save the .zip file to a location on your computer. * Open the WP admin panel, and click \"Plugins\" -> \"Add new\". * Click \"upload\".. then browse to the .zip file downloaded from this page. * Click \"Install\".. and then \"Activate plugin\". OR... * Download the plugin from this page. * Extract the .zip file to a location on your computer. * Use either FTP or your hosts cPanel to gain access to your website file directories. * Browse to the `wp-content/plugins` directory. * Upload the extracted `wp_edit` folder to this directory location. * Open the WP admin panel.. click the \"Plugins\" page.. and click \"Activate\" under the newly added plugin. == Frequently Asked Questions == We maintain an up to date FAQ page on our site: Click here for the FAQ page **Do I need to copy/paste the Facebook Pixel code somewhere?** No, you just have to enter your pixel ID in the dedicated filed. The plugin will do the rest for you. **Where can I find the Facebook Pixel ID?** There are multiple ways to do that. One simple method is to: * Go to your Facebook Pixel tab in Ads Manager * You will find the Facebook Pixel ID on the right side of the page **What happens when I activate the plugin general settings?** a. The pixel code will be added on every page of your site b. A "Search" standard event will be added on the search page of your site c. A GeneralEvent will be added on every page, pulling content_name, content_ids and content_type. It can be used for Custom Audiences. **What happens when I activate the WooCommerce Setup?** ViewContent is added on the product pages AdToCart event is added on the cart page AddToCart events is activated on add to cart button click InitiateCheckout event is added on the Checkout page Purchase event is added on the Thank You page **Can I define new standard events?** Yes, you can! There is a simple menu where you can do that. You'll need to add an URL and select the event type you want to add. If necessary, you can give each event a monetary value and its own currency. **Can I have more than just one event on a page?** Yes, you can! You can have any number of events you want on a page. **Can I use your plugin for Facebook Dynamic Ads?** Yes, you can! Facebook Dynamic Product Ads are fully supported for WooCommerce. We plan to add a similar integration for Easy Digital Downoads soon. **Are there any known incompatibilities with other themes or plugins?** Any program, service, code or plugin that adds the Pixel Code, since you can't have to similar pixels on a page. * We had a problem with Mamaya, a retargeting service * It won't work with LeadPages or any similar system, because that pages are generated outside WordPress If any incompatibilities will arise we will add them here and, of course, will try to fix them as soon is possible. **I have the pixel installed on my website and I am running a Facebook Campaign, but the reports are confusing me. How can I see my campaign results?** We have an article about how to optimize Facebook Ads Reports: How to optimize your Facebook Ads Reports for events tracking == Screenshots == 1. Add your Facebook Pixel ID and the plugin will insert the code on every page of your website 2. You don’t have to copy/paste all the pixel code, but just the pixel ID. You can find it in your Ads Manager, under Pixels 3. The Search Event will pull each search on your site as a parameter. You can use it to create Custom Audiences 4. The GeneralEvent is triggered on every page and can be used for Custom Audiences. We have a free guide on how to use it, liked from the plugin itself 5. Adding events on any URL of any page of your website is easy: just add the URL, select event type and fill the desired parameters values 6. If you want you can insert a custom event code 7. Or you can select a standard event and use the default parameters 8. WooCommerce integration comes with out of the box Facebook Dynamic Ads setup 9. These are the normal events on a WooCommerce thank you page: the Purchase event has content_ids and content_types (required by Dynamic Ads). The reported error for the GeneralEvent can be ignored (as explained in the help pages) == Changelog == = PixelYourSite 3.0 = This is a major release, with new design and new features: * Completely new design * New GeneralEvent feature for improved Custom Audience building (with a free guide) * ON/OFF option for user roles * Improved Events and Dynamic Events control * Facebook Dynamic Ads Pixel Setup for WooCommerce = PixelYourSite 2.2.4 = * Fixig a few back*end errors and conflicts * Adding new currencies = PixelYourSite 2.2.3 = * Learning links updated * Minor PHP warning fixed = PixelYourSite 2.2.2 = * Minor fix for admin notice = PixelYourSite 2.2.1 = * Fixing not closing admin notice error = PixelYourSite 2.2 = * Introducing Dynamic Events (pro) * Introducing our new Learning Section = PixelYourSite 2.1 = * Introducing new WooCommerce Paypal Standard events (pro) = PixelYourSite 2.0 = * This update adds full control on Standard Events, with the possibility to define all the available parameters for each event * You can also add the code for each event with the new event text field. This also lets you define custom events * WooCommerce Affiliate Products events: you can define events that will trigger on affiliate buttons clicks * Fixed a potential error for the WooCommerce Purchase Event = PixelYourSite 1.05 = * Updated offer for the PRO version = PixelYourSite 1.04 = * Fixed fresh install error (when no settings saved) = PixelYourSite 1.03 = * Fixed "Select options" error for variable products on categories pages = PixelYourSite 1.02 = * Fixed currency symbol error * Added super special offer for the PRO version = PixelYourSite 1.01 = * Dynamic AddToCart event for WooCommerce (the AddToCart event will trigger when a users click on the add to cart button) * Dynamic AddToCart works with WooCommerce shortcodes. * Fixed a false error that was reported for the Purchase WooCommerce event by Pixel Helper extension on the Thank You page. = PixelYourSite 1.0 = * A new plugin is borne: It will let you manage the Facebook Pixel with just a few clicks == Upgrade Notice == = 3.0 = 3.0 is a complete rewrite, with a new design and improve functionality. You have a new GeneralEvent that can be used to create Custom Audiences (plus a FREE guide on how to do it!) and Facebook Dynamic Ads are fully supported for WooCommerce. Update, then open the plugin menu for details