pixelyoursite
Last commit date
dist
5 years ago
includes
5 years ago
modules
5 years ago
notices
5 years ago
pixelyoursite
6 years ago
vendor
5 years ago
composer.json
5 years ago
composer.lock
5 years ago
facebook-pixel-master.php
5 years ago
pixelyoursite.php
5 years ago
readme.txt
5 years ago
readme.txt
807 lines
| 1 | ===PixelYourSite - Your smart PIXEL (TAG) Manager=== |
| 2 | Contributors: PixelYourSite, themister |
| 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, Easy Digital Downloads Pixel, Easy Digital Downloads Google Analytics, Head & Footer scripts, Enhanced Ecommerce, Pinterest tag |
| 4 | Requires at least: 3.0.1 |
| 5 | Requires PHP: 5.4 |
| 6 | Tested up to: 5.4 |
| 7 | Stable tag: 7.1.9 |
| 8 | License: GPLv3 |
| 9 | License URI: http://www.gnu.org/licenses/gpl-3.0.html |
| 10 | |
| 11 | Facebook Pixel, Google Analytics, plus ANY other script. WooCommerce and EDD with Facebook Dynamic Product Ads and Google Enhanced Ecommerce. Track any action with events. Pinterest Tag support via a free add-on. Dedicated paid Bing Tag add-on. |
| 12 | |
| 13 | == Description == |
| 14 | **Manage your Facebook Pixel or Google Analytics code with a single plugin and add ANY other script (Head & Footer feature). The Pinterest Tag can be implemented via [free add-on](https://www.pixelyoursite.com/pinterest-tag).** |
| 15 | |
| 16 | PixelYourSite Global Events will automatically track important actions and send them to all your configured pixels (searches, form submit, comments, downloads). |
| 17 | |
| 18 | You can fire your own events with zero coding. |
| 19 | |
| 20 | **WooCommerce** and **Easy Digital Downloads** are fully supported, with Facebook Dynamic Ads pixel setup and Google Analytics Enhanced Ecommerce. |
| 21 | |
| 22 | Take a look at this video to see the plugin in action: |
| 23 | |
| 24 | [youtube https://www.youtube.com/watch?v=OUHU9lZ2lwQ] |
| 25 | |
| 26 | NEW: Facebook Pixel server-side events for WooCommerce (Purchase and CompleteRegistration): [Learn how to configure server-side events](https://www.pixelyoursite.com/documentation/configure-server-side-events) |
| 27 | |
| 28 | TRACK EVERYTHING WITH A SINGLE PLUGIN: |
| 29 | |
| 30 | The Facebook Pixel: one click install |
| 31 | Google Analytics: one click install |
| 32 | ANY script: add any other script with our flexible Head & Footer option |
| 33 | The Pinterest Tag: via [free add-on](https://www.pixelyoursite.com/pinterest-tag) |
| 34 | Google Ads (formerly AdWords) [pro feature](https://www.pixelyoursite.com/google-ads-tag) |
| 35 | Microsoft (BING) UET tag [paid add-on](https://www.pixelyoursite.com/bing-tag) |
| 36 | |
| 37 | **Want to learn about your Facebook Pixel? We've put toghether [this help page](https://www.pixelyoursite.com/how-to-use-facebook-pixel)** |
| 38 | |
| 39 | FANTASTIC WOOCOMMERCE INTEGRATION: |
| 40 | |
| 41 | Facebook Pixe: every e-commerce related event is fired automatically. Conversion value is tracked for each event. All the events are Dynamic Product Ads ready (content_ids and content_type parameters always present). |
| 42 | Google Analytics: Enhanced Ecommerce implementation. |
| 43 | Head & Footer scripts: you can insert scripts on the WooCommerce “order-received” page. |
| 44 | Pinterest e-commerce events. |
| 45 | |
| 46 | EASY DIGITAL DOWNLOADS INTEGRATION: |
| 47 | |
| 48 | The EDD integration works just like the WooCommerce integration, with full Dynamic Product Ads Facebook Pixel Support, Google Analytics Enhanced Ecommerce, and Pinterest Tag e-commerce events. |
| 49 | |
| 50 | TRACK IMPORTANT DATA WITH THE GLOBAL EVENTS: |
| 51 | |
| 52 | The plugin will automatically fire the Global Events and send them to all active pixels. They will help you track your visitors’ activity, create Facebook Custom Audiences or Custom Conversions, Google Goals, Google Audiences, and Pinterest Audiences. |
| 53 | |
| 54 | The GeneralEvent: fired on every page, it will send Facebook and Pinterest key data on how your users interact with your content. It’s parameters will track things like the page title, category, or ID. Super useful for targeted Custom Audiences. |
| 55 | The Search event: fired when your visitors use the search form, it will track the searched string. WooCommerce searches will be Dynamic Ads ready, sending the product’s ID to allow retargeting. |
| 56 | The Comment event: it will track comments. |
| 57 | The Download event: will be fired when a downloadable filled is clicked. You can configure what file types should fire this event. |
| 58 | The Form event: will be fired when a form is submitted |
| 59 | |
| 60 | FIRE YOUR OWN EVENTS: |
| 61 | |
| 62 | You can easily configure your own events and send them to all or just some of the networks (Facebook, Google, Pinterest). |
| 63 | |
| 64 | You can fire standard or custom events using triggers like: |
| 65 | |
| 66 | URL contains. |
| 67 | URL equals. |
| 68 | Delay event: fire after X seconds. |
| 69 | |
| 70 | GDPR SUPPORT: |
| 71 | |
| 72 | PixelYourSite works with 4 popular “cookie consent” plugins: |
| 73 | |
| 74 | Cookiebot - [link](https://wordpress.org/plugins/cookiebot/) |
| 75 | GDPR Cookie Consent - [link](https://wordpress.org/plugins/cookie-law-info/) |
| 76 | Cookie Notice Plugin - [link](https://wordpress.org/plugins/cookie-notice/) |
| 77 | Ginger EU Cookie Law - [link](https://wordpress.org/plugins/ginger/) |
| 78 | |
| 79 | Additionally we offer filters that developers can use to create their own custom integrations. These filters can control the way each pixel works. |
| 80 | |
| 81 | FACEBOOK FOR WOOCOMMERCE INTEGRATION: |
| 82 | |
| 83 | You can use Facebook for WooCommerce plugin along with PixelYourSite. This will let you benefit from all our advanced pixel features and still have a Facebook page shop. |
| 84 | |
| 85 | When Facebook for WooCommerce is detected, the plugin will offer you the option to use their ID logic for all the WooCommerce specific events. This will ensure product matching between your site and their Product Catalog. |
| 86 | |
| 87 | [More details in this dedicated article](https://www.pixelyoursite.com/facebook-for-woocommerce-pixelyoursite) |
| 88 | |
| 89 | OTHER USEFUL FEATURES: |
| 90 | |
| 91 | Facebook Manual Advanced Matching. |
| 92 | Remove Facebook default events. |
| 93 | Google Analytics cross-domain measurement. |
| 94 | Google Analytics Enhanced Link Attribution. |
| 95 | Google Analytics Anonymize IPs. |
| 96 | Pinterest Enhanced Matching. |
| 97 | |
| 98 | **EVEN MORE FEATURES WITH THE PRO VERSION:** |
| 99 | |
| 100 | [PixelYourSite Pro](https://www.pixelyoursite.com/) is used by thousands of businesses already and will offer you some extraordinary features. |
| 101 | |
| 102 | [Click here for a comparison between the free and pro versions](https://www.pixelyoursite.com/free-versus-pro) |
| 103 | |
| 104 | EVEN MORE GLOBAL EVENTS: |
| 105 | |
| 106 | The ClickEvent: fired on every click and with useful parameters that will help you to identify what element was clicked (HTML links, buttons, images, etc). This event will be sent to all networks (Facebook, Google Analytics, Google Ads, Pinterest). |
| 107 | The WatchVideo event: fired when an embedded video is played, will let you identify the video name and will be send to all networks |
| 108 | The user registration event: fired when new user account is created on your website, will be sent to all networks |
| 109 | The AdSense event: fired when an AdSense ad is clicked, it lets you optimize your Facebook or Pinterest Ads for Google AdSense clicks, as well as creating Custom Audiences or Lookalikes. |
| 110 | |
| 111 | EVEN MORE EVENTS’ TRIGGERS: |
| 112 | |
| 113 | On top of the free triggers (URL equals and URL contains), the pro version will let you fire more complexe events: |
| 114 | |
| 115 | Clicks on CSS Selector: you can target virtually any clicks, like buttons, images etc. |
| 116 | Mouse over CSS Selector |
| 117 | Page Scroll: you can fire an event when any or a particular page is scrolled down to a percent. |
| 118 | |
| 119 | EVEN MORE FACEBOOK EVENTS PARAMETERS: |
| 120 | |
| 121 | The pro version will track a vast amount of data for each event, like the traffic source, UTMs, your visitor’s browser’s time (hour, day, month). |
| 122 | |
| 123 | These parameters can be used for [Custom Audiences or Custom Conversions](https://www.pixelyoursite.com/facebook-pixel-plugin/custom-audiences-conversions) |
| 124 | |
| 125 | EVEN MORE GOOGLE ANALYTICS FEATURES: |
| 126 | |
| 127 | Support for Google Optimize (free A/B testing service by Google). |
| 128 | |
| 129 | On top of the free version data, [the pro version](https://www.pixelyoursite.com/google-analytics) will track a number of useful Custom Dimensions. |
| 130 | |
| 131 | Browser’s hour, day, and month. They are useful if you sell globally and what to know at what time your visitors take a particular action (their time, not your server’s or Google Analytics time). |
| 132 | Dynamic Remarketing vertical custom dimensions (Retail or Custom vertical). Useful if you want to configure dynamic remarketing via your Analytics account. |
| 133 | |
| 134 | EVEN MORE HEAD & FOOTER OPTIONS: |
| 135 | |
| 136 | The pro version [Head & Footer](https://www.pixelyoursite.com/head-footer-scripts) lets you use dynamic values: [id], [title], [categories], [email], [first_name], [last_name]. |
| 137 | |
| 138 | For WooCommerce you’ll have some additional dynamic values: [order_number], [order_subtotal], [order_total], [currency]. |
| 139 | |
| 140 | EVEN MORE WOOCOMMERCE FEATURES: |
| 141 | |
| 142 | Identify your most valuable customers with our Advanced Marketing Events. Useful to create Facebook Lookalikes or Google Similar Audiences. |
| 143 | CSV Export for Facebook Custom Audiences with Lifetime Value. Useful for Facebook LTV Lookalikes. |
| 144 | Super flexible events value configuration (include/exclude tax and shipping, use full price or a price percent for each event). |
| 145 | Track the Lifetime Value for your customers as Purchase event parameter. |
| 146 | Lots of extra parameters for the Facebook Purchase event. Useful to create advanced Custom Audiences. Check our [comparison tables](https://www.pixelyoursite.com/pixelyoursite-free-version) for details |
| 147 | Fire the Purchase event on transaction only. |
| 148 | Track WooCommerce affiliate buttons clicks. |
| 149 | Track WooCommerce PayPal Standard clicks. |
| 150 | [Google Ads Dynamic Remarketing parameters](https://www.pixelyoursite.com/google-ads-tag) |
| 151 | |
| 152 | For more info on how the pro version can help you with your Facebook Pixel, [visit this WooCommerce - Facebook Pixel page](https://www.pixelyoursite.com/facebook-pixel-plugin/woocommerce-facebook-pixel) |
| 153 | |
| 154 | GOOGLE ADS TAG (FORMER ADWORDS): |
| 155 | |
| 156 | The Pro version will implement the [Google Ads Tag](https://www.pixelyoursite.com/google-ads-tag) with Dynamic Retargeting support for WooCommerce and Easy Digital Downloads. |
| 157 | |
| 158 | Each Global event will be sent to Google Ads too, and you can configure Google Ads conversions. |
| 159 | |
| 160 | Add conversion label to any WooCommerce or EDD event. |
| 161 | |
| 162 | NOT ENOUGH? GET MORE WITH THE SUPER PACK: |
| 163 | |
| 164 | With the [Super Pack](https://www.pixelyoursite.com/super-pack) you get 5 extra add-ons: |
| 165 | |
| 166 | Multiple pixels: add multiple Facebook pixels, Google Analytics, or Google Ads tags |
| 167 | Remove a pixel from a particular page |
| 168 | Dynamic parameters for events |
| 169 | WooCommerce custom “thank you pages” |
| 170 | AMP support |
| 171 | |
| 172 | The super pack comes as a free bonus with our [Advanced and Agency licenses](https://www.pixelyoursite.com/facebook-pixel-plugin/buy-pixelyoursite-pro). |
| 173 | |
| 174 | DON’T MISS: |
| 175 | |
| 176 | For more details about how [PixelYourSite Pro](https://www.pixelyoursite.com/) can help your business, visit our website. Make sure you check our [free versus pro comparison page](https://www.pixelyoursite.com/free-versus-pro) |
| 177 | |
| 178 | **Learning Section**: we’ve put together a number of articles with all sort of tips and tricks that will help you with your ads. [Click here for our learning section](https://www.pixelyoursite.com/learn) |
| 179 | |
| 180 | **Video Tips**: watch short videos showing how to do all sort of ads related things. [Click here to watch the video tips](https://www.pixelyoursite.com/video) |
| 181 | |
| 182 | **Documentation**: learn how to use PixelYourSite free plugin. [Click here for the HELP articles](https://www.pixelyoursite.com/pixelyoursite-free-version) |
| 183 | |
| 184 | |
| 185 | == Installation == |
| 186 | * From the WP admin panel, click \"Plugins\" -> \"Add new\". |
| 187 | * In the browser input box, type \"PixelYourSite\". |
| 188 | * Select the \"PixelYourSite\" plugin (authored by \"PixelYourSite\"), and click \"Install\". |
| 189 | * Activate the plugin. |
| 190 | |
| 191 | OR... |
| 192 | |
| 193 | * Download the plugin from this page. |
| 194 | * Save the .zip file to a location on your computer. |
| 195 | * Open the WP admin panel, and click \"Plugins\" -> \"Add new\". |
| 196 | * Click \"upload\".. then browse to the .zip file downloaded from this page. |
| 197 | * Click \"Install\".. and then \"Activate plugin\". |
| 198 | |
| 199 | OR... |
| 200 | |
| 201 | * Download the plugin from this page. |
| 202 | * Extract the .zip file to a location on your computer. |
| 203 | * Use either FTP or your host's cPanel to gain access to your website file directories. |
| 204 | * Browse to the `wp-content/plugins` directory. |
| 205 | * Upload the extracted `wp_edit` folder to this directory location. |
| 206 | * Open the WP admin panel.. click the \"Plugins\" page.. and click \"Activate\" under the newly added plugin. |
| 207 | |
| 208 | |
| 209 | == Frequently Asked Questions == |
| 210 | We maintain an up-to-date FAQ page on our site: [Click Here for the FAQ Page](http://www.pixelyoursite.com/facebool-pixel-master-faq) |
| 211 | |
| 212 | **FACEBOOK PIXEL: Do I need to copy/paste the full Facebook Pixel code somewhere?** |
| 213 | |
| 214 | No, you just have to enter your pixel ID in the dedicated field. The plugin will do the rest for you. |
| 215 | |
| 216 | **FACEBOOK PIXEL: Where can I find the Facebook Pixel ID?** |
| 217 | |
| 218 | You can find it here: |
| 219 | <a href="https://www.facebook.com/ads/manager/pixel/facebook_pixel" target="_blank">https://www.facebook.com/ads/manager/pixel/facebook_pixel</a> |
| 220 | |
| 221 | **FACEBOOK PIXEL: Can I use the plugin for Custom Audiences or Custom Conversions?** |
| 222 | |
| 223 | Absolutely yes! Actually, the plugin will super-optimize your site for Custom Audiences and Custom Conversions. |
| 224 | |
| 225 | You will be able to create the classical ones based on URLs, but also Custom Combinations, like people who visited posts from category XYZ, or tagged with tag ABC in the last 30 days. |
| 226 | |
| 227 | Use the PRO version, and you'll be able to do crazy things, like targeting people that came from Google and visited products under category "blue widget", or clients who bought products of at least $100, using the discount coupon "promo". |
| 228 | |
| 229 | **FACEBOOK PIXEL: I used the old Facebook Pixel, will my audiences still work?** |
| 230 | |
| 231 | Yes, they will, you won't lose anything. |
| 232 | |
| 233 | **FACEBOOK PIXEL: Does it work with WooCommerce?** |
| 234 | |
| 235 | Yes, it does. The plugin adds all the necessary events, like ViewContent, AddToCart, InitiateCheckout, and Purchase. This way you can easily track conversions and conversion value. |
| 236 | |
| 237 | **FACEBOOK PIXEL: Do I have to manually add the events for WooCommerce?** |
| 238 | |
| 239 | No, you don't, the plugin will take care of everything for you. |
| 240 | |
| 241 | **FACEBOOK PIXEL: Does it work with Easy Digital Downloads?** |
| 242 | |
| 243 | Yes, it works in the same way it does with WooCommerce. |
| 244 | |
| 245 | **FACEBOOK PIXEL: Does it work with Dynamic Product Ads (promote a product catalog)** |
| 246 | |
| 247 | Yes, all the WooCommerce and EDD pixel events are Dynamic Ads ready. |
| 248 | |
| 249 | **FACEBOOK PIXEL: Can I fire additional events if I need to?** |
| 250 | |
| 251 | Of course, you can fire any type of event (standard or custom). |
| 252 | |
| 253 | There are several triggers you can use: |
| 254 | |
| 255 | *URL includes (supports delay) |
| 256 | *URL equals (supports delay) |
| 257 | *Click on HTML link (pro) |
| 258 | *Click on CSS Selector (pro) |
| 259 | *Mouse over CSS Selector (pro) |
| 260 | *Page scroll (pro) |
| 261 | |
| 262 | **FACEBOOK PIXEL: 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?** |
| 263 | |
| 264 | We have an article about how to create Custom Reports: [How to optimize your Facebook Ads Reports for events tracking](https://www.pixelyoursite.com/how-to-manage-reports-inside-your-facebook-ads-manager-video) |
| 265 | |
| 266 | **GOOGLE ANALYTICS: Do I need to copy/paste all the Google Analytics code?** |
| 267 | |
| 268 | No, you just need to copy/paste your Google Analytics UA id. |
| 269 | |
| 270 | **GOOGLE ANALYTICS: Where can I find my Google Analytics UA id?** |
| 271 | |
| 272 | You can find it right inside your Google Analytics account, under Property Settings. |
| 273 | For more information on how to get your UA id, [follow this link](https://www.pixelyoursite.com/documentation/add-your-google-analytics-code) |
| 274 | |
| 275 | **GOOGLE ANALYTICS: Is Google Analytics Enhanced Ecommerce supported?** |
| 276 | |
| 277 | Yes, Google Analytics Enhanced Ecommerce data is tracked automatically for WooCommerce and Easy Digital Downloads. |
| 278 | |
| 279 | **HEAD AND FOOTER: Can I add any scripts I want with your Head and Footer option?** |
| 280 | |
| 281 | Yes, you can add any type of scripts you want. |
| 282 | |
| 283 | **HEAD AND FOOTER: Can I show scripts just on mobile or desktop?** |
| 284 | |
| 285 | Yes, you can. |
| 286 | You can configure scripts for all devices, just for mobile, or just for desktop. |
| 287 | |
| 288 | **HEAD AND FOOTER: Can I hide scripts on some pages.** |
| 289 | |
| 290 | Yes, you can hide the global scripts on any page you want. |
| 291 | |
| 292 | **HEAD AND FOOTER: Can I add scripts on WooCommerce's order-received page?** |
| 293 | |
| 294 | Yes, you can add or hide scripts on the WooCommerce's order-received page. |
| 295 | |
| 296 | **PINTEREST TAG: Do I need to install your free Pinterest add-on?** |
| 297 | |
| 298 | Yes, if you want to implement the Pinterest tag you'll need our free Pinterest add-on. |
| 299 | You can [get it from here](https://www.pixelyoursite.com/pinterest-tag) |
| 300 | |
| 301 | **PINTEREST TAG: Where can I find my Pinterest tag ID?** |
| 302 | |
| 303 | You can find your Pinterest tag ID inside your Pinterest account. |
| 304 | For more information go to our [help page](https://www.pixelyoursite.com/documentation/add-your-pinterest-tag) |
| 305 | |
| 306 | **PINTEREST TAG: Can I fire my own Pinterest events?** |
| 307 | |
| 308 | Yes, you can fire your own Pinterest tags events effortless. |
| 309 | |
| 310 | There are several triggers you can use: |
| 311 | |
| 312 | *URL includes (supports delay) |
| 313 | *URL equals (supports delay) |
| 314 | *Click on HTML link (pro) |
| 315 | *Click on CSS Selector (pro) |
| 316 | *Mouse over CSS Selector (pro) |
| 317 | *Page scroll (pro) |
| 318 | |
| 319 | **PINTEREST TAG: I use WooCommerce or EDD, do I need to add the Pinterest events myself?** |
| 320 | |
| 321 | No, absolutely not! |
| 322 | The plugin will fire all the Pinterest e-commerce events automatically. |
| 323 | |
| 324 | **Will your plugin increase the loading time of my site?** |
| 325 | |
| 326 | The plugin itself is really fast. However, you have to remember that the pixel has to communicate with Facebook, Google, or Pinterest to send all the data, and this will add a little load on your site. |
| 327 | |
| 328 | Will this impact on your visitors? No, because all the requests are asynchronous, meaning that the browser will continue to load and your users will not see any delay whatsoever. |
| 329 | |
| 330 | **Are there any known incompatibilities with other themes or plugins?** |
| 331 | |
| 332 | There are a few you should consider: |
| 333 | |
| 334 | *Any plugin or solution that implements the same pixel or tag. Having the same tracking pixel added twice can cause problems. |
| 335 | |
| 336 | *We had a problem with Mamaya, a retargeting service. |
| 337 | |
| 338 | *It won’t work with LeadPages or any similar system because those pages are generated outside WordPress. |
| 339 | |
| 340 | *Some clients reported problems with Thrive landing pages. This happens because Thrive removes other plugins JS files. |
| 341 | |
| 342 | There's a strange solution: it appears that if you have the Yoast plugin installed the problem will go away. |
| 343 | |
| 344 | *Upsell plugins can cause problems with purchase tracking. If they add an intermediary page after the transaction, we have [a filter their developer can use to call our default Purchase event](https://bitbucket.org/snippets/the_mister/zeaXya) |
| 345 | |
| 346 | **Are there any situations when the plugin will connect to outside sources?** |
| 347 | |
| 348 | Yes, there are, and we will explain them here: |
| 349 | |
| 350 | *We offer you the possibility to voluntarily subscribe to our newsletter and get valuable tips. We manage our newsletter using ActiveCampaing. When you subscribe, we will call our server that intermediates the API connection, and then the data is sent to ActiveCampaign. The information that is passed: the name you provide and the email. If you check the "I use WooCommerce" checkbox, we will add this information as a tag, to give you better tips in the future. |
| 351 | |
| 352 | *Add-on updates: the plugin works with free or paid add-ons (for Pinterest, Bing, etc) that we provide and host on our server. When you install such an add-on, we will do checks for updates. If you have a valid license for the add-on, we will automatically download the latest version of the add-on from our servers. The core plugin (PixelYourSite itself) updates are provided using WordPress own servers. |
| 353 | |
| 354 | *When you install a pixel or a tag (like the Facebook Pixel or Google Analytics), the script will call for their specific files. These scripts are hosted on their servers (Facebook's servers, Google's servers). |
| 355 | |
| 356 | *If you install scripts using our Head & Footer option, these scripts may load files from third-party servers. You can check this using your browser's Console. |
| 357 | |
| 358 | **Do you record data about the websites' traffic** |
| 359 | |
| 360 | NO, absolutely not! We don't track any type of data about your website. We simply implement the pixel/tag code. |
| 361 | |
| 362 | |
| 363 | |
| 364 | == Screenshots == |
| 365 | |
| 366 | 1. Add your Facebook pixel ID, Google Analytics ID, or Pinterest ID. |
| 367 | 2. You don’t have to copy/paste all the Facebook pixel code, but just the pixel ID. You can find it in your Ads Manager, under the Pixels link. |
| 368 | 3. You just need your Google Analytics Tracking ID, not the full code. |
| 369 | 4. You simply need your Pinterest Tag ID. |
| 370 | 5. You can exclude user roles from tracking (like Admin), so they won’t affect your stats. |
| 371 | 6. You can allow other user roles to use the plugin. |
| 372 | 7. The Global Events are fired automatically, tracking important actions and data. |
| 373 | 8. The GeneralEvent is fired on every page, tracking important data about your content. |
| 374 | 9. The Search event tracks searches. WooCommerce searches are Dynamic Ads ready. |
| 375 | 10. The Form event is fired when a form is submitted. |
| 376 | 11. The Comment event tracks comments. |
| 377 | 12. The Downloads event tracks downloads. You can configure the file types. |
| 378 | 13. You can fire your own events with NO coding. |
| 379 | 14. Events have flexible triggers and can be sent to Facebook, Google Analytics, or Pinterest. |
| 380 | 15. WooCommerce comes with Facebook Dynamic Ads events, Google Analytics Enhanced Ecommerce, and Pinterest e-commerce configuration. |
| 381 | 16. You can track value for each WooCommerce events, plus other useful parameters. |
| 382 | 17. The AddToCart event can be fired on cart buttons, cart page, or checkout page. |
| 383 | 18. Easy Digital Downloads integrations comes with Facebook Dynamic Ads events, Google Analytics Enhanced Ecommerce, and Pinterest e-commerce setup. |
| 384 | 19. Test your Facebook pixel with Pixel Helper Chrome extension. |
| 385 | 20. Test your Google Analytics code with Google Tag Assistant Chrome extension. |
| 386 | 21. Test your Pinterest tag with the Pinterest Tag Helper Chrome extension. |
| 387 | 22. With the Head & Footer option you an add ANY script. There’s an option to insert scripts on the WooCommerce order-received page . |
| 388 | 23. You’ll have an option to insert scripts on any pages or posts. |
| 389 | |
| 390 | |
| 391 | == Changelog == |
| 392 | |
| 393 | = PixelYourSite 7.1.9 = |
| 394 | |
| 395 | * Fix for a potential issue where AddToCart value was NaN |
| 396 | |
| 397 | * Automatically deactivation of the free version when installing the pro plugin |
| 398 | |
| 399 | * Facebook server-side API update |
| 400 | |
| 401 | * Remove CompleteRegistration from code when the event is send server-side - [hiding the profit](https://www.pixelyoursite.com/strategy/track-profit-and-total-for-facebook-ads) |
| 402 | |
| 403 | * Code update to declare WooCommerce 4.2 compatibility |
| 404 | |
| 405 | |
| 406 | |
| 407 | = PixelYourSite 7.1.8 = |
| 408 | |
| 409 | * NEW: Facebook Pixel server-side events for WooCommerce. It works for the Purchase and CompleteRegistration event. |
| 410 | |
| 411 | * NEW: Fire the CompleteRegistration event for each WooCommerce transaction and configure it to use PROFIT as value. You can send this event server-side only (hide it from the browser). This is useful if you want to track both the TOTAL and the PROFIT generated by your ads. Requires [WooCommerce Cost of Goods plugin by PixelYourSite](https://www.pixelyoursite.com/woocommerce-cost-of-goods) |
| 412 | |
| 413 | * FIX: Potential issue related to the Pinterest Tag add-on and WooCommerce events. Some events were not fired if there was no Facebook Pixel installed. You need to update the Pinterest Tag add-on too. |
| 414 | |
| 415 | * Declare compatibility with WooCommerce 4.1 |
| 416 | |
| 417 | = PixelYourSite 7.1.6 = |
| 418 | |
| 419 | * This is a minor update that ensures compatibility with the latest changes from the [WooCommerce Cost of Goods plugin by PixelYourSite](https://www.pixelyoursite.com/woocommerce-cost-of-goods) |
| 420 | |
| 421 | = PixelYourSite 7.1.6 = |
| 422 | |
| 423 | * Small code update to declare WooCommerce 4.0 compatibility. |
| 424 | |
| 425 | * Fixes for some issues related to file paths. In some environments this was causing error on Elementor or WooCommerce admin pages. |
| 426 | |
| 427 | * A new option to use PROFIT as value for your Facebook Pixel WooCommerce events. It works with the [WooCommerce Cost of Goods plugin by PixelYourSite](https://www.pixelyoursite.com/woocommerce-cost-of-goods) |
| 428 | |
| 429 | = PixelYourSite 7.1.5 = |
| 430 | |
| 431 | * New features: Facebook Dynamic Ads events for blog posts. Simulate the DPA required events on normal blog posts. We will soon release a dedicated plugin that will help you import your blog content into a Facebook Product Catalog. |
| 432 | |
| 433 | * Google Analytics Enhanced Ecommerce: we removed the variation name from the product title and we added it as a separate parameter. |
| 434 | |
| 435 | * Google Analytics Enhanced Ecommerce: we fixed an error with variable products category. |
| 436 | |
| 437 | * Elementor: we fixed an error that was deleting Head & Footer scripts when a page was saved using Elementor. |
| 438 | |
| 439 | * UI updates to reflect new paid features: fire custom events once in X hours; Google Analytics list performance tracking. |
| 440 | |
| 441 | * Small code change to declare WooCommerce 3.9 compatibility. |
| 442 | |
| 443 | |
| 444 | = PixelYourSite 7.1.4 = |
| 445 | |
| 446 | * Minor code changes to declare compatibility with WordPress 5.3 and WooCommerce 3.8. |
| 447 | |
| 448 | |
| 449 | = PixelYourSite 7.1.3 = |
| 450 | |
| 451 | * Adding new options for WooCommerce and EDD events IDs: select between ID or SKU, use prefixes and postfixes, treat variable products like simple products. These features will work with the Pinterest add-on v2.0.8 (free), and the Bing add-on v1.0.2 (paid). |
| 452 | |
| 453 | * Fix for an old bug related to how On Page Events triggers work. In previous versions, final slashes were ignored for both “URL Match” and “URL Contains” conditions. This was fixed with this release. |
| 454 | Recommendation: if you have manually added events using the On-Page trigger, test them to make sure they work as expected. |
| 455 | |
| 456 | * Fix for a bug related to the Pinterest add-on. In previous versions, the WooCommerce Checkout and PageVisit events could not be turned ON/OFF. |
| 457 | |
| 458 | |
| 459 | |
| 460 | = PixelYourSite 7.1.2 = |
| 461 | |
| 462 | * Name change - we removed "Facebook" from the plugin title, as per Facebook's request. The plugin will still offer great Facebook Pixel integration. |
| 463 | |
| 464 | * Banner update - we removed "Facebook" from our banners, as per Facebook's request. |
| 465 | |
| 466 | * Security and code improvements |
| 467 | |
| 468 | |
| 469 | = PixelYourSite 7.1.1 = |
| 470 | |
| 471 | * Compatibility with WooCommerce 3.7 |
| 472 | |
| 473 | * New structure for the Form and Comment events. It will help you better identify what actions have fired the events. |
| 474 | |
| 475 | Form Event for the Facebook Pixel and the Pinterest Tag: |
| 476 | |
| 477 | - form_class: a new parameter pulling the CSS class when it exits. |
| 478 | - form_id: a new parameter pulling the CSS ID when it exits. |
| 479 | |
| 480 | Form event on Google Analytics: |
| 481 | |
| 482 | - event_categoty: Form. |
| 483 | - event_action: the CSS class or ID (makes easier for you to identify the form). |
| 484 | - event_label: the text on the form’s button. |
| 485 | |
| 486 | Comment event on Google Analytics: |
| 487 | |
| 488 | - event_categoty: Comment. |
| 489 | - event_action: the “post type” (page, products, post, etc) comment. |
| 490 | - event_label: the URL where the comment was posted. |
| 491 | |
| 492 | = PixelYourSite 7.1.0 = |
| 493 | |
| 494 | * This update ads support for our paid Microsoft (BING) UET Tag add-on. |
| 495 | |
| 496 | = PixelYourSite 7.0.5 = |
| 497 | |
| 498 | * Fixing a potential problem with Pinterest PageVisit and Checkout events when the Facebook Pixel was deactivated (for the Pinterest add-on users only). |
| 499 | |
| 500 | |
| 501 | = PixelYourSite 7.0.4 = |
| 502 | |
| 503 | * New Feature: Google Analytics cross-domain measurement. Tell Analytics to see sessions on two related sites (such as an ecommerce site and a separate shopping cart site) as a single session. |
| 504 | |
| 505 | * UI changes to reflect some new features our PRO version has (Google Optimize, add conversion label to WooCommerce and EDD Google Ads events). |
| 506 | |
| 507 | * Pinterest add-on missing license notice. |
| 508 | |
| 509 | * Remove the pixels when you edit something with Elementor. |
| 510 | |
| 511 | = PixelYourSite 7.0.3 = |
| 512 | |
| 513 | * Fix: Google Analytics purchase event was missing the transaction ID, blocking Enhanced Ecommerce tracking. |
| 514 | |
| 515 | * Fix: Head & Footer option was stripping backslashes from custom code on post or pages. |
| 516 | |
| 517 | = PixelYourSite 7.0.2 = |
| 518 | |
| 519 | * IMPORTANT: fix for some fatal errors that could be triggered by the Pinterest add-on on WooCommerce and Easy Digital Downloads orders. |
| 520 | |
| 521 | = PixelYourSite 7.0.1 = |
| 522 | |
| 523 | * Fix for missing cookie dependency issue (GDPR integrations). |
| 524 | |
| 525 | * Adding developer Facebook ID in the pixel code (used internally by Facebook to identify partners activity). |
| 526 | |
| 527 | = PixelYourSite 7.0.0 = |
| 528 | |
| 529 | * Version 7.0.0 is a complete rewrite of the plugin, adding a lot more features. |
| 530 | |
| 531 | * New Google Analytics integration with Enhanced Ecommerce support for WooCommerce and Easy Digital Downloads. |
| 532 | |
| 533 | * Pinterest Tag support via free add-on. |
| 534 | |
| 535 | * Add ANY other script with the new Head & Footer option. It supports global or per-page scripts. You have the possibility to add scripts on the WooCommerce order-received page. |
| 536 | |
| 537 | * The Global Events will automatically track important actions: searches, form submit, comments, downloads. |
| 538 | |
| 539 | * You can configure your own events using “URL match” or URL include triggers” and add a “delay event” in seconds. |
| 540 | |
| 541 | * Every event can be sent to Facebook, Google Analytics, or Pinterest. |
| 542 | |
| 543 | * You can enable Facebook Advanced Matching. |
| 544 | |
| 545 | * The Pinterest Tag supports Enhanced Matching. |
| 546 | |
| 547 | * Google Analytics supports Enhanced Link Attribution and Anonymize IP. |
| 548 | |
| 549 | * The WooCommerce integrations tracks remove from cart as an event and has support for Google Enhanced Ecommerce tracking. |
| 550 | |
| 551 | * You can now grant permissions to manage the plugin based on the user’s role. |
| 552 | |
| 553 | * We’ve extended our GDPR integrations with twom more “cookie consent” plugins. |
| 554 | |
| 555 | * We’ve added filters for developers to control each pixel, plus a filter to control our AJAX option (useful to make GDPR custom integrations cache friendly). |
| 556 | |
| 557 | |
| 558 | = PixelYourSite 5.3.3 = |
| 559 | |
| 560 | * Facebook for WooCommerce compatibility fix: we modify ViewCategory content_type parameter in order to ensure product matching when Facebook for WooCommerce id logic is used. |
| 561 | |
| 562 | * WordPress 5.0 compatibility check. |
| 563 | |
| 564 | = PixelYourSite 5.3.2 = |
| 565 | |
| 566 | * Facebook Pixel Standard Events updated to include the new ones that Facebook released. <a href="https://www.pixelyoursite.com/new-facebook-pixel-standard-events" target="_blank"> Details here</a> |
| 567 | |
| 568 | |
| 569 | = PixelYourSite 5.3.1 = |
| 570 | |
| 571 | * GDPR related update - we've implemented a dedicated filter to disable pixel tracking before consent: pys_disable_by_gdpr |
| 572 | |
| 573 | * GDPR related update - we've added built-in integration with Ginger – EU Cookie Law plugin and Cookiebot |
| 574 | |
| 575 | = PixelYourSite 5.3.0 = |
| 576 | |
| 577 | * Additional improvements to the WooCommerce AddToCart event ("Cannot read property 'data' of undefined" error with some AJAX based themes) |
| 578 | |
| 579 | * Fixing potential security issue |
| 580 | |
| 581 | |
| 582 | = PixelYourSite 5.2.1 = |
| 583 | |
| 584 | * AddToCart small improvements to ensure compatibility with some themes using AJAX cart |
| 585 | |
| 586 | * Plugin name update |
| 587 | |
| 588 | = PixelYourSite 5.2.0 = |
| 589 | |
| 590 | * Fixing a possible error with the add to cart button when WooCommerce and WPML are installed on some hostings (we were able to replicate it on SiteGround servers only) |
| 591 | |
| 592 | * Enabling the AddToCart event on the Cart page when WooCommerce "Redirect to the cart page after successful addition" option is active. This will ensure that the events are captured. |
| 593 | |
| 594 | * Other small improvements to the code related to the AddToCart event |
| 595 | |
| 596 | = PixelYourSite 5.1.0 = |
| 597 | |
| 598 | * Fixing possible compatibility problem with Facebook for WooCommerce extension |
| 599 | * Improving Facebook for WooCommerce ID logic |
| 600 | |
| 601 | = PixelYourSite 5.0.9 = |
| 602 | |
| 603 | * ViewCategory - new WooCommerce event, compatible with Facebook Dynamic Product Ads (DPA) |
| 604 | |
| 605 | * New WooCommerce events parameter: contents - A list of JSON object that contains the product ids associated with the event as well as additional information about the products. It can help with DPA |
| 606 | |
| 607 | * Declaring compatibility with WooCommerce 3.2.6 |
| 608 | |
| 609 | = PixelYourSite 5.0.8 = |
| 610 | |
| 611 | * AddToCart new option: fire the event on the Checkout Page. It will be helpful for some websites with customized structure. |
| 612 | |
| 613 | * The AddToCart event was improved to work with AJAX buttons on single product pages. This will help to catch events on a number of themes that use AJAX on the product pages. |
| 614 | |
| 615 | * We made additional changes to ensure compatibility with Facebook for WooCommerce latest version. |
| 616 | |
| 617 | |
| 618 | = PixelYourSite 5.0.7 = |
| 619 | |
| 620 | * Purchase event 0 value error fixed (there wasn't any value parameter when the order value was zero) |
| 621 | |
| 622 | |
| 623 | = PixelYourSite 5.0.6 = |
| 624 | |
| 625 | |
| 626 | * Facebook for WooCommerce extension integration updated to match the new ID logic (PixelYourSite can be used together with Facebook for WooCommerce extension - this way you can have a Facebook shop without losing our powerful pixel features) |
| 627 | |
| 628 | |
| 629 | = PixelYourSite 5.0.5.2 = |
| 630 | |
| 631 | |
| 632 | * Quick fix for a small error with our previous release (we didn't include all the files) |
| 633 | |
| 634 | |
| 635 | = PixelYourSite 5.0.5 = |
| 636 | |
| 637 | * Treat WooCommerce variable products like simple products - useful if your Product Catalog doesn't include variations. When ON, ViewContent content_type will be product and the main item ID will be used for all events instead of the variation item. |
| 638 | |
| 639 | = PixelYourSite 5.0.4 = |
| 640 | |
| 641 | * Changed WooCommerce ViewContent event content_type to product_group for variable products |
| 642 | |
| 643 | = PixelYourSite 5.0.3 = |
| 644 | |
| 645 | * WooCommerce and EDD content_ids potential issue fix (the content was not correctly wrapped, leaving room for errors when SKU was used instead of the default WordPress IDs) |
| 646 | |
| 647 | = PixelYourSite 5.0.2 = |
| 648 | |
| 649 | * Added agent identifier (dvpixelyoursite) as we were directly requested by Facebook |
| 650 | * Checked and confirmed WooCommerce 3 compatibility |
| 651 | * Dynamic WooCommerce Events Value based on the product price |
| 652 | * Facebook for WooCommerce support |
| 653 | |
| 654 | = PixelYourSite 5.0.1 = |
| 655 | |
| 656 | * WooCommerce 2.7 compatibility update: we made sure everything works with the latest WooCommerce version. |
| 657 | |
| 658 | = PixelYourSite 5.0 = |
| 659 | |
| 660 | * Easy Digital Downloads Integration - Dynamic Ads (promote a product catalog) are fully supported. |
| 661 | |
| 662 | * WooCommerce & Easy Digital Downloads events global value. |
| 663 | |
| 664 | = PixelYourSite 4.0.3 = |
| 665 | |
| 666 | * Important security updates |
| 667 | |
| 668 | = PixelYourSite 4.0.2 = |
| 669 | |
| 670 | * WordPress 4.7 compatibility checked |
| 671 | |
| 672 | * Manage Events buttons fixed - they were not looking right on WP 4.7 |
| 673 | |
| 674 | = PixelYourSite 4.0.1 = |
| 675 | |
| 676 | * fixing minor bugs |
| 677 | |
| 678 | = PixelYourSite 4.0.0 = |
| 679 | |
| 680 | * From version 4.0 the plugin uses JS to trigger the code. This allows us to add new useful features. |
| 681 | |
| 682 | * Delay Event option added for the GeneralEvent |
| 683 | |
| 684 | * Head/Footer option - you can decide where the pixel JS will be called. The default setting is in the page head. |
| 685 | |
| 686 | * Various text changes to reflect the new pro features |
| 687 | |
| 688 | * WooCommerce SKU id possible error fix |
| 689 | |
| 690 | |
| 691 | = PixelYourSite 3.1.0 = |
| 692 | |
| 693 | * Changing GeneralEvent parameters names to avoid Pixel Helper warning (post_id and post_type are now being used) |
| 694 | |
| 695 | * Updating new pro features (tracking tags, advanced matching) |
| 696 | |
| 697 | * Minor fixes and code changes |
| 698 | |
| 699 | = PixelYourSite 3.0.3 = |
| 700 | |
| 701 | * Fixing PHP warnings and errors |
| 702 | |
| 703 | * Fixing encoding problems |
| 704 | |
| 705 | * Fixing incompatibility with some themes |
| 706 | |
| 707 | = PixelYourSite 3.0.2 = |
| 708 | |
| 709 | * Small fixes related to some possible HTML errors |
| 710 | |
| 711 | * Admin Notice modifications |
| 712 | |
| 713 | = PixelYourSite 3.0.1 = |
| 714 | |
| 715 | * Fixing potential problem with importing settings from older versions |
| 716 | |
| 717 | |
| 718 | = PixelYourSite 3.0 = |
| 719 | |
| 720 | This is a major release, with a new design and new features: |
| 721 | |
| 722 | * Completely new design |
| 723 | |
| 724 | * New GeneralEvent feature for improved Custom Audience building (with a free guide) |
| 725 | |
| 726 | * ON/OFF option for user roles |
| 727 | |
| 728 | * Improved Events and Dynamic Events control |
| 729 | |
| 730 | * Facebook Dynamic Ads Pixel Setup for WooCommerce |
| 731 | |
| 732 | |
| 733 | = PixelYourSite 2.2.4 = |
| 734 | |
| 735 | * Fixed a few back*end errors and conflicts |
| 736 | |
| 737 | * Adding new currencies |
| 738 | |
| 739 | = PixelYourSite 2.2.3 = |
| 740 | |
| 741 | * Learning links updated |
| 742 | |
| 743 | * Minor PHP warning fixed |
| 744 | |
| 745 | = PixelYourSite 2.2.2 = |
| 746 | |
| 747 | * Minor fix for admin notice |
| 748 | |
| 749 | = PixelYourSite 2.2.1 = |
| 750 | |
| 751 | * Fixing not closing admin notice error |
| 752 | |
| 753 | |
| 754 | = PixelYourSite 2.2 = |
| 755 | |
| 756 | * Introducing Dynamic Events (pro) |
| 757 | |
| 758 | * Introducing our new Learning Section |
| 759 | |
| 760 | = PixelYourSite 2.1 = |
| 761 | |
| 762 | * Introducing new WooCommerce Paypal Standard events (pro) |
| 763 | |
| 764 | = PixelYourSite 2.0 = |
| 765 | |
| 766 | * This update adds full control on Standard Events, with the possibility to define all the available parameters for each event |
| 767 | |
| 768 | * You can also add the code for each event with the new event text field. This also lets you define custom events |
| 769 | |
| 770 | * WooCommerce Affiliate Products events: you can define events that will trigger on affiliate buttons clicks |
| 771 | |
| 772 | * Fixed a potential error for the WooCommerce Purchase Event |
| 773 | |
| 774 | = PixelYourSite 1.05 = |
| 775 | |
| 776 | * Updated offer for the PRO version |
| 777 | |
| 778 | = PixelYourSite 1.04 = |
| 779 | |
| 780 | * Fixed fresh install error (when no settings saved) |
| 781 | |
| 782 | = PixelYourSite 1.03 = |
| 783 | |
| 784 | * Fixed "Select options" error for variable products on categories pages |
| 785 | |
| 786 | = PixelYourSite 1.02 = |
| 787 | |
| 788 | * Fixed currency symbol error |
| 789 | * Added super special offer for the PRO version |
| 790 | |
| 791 | = PixelYourSite 1.01 = |
| 792 | |
| 793 | * Dynamic AddToCart event for WooCommerce (the AddToCart event will trigger when a users click on the add to cart button) |
| 794 | * Dynamic AddToCart works with WooCommerce short-codes. |
| 795 | * Fixed a false error that was reported for the Purchase WooCommerce event by Pixel Helper extension on the Thank You page. |
| 796 | |
| 797 | = PixelYourSite 1.0 = |
| 798 | |
| 799 | * A new plugin is born: It will let you manage the Facebook Pixel with just a few clicks |
| 800 | |
| 801 | |
| 802 | == Upgrade Notice == |
| 803 | |
| 804 | = 5.0 = |
| 805 | |
| 806 | Version 5.0 comes with full Easy Digital Downloads integrations plus the ability to give each WooCommerce and EDD event a global value. |
| 807 |