Scripts

Meta Pixel

Last updated by Harlan Wilton in chore: lint.

Meta Pixel lets you measure, optimise and build audiences for your Facebook ad campaigns.

Nuxt Scripts provides a registry script composable useScriptMetaPixel() to easily integrate Meta Pixel in your Nuxt app.

Script Stats
Transfer
93.9 KB
Decoded
353.3 KB
Loading
CDN
First-Party
Supported
Bundling
No
Privacy
Full data collection
Tracked Data
Page Views Conversions Retargeting Audiences

View source

Nuxt Config Setup

The simplest way to load Meta Pixel globally in your Nuxt App is to use Nuxt config. Alternatively you can directly use the useScriptMetaPixel composable.

export default defineNuxtConfig({
  scripts: {
    registry: {
      metaPixel: {
        id: '123456789012345'
      }
    }
  }
})

useScriptMetaPixel()

The useScriptMetaPixel composable lets you have fine-grain control over when and how Meta Pixel is loaded on your site.

const { proxy } = useScriptMetaPixel()

proxy.fbq('track', 'Purchase', { value: 1, currency: 'USD' })

Please follow the Registry Scripts guide to learn more about advanced usage.

First-Party Mode

This script supports First-Party Mode which routes all traffic through your domain for improved privacy and ad blocker bypass.

export default defineNuxtConfig({
  scripts: {
    firstParty: true,
    registry: {
      metaPixel: { id: '123456789012345'}
    }
  }
})

Example

Using Meta Pixel only in production while using the proxy to send events.

<script setup lang="ts">
const { proxy } = useScriptMetaPixel()

// noop in development, ssr
// just works in production, client
function handleAction() {
  proxy.fbq('track', 'Purchase', { value: 1, currency: 'USD' })
}
</script>

<template>
  <div>
    <button @click="handleAction">
      Send Event
    </button>
  </div>
</template>
idstring | number required

Your Meta (Facebook) Pixel ID.