pixelyoursite
Last commit date
css
10 years ago
inc
10 years ago
js
10 years ago
facebook-pixel-master.php
10 years ago
readme.txt
10 years ago
readme.txt
222 lines
| 1 | ===Facebook Pixel by PixelYourSite - Standard Events & WooCommerce=== |
| 2 | Contributors: PixelYourSite, c0d3fev3r |
| 3 | 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 |
| 4 | Requires at least: 3.0.1 |
| 5 | Tested up to: 4.5.1 |
| 6 | Stable tag: 2.2.4 |
| 7 | License: GPLv3 |
| 8 | License URI: http://www.gnu.org/licenses/gpl-3.0.html |
| 9 | |
| 10 | Insert the new Facebook Pixel on WordPress, add Standard Events, enjoy superb WooCommerce Facebook Pixel integration |
| 11 | |
| 12 | == Description == |
| 13 | As you probably know, Facebook will retire the old Facebook Conversion Pixel in 2016. They recommend to use the new Facebook Pixel for conversion tracking, optimization and remarketing. **This plugin will help you insert the pixel code on every page with just one click and setup 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. |
| 14 | |
| 15 | **Visit this page for [more details about how to use the pixel plugin: Click here](http://www.pixelyoursite.com/facebook-pixel-plugin-help)** |
| 16 | |
| 17 | * You can **insert the pixel on every page of your website with just a few clicks**. No need to edit any post or pages |
| 18 | |
| 19 | * You can **set up and track Standard or Custom Events** and add parameters for each of them |
| 20 | |
| 21 | * Track **conversion value** for standard or custom events |
| 22 | |
| 23 | * You can **insert the Facebook pixel and start tracking events on any WooCommerce** website with just a few clicks (Purchase, ViewContent, AddToCart, InitiateCheckout) |
| 24 | |
| 25 | * **Dynamic AddToCart** is fully supported (the AddToCart event will fire on add to cart button click) |
| 26 | |
| 27 | * **Search Event** on the search page with the search string as parameter |
| 28 | |
| 29 | * **Dynamic Events:** optimize your Facebook Campaigns for actions on your website (clicks on links, buttons, forms). Works with **Contact Form 7** and other form or pop-up plugins. ([Pro Version](http://www.pixelyoursite.com)) |
| 30 | |
| 31 | * **Track conversion value for WooCommerce** ([Pro Version](http://www.pixelyoursite.com)) |
| 32 | |
| 33 | * Out of the box **Facebook Dynamic Ads** setup for your Woocommerce website ([Pro Version](http://www.pixelyoursite.com)) |
| 34 | |
| 35 | * **WooCommerce Affiliate Products Events:** you can add a dynamic event that will trigger on affiliate button clicks ([Pro Version](http://www.pixelyoursite.com)) |
| 36 | |
| 37 | * **WooCommerce PayPal Standard Events:** you can add a dynamic event that will trigger on WooCommerce PayPal button clicks ([Pro Version](http://www.pixelyoursite.com)) |
| 38 | |
| 39 | - Fully tested with WooCommerce 2.5 and above |
| 40 | |
| 41 | |
| 42 | **What's next** |
| 43 | |
| 44 | PixelYourSite 3.0 will be here soon with some exciting new features. |
| 45 | |
| 46 | **Important:** |
| 47 | |
| 48 | If you are testing your pixel with Pixel Helper Chrome extension you will see some **false** errors: |
| 49 | |
| 50 | Facebook Pixel did not load. |
| 51 | Event ID: AddToCart |
| 52 | |
| 53 | You can safely ignore them. It is a normal error trigger by the dynamic AddToCart event, that will disappear after you click on the add to cart button. |
| 54 | |
| 55 | For more details on Facebook Pixel errors [read this article](http://www.pixelyoursite.com/facebook-pixel-helper-errors) |
| 56 | |
| 57 | **Instal the plugin now, because it is easy to use, and will help you with your Facebook campaigns.** |
| 58 | |
| 59 | == Installation == |
| 60 | * From the WP admin panel, click \"Plugins\" -> \"Add new\". |
| 61 | * In the browser input box, type \"PixelYourSite\". |
| 62 | * Select the \"PixelYourSite\" plugin (authored by \"PixelYourSite\"), and click \"Install\". |
| 63 | * Activate the plugin. |
| 64 | |
| 65 | OR... |
| 66 | |
| 67 | * Download the plugin from this page. |
| 68 | * Save the .zip file to a location on your computer. |
| 69 | * Open the WP admin panel, and click \"Plugins\" -> \"Add new\". |
| 70 | * Click \"upload\".. then browse to the .zip file downloaded from this page. |
| 71 | * Click \"Install\".. and then \"Activate plugin\". |
| 72 | |
| 73 | OR... |
| 74 | |
| 75 | * Download the plugin from this page. |
| 76 | * Extract the .zip file to a location on your computer. |
| 77 | * Use either FTP or your hosts cPanel to gain access to your website file directories. |
| 78 | * Browse to the `wp-content/plugins` directory. |
| 79 | * Upload the extracted `wp_edit` folder to this directory location. |
| 80 | * Open the WP admin panel.. click the \"Plugins\" page.. and click \"Activate\" under the newly added plugin. |
| 81 | |
| 82 | |
| 83 | == Frequently Asked Questions == |
| 84 | We maintain an up to date FAQ page on our site: |
| 85 | |
| 86 | <strong><a href="http://www.pixelyoursite.com/facebool-pixel-master-faq" target="_blank"><span style="color:#DE4D4D;">Click here for the FAQ page</span></a></strong> |
| 87 | |
| 88 | **Do I need to copy/paste the Facebook Pixel code somewhere?** |
| 89 | |
| 90 | No, you just have to enter your pixel ID in the dedicated filed. The plugin will do the rest for you. |
| 91 | |
| 92 | **Where can I find the Facebook Pixel ID?** |
| 93 | |
| 94 | There are multiple ways to do that. One simple method is to: |
| 95 | |
| 96 | * Go to your Facebook Pixel tab in Ads Manager |
| 97 | * You will find the Facebook Pixel ID on the right side of the page |
| 98 | |
| 99 | **What happens when I activate the plugin general settings?** |
| 100 | |
| 101 | a. The pixel code will be added on every page of your site |
| 102 | |
| 103 | b. A "Search" standard event will be added on the search page of your site |
| 104 | |
| 105 | c. A "CompleteRegistration" event will be added on the user complete registration page |
| 106 | |
| 107 | **What happens when I activate the WooCommerce Setup?** |
| 108 | |
| 109 | ViewContent is added on the product pages |
| 110 | AdToCart event is added on the cart page |
| 111 | AddToCart events is activated on add to cart button click |
| 112 | InitiateCheckout event is added on the Checkout page |
| 113 | Purchase event is added on the Thank You page |
| 114 | |
| 115 | **Can I define new standard events?** |
| 116 | |
| 117 | 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. |
| 118 | |
| 119 | **Can I have more then just one event on a page?** |
| 120 | |
| 121 | Yes, you can! It is up to you. |
| 122 | |
| 123 | **Can I use your plugin for Facebook Dynamic Ads?** |
| 124 | |
| 125 | Yes, the PRO version of our plugin is design to help you use Facebook Dynamic Ads for a WooCommerce website. |
| 126 | |
| 127 | **Are there any known incompatibilities with other themes or plugins?** |
| 128 | |
| 129 | Any program, service, code or plugin that adds the Pixel Code, since you can't have to similar pixels on a page. |
| 130 | |
| 131 | * We had a problem with Mamaya, a retargeting service |
| 132 | * It won't work with LeadPages or any similar system, because that pages are generated outside WordPress |
| 133 | |
| 134 | If any incompatibilities will arise we will add them here and, of course, will try to fix them as soon is possible. |
| 135 | |
| 136 | **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?** |
| 137 | |
| 138 | We have an article about how to optimize Facebook Ads Reports: |
| 139 | <strong><a href="http://www.pixelyoursite.com/facebook-ads-reports-optimisation" target="_blank"><span style="color:#DE4D4D;">How to optimize your Facebook Ads Reports for events tracking</span></a></strong> |
| 140 | |
| 141 | == Screenshots == |
| 142 | |
| 143 | 1. Add your Facebook Pixel ID and the plugin will insert the code on every page |
| 144 | 2. You can define Standard events on any URL of your website. Select event type and customize it |
| 145 | 3. You can add a customize event code on any page |
| 146 | 4. This is an active Standard Event tested with Pixel Helper |
| 147 | 5. Activate Standard events for WooCommerce (ViewContent, AddToCard, InitiateCheckout, Purchase) |
| 148 | 6. This is a VieContent Event. It will be active on all WooCommerce product pages |
| 149 | 7. This is a dynamic AddToCart. It will trigger when the add to cart button is clicked |
| 150 | 8. This is a InitiateCheckout event on Checkout WooCommerce page |
| 151 | 9. This is a Purchase event on WooCommerce Thank You page. You can optimize your Facebook Campaigns for this event |
| 152 | |
| 153 | == Changelog == |
| 154 | |
| 155 | PixelYourSite 2.2.4 |
| 156 | |
| 157 | - Fixig a few back-end errors and conflicts |
| 158 | |
| 159 | - Adding new currencies |
| 160 | |
| 161 | PixelYourSite 2.2.3 |
| 162 | |
| 163 | - Learning links updated |
| 164 | |
| 165 | - Minor PHP warning fixed |
| 166 | |
| 167 | PixelYourSite 2.2.2 |
| 168 | |
| 169 | - Minor fix for admin notice |
| 170 | |
| 171 | PixelYourSite 2.2.1 |
| 172 | |
| 173 | - Fixing not closing admin notice error |
| 174 | |
| 175 | |
| 176 | PixelYourSite 2.2 |
| 177 | |
| 178 | - Introducing Dynamic Events (pro) |
| 179 | |
| 180 | - Introducing our new Learning Section |
| 181 | |
| 182 | PixelYourSite 2.1 |
| 183 | |
| 184 | - Introducing new WooCommerce Paypal Standard events (pro) |
| 185 | |
| 186 | PixelYourSite 2.0 |
| 187 | |
| 188 | - This update adds full control on Standard Events, with the possibility to define all the availeable parameters for each event |
| 189 | |
| 190 | - You can also add the code for each event with the new event text field. This also lets you define custom events |
| 191 | |
| 192 | - WooCommerce Affiliate Products events: you can define events that will trigger on affiliate buttons clicks |
| 193 | |
| 194 | - Fixed a potential error for the WooCommerce Purchase Event |
| 195 | |
| 196 | PixelYourSite 1.05 |
| 197 | |
| 198 | - Updated offer for the PRO version |
| 199 | |
| 200 | PixelYourSite 1.04 |
| 201 | |
| 202 | - Fixed fresh install error (when no settings saved) |
| 203 | |
| 204 | PixelYourSite 1.03 |
| 205 | |
| 206 | - Fixed "Select options" error for variable products on categories pages |
| 207 | |
| 208 | PixelYourSite 1.02 |
| 209 | |
| 210 | - Fixed currency symbol error |
| 211 | - Added super special offer for the PRO version |
| 212 | |
| 213 | PixelYourSite 1.01 |
| 214 | |
| 215 | - Dynamic AddToCart event for WooCommerce (the AddToCart event will trigger when a users click on the add to cart button) |
| 216 | - Dynamic AddToCart works with WooCommerce shortcodes. |
| 217 | - Fixed a false error that was reported for the Purchase WooCommerce event by Pixel Helper extension on the Thank You page. |
| 218 | |
| 219 | |
| 220 | == Upgrade Notice == |
| 221 | |
| 222 | - The admin message had an error and was not possible to dismiss it. This update is a fix for the problem. |