npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

nuxt-facebook-pixel-module

v1.6.0

Published

Nuxt plugin for Facebook pixel

Downloads

17,885

Readme

nuxt-facebook-pixel-module

npm (scoped with tag) npm js-standard-style CircleCI

A NuxtJS module thats injects Facebook Pixel code

Table of Contents

Requirements

  • npm or yarn
  • NuxtJS
  • NodeJS

Install

$ npm install --save nuxt-facebook-pixel-module
// or
$ yarn add nuxt-facebook-pixel-module

Getting Started

Add nuxt-facebook-pixel-module to modules section of nuxt.config.js.

{
  modules: [
    // Simple usage
    'nuxt-facebook-pixel-module',

    // With options
    ['nuxt-facebook-pixel-module', {
      /* module options */
      track: 'PageView',
      pixelId: 'FACEBOOK_PIXEL_ID',
      autoPageView: true,
      disabled: false
    }],
 ]
}

or even

{
  modules: [
    'nuxt-facebook-pixel-module',
  ],
  facebook: {
    /* module options */
    track: 'PageView',
    pixelId: 'FACEBOOK_PIXEL_ID',
    autoPageView: true,
    disabled: false
  },
}

Automatically track PageView

By default, the module won't trigger any tracking event on route change. To enable this behaviour, you must specify the autoPageView option and set to true in the Nuxt module options.

{
  modules: [
    'nuxt-facebook-pixel-module',
  ],
  facebook: {
    /* module options */
    pixelId: 'FACEBOOK_PIXEL_ID',
    autoPageView: true
  },
}

Disabling the pixel (for GDPR)

If you'd like to install the pixel disabled, and enable it later after the user has consented to its use, you can do so by setting disabled: true in the pixel configuration:

{
  modules: [
    'nuxt-facebook-pixel-module',
  ],
  facebook: {
    ...
    disabled: true
  },
}

Now, in your component, you can call the following in order to start the pixel and track the current page.

this.$fb.enable()

The pixel can be disabled again later on by using the .disable() method.

Multiple pixel codes according to route

It's possible to use multiple pixel codes according to the user's route. This can be made through the pixels property. The pixels property expects an array of options.

{
  modules: [
    'nuxt-facebook-pixel-module',
  ],
  facebook: {
    pixelId: 'DEFAULT_PIXEL_ID',
    pixels: [
      {
        pixelId: 'FACEBOOK_PIXEL_ID',
        routes: [
          '/my-custom-route',
          '/hello/*'
        ]
      }
    ]
  },
}

Per this example, whenever the user is on the /my-custom-route, it will use the FACEBOOK_PIXEL_ID instead of the DEFAULT_PIXEL_ID. For all the other routes, it will use the default one.

Note : Since the pixels property is an array of options, any other valid option (track, manualMode, ...) can be passed.

Advanced Matching

To send custom user data when initializing the FB Pixel you'll have to disable the plugin in your Nuxt config file and enable it once you've set the user data.

Run the following from your Vue component once you've access to the user data:

this.$fb.setUserData({ external_id: 32323, fn: 'John' })
this.$fb.enable()

Read more about Advanced Matching.

Module options

List of possible options in the module:

| Option | Default | Required | Description | |----------|----------|----------|-------------------------------------------------------------------------------------------| | pixelId | null | true | The unique pixel identifier provided by Facebook. | | track | PageView | false | Default tracking event. | | version | 2.0 | false | Tracking version. | | disabled | false | false | Disable the Pixel by default when initialized. Can be enabled later through $fb.enable() and disabled again with $fb.disable(). | debug | false | false | By default, tracking in development mode is disabled. By specifying true, you manually allow tracking in development mode. | manualMode | false | false | By default, Facebook will trigger button click and page metadata. Set to true to disable this behaviour. See more informations | autoPageView | false | false | If set to true, automatically triggers a PageView track event on every page change. | pixels | [] | false | An array of pixels be used according to a specific set of routes. See Multiple pixel codes according to route

Facebook pixel instance

The tracking pixel instance is available on all vue component instances as $fb. It has the following methods:

| Method | Purpose | Equivalent to | |-------------------|----------------------------------------------------------------------------------------------------------|--------------------------------| | enable() | If you had previously set disabled: true in config, enables the pixel and tracks the current page view | $fb.init(), $fb.track() | | disable() | Disables the pixel again | | | setPixelId() | Change the default pixelId & trigger an init it | | | setUserData(userData) | Used to set user data that'll be used once the fbq init function is called. See Advanced Matching. | | | init() | Initialises the pixel | fbq('init', <options.pixelId>) | | track(event, parameters) | Sends a track event with optional parameters. It's PageView by default if the event is not defined. | fbq('track', <options.track>, parameters) | | query(key, value, parameters) | Call the underlying fbq instance with anything else. The parameters attribute is optional. | fbq(key, value, parameters) |

License

MIT License