---
title: "TikTok Pixel"
description: "Use TikTok Pixel in your Nuxt app."
canonical_url: "https://scripts.nuxt.com/scripts/tiktok-pixel"
last_updated: "2026-05-03T02:50:03.465Z"
---

[TikTok Pixel](https://ads.tiktok.com/help/article/tiktok-pixel) lets you measure, optimize and build audiences for your TikTok ad campaigns.

Nuxt Scripts provides a registry script composable [`useScriptTikTokPixel()`](/scripts/tiktok-pixel) to easily integrate TikTok Pixel in your Nuxt app.

<script-stats>



</script-stats>

<script-docs>



</script-docs>

## Identifying Users

You can identify users for advanced matching:

```ts
const { proxy } = useScriptTikTokPixel()

proxy.ttq('identify', {
  email: 'user@example.com',
  phone_number: '+1234567890'
})
```

## Disabling Auto Page View

By default, TikTok Pixel tracks page views automatically. To disable:

```ts
export default defineNuxtConfig({
  scripts: {
    registry: {
      tiktokPixel: {
        id: 'YOUR_PIXEL_ID',
        trackPageView: false
      }
    }
  }
})
```

## Consent Mode

TikTok Pixel exposes a three-state consent API: grant, revoke, or hold (defer the decision). Set the initial state with `defaultConsent` and call `consent.grant()` / `consent.revoke()` / `consent.hold()` at runtime:

```vue
<script setup lang="ts">
const { consent } = useScriptTikTokPixel({
  id: 'YOUR_PIXEL_ID',
  defaultConsent: 'hold', // 'granted' | 'denied' | 'hold'
})

function acceptAds() {
  consent.grant()
}
function rejectAds() {
  consent.revoke()
}
</script>
```

See the [TikTok cookie consent docs](https://business-api.tiktok.com/portal/docs?id=1739585600931842) for the full behaviour.

<script-types>



</script-types>