Google Adsense
Google AdSense allows you to monetize your website by displaying relevant ads from Google.
Nuxt Scripts provides:
useScriptGoogleAdsense(): A composable to manage Google AdSense dynamically.<ScriptGoogleAdsense>: A headless component to embed ads directly in your Nuxt app.
Nuxt Config Setup
The simplest way to load Google Adsense globally in your Nuxt App is to use Nuxt config. Alternatively you can directly use the useScriptGoogleAdsense composable.
export default defineNuxtConfig({
scripts: {
registry: {
googleAdsense: {
client: 'ca-pub-1234567890123456'
}
}
}
})useScriptGoogleAdsense()
The useScriptGoogleAdsense composable lets you have fine-grain control over when and how Google Adsense is loaded on your site.
const { proxy } = useScriptGoogleAdsense()
// ad slots render automaticallyPlease follow the Registry Scripts guide to learn more about advanced usage.
First-Party Mode
This script supports First-Party Mode which is auto-enabled, routing all traffic through your domain for improved privacy and ad blocker bypass.
export default defineNuxtConfig({
scripts: {
registry: {
googleAdsense: {
client: 'ca-pub-1234567890123456'
}
}
}
})Example
Using Google Adsense only in production while using the proxy to send events.
<script setup lang="ts">
const { proxy } = useScriptGoogleAdsense()
// noop in development, ssr
// just works in production, client
function handleAction() {
// ad slots render automatically
}
</script>
<template>
<div>
<button @click="handleAction">
Send Event
</button>
</div>
</template>Where to Find <your-id> (Publisher ID)
Find your Google AdSense Publisher ID (also known as ca-pub-XXXXXXX) in your Google AdSense Account:
- Log in to your Google AdSense account.
- Navigate to Account > Settings (click on your profile icon > "Account information").
- Locate the Publisher ID under Account Information.
- Replace
<your-id>in the config above with your actual ID.
Site Ownership Verification
Automatic Meta Tag Insertion
If you provide a client, Nuxt automatically inserts a meta tag on the page for Google to verify your site ownership.
export default defineNuxtConfig({
scripts: {
registry: {
googleAdsense: {
client: 'ca-pub-<your-id>', // AdSense Publisher ID
},
},
},
})
<meta name="google-adsense-account" content="ca-pub-<your-id>" />
Using ads.txt for Verification
Google recommends adding an ads.txt file for ad revenue eligibility.
Steps:
- Create a new file:
public/ads.txt - Add the following content:
google.com, pub-<your-id>, DIRECT, f08c47fec0942fa0 - Replace
<your-id>with your AdSense Publisher ID.
ads.txt? It helps prevent ad fraud and ensures that only your site can display your ads.Enabling Auto Ads
Auto Ads allow Google to automatically place ads for better optimization.
export default defineNuxtConfig({
scripts: {
registry: {
googleAdsense: {
client: 'ca-pub-<your-id>', // AdSense Publisher ID
autoAds: true, // Enable Auto Ads
},
},
},
})
<script>
(adsbygoogle = window.adsbygoogle || []).push({
google_ad_client: "ca-pub-<your-id>",
enable_page_level_ads: true,
});
</script>
Using <ScriptGoogleAdsense> Component
It provides a simple way to embed ads in your Nuxt app.
<template>
<ScriptGoogleAdsense
data-ad-client="ca-pub-<your-id>"
data-ad-slot="1234567890"
data-ad-format="auto"
/>
</template>
Component Props
| Prop | Description |
|---|---|
data-ad-client | Your Google Adsense Publisher ID(ca-pub-XXXXXXXXXX). |
data-ad-slot | Your Ad Slot ID (available in AdSense dashboard). |
data-ad-format | Ad format type (auto, rectangle, horizontal, vertical, fluid, autorelaxed). |
data-ad-layout | Layout (in-article, in-feed, fixed). |
data-full-width-responsive | Set to true to make the ad responsive. |
Example Usage with data-ad-layout
To specify a layout for your ads (such as "in-article"), you can use the data-ad-layout attribute:
<template>
<ScriptGoogleAdsense
data-ad-client="ca-pub-<your-id>"
data-ad-slot="1234567890"
data-ad-format="fluid"
data-ad-layout="in-article"
/>
</template>
How to Handle Ad-Blockers?
If a user has an ad-blocker enabled, you can show fallback content.
<template>
<ScriptGoogleAdsense data-ad-client="ca-pub-..." data-ad-slot="...">
<template #error>
<!-- Fallback content -->
<p>Please support us by disabling your ad blocker.</p>
</template>
</ScriptGoogleAdsense>
</template>
Using useScriptGoogleAdsense() Composable
The useScriptGoogleAdsense() composable allows fine-grain control over the AdSense script.
export function useScriptGoogleAdsense<T extends GoogleAdsenseApi>(
_options?: GoogleAdsenseInput
) {}
See the Registry Scripts Guide for advanced usage.
clientstringThe Google Adsense ID.
autoAdsboolean = falseEnable or disable Auto Ads.