注意:此分支适用于NUXT 3兼容模块。 Checkout legacy-v2
分支NUXT 2支持。
nuxt.js的Google Adsense集成每当页面路由更改时,广告都会更新
@nuxtjs/google-adsense
依赖性使用YARN或NPM@nuxtjs/google-adsense
到nuxt.config.js
的modules
部分 {
modules : [
// Simple usage
[ '@nuxtjs/google-adsense' , {
id : 'ca-pub-###########'
} ]
]
}
使用顶级选项:
{
modules : [
[ '@nuxtjs/google-adsense' ]
] ,
googleAdsense : {
id : 'ca-pub-#########'
}
}
使用运行时配置:
{
modules : [
[ '@nuxtjs/google-adsense' ]
] ,
googleAdsense : {
onPageLoad : false ,
pageLevelAds : false ,
} ,
publicRuntimeConfig : {
googleAdsense : {
id : process . env . GOOGLE_ADSENSE_ID ,
test : process . env . GOOGLE_ADSENSE_TEST_MODE === 'true' ,
} ,
} ,
}
异步广告代码( //pagead2.googlesyndication.com/pagead/js/adsbygoogle.js
)自动添加到页面的<head>
部分中。
选项 | 类型 | 描述 |
---|---|---|
id | 细绳 | 您的Google Adsense Publisher客户端ID(即ca-pub-######### )。不在测试模式时需要。 |
adFormat | 细绳 | 设置全局默认广告格式。可以用组件道具覆盖。 |
analyticsDomainName | 细绳 | Google Analytics(分析)帐户域(如果将分析与Adsense链接,即example.com )。 |
analyticsUacct | 细绳 | Google Analytics(分析)帐户ID(如果将分析与Adsense链接,则UA-#######-# )。 |
hideFilled | 布尔 | 当false 无填充广告被隐藏时,将不会隐藏错误true 广告。默认值为false 。 |
includeQuery | 布尔 | 当false 时,仅$route.path 检查更改。如果设置为true $route.query 也将考虑在内。默认值为false 。 |
onPageLoad | 布尔 | 页面加载后加载adsense脚本。默认值为false 。 |
overlayBottom | 布尔 | 启用Adsense锚广告在底部显示。默认值为false 。有关详细信息,请参阅Adsense文档。 |
pageLevelAds | 布尔 | 启用Adsense页面级广告。默认值为false 。有关详细信息,请参阅Adsense文档。 |
pauseOnLoad | 布尔 | 暂停广告请求,以获取用户同意使用cookie或其他本地存储,根据GDPR。有关详细信息,请参阅Adsense文档。 false 。 |
tag | 细绳 | adsense组件标签名称。默认为adsbygoogle 。 |
test | 布尔 | 将adsense迫使测试模式(见下文)。 |
在dev
模式下运行NUXT时,Adsense模块将自动切换到test
模式。但是,您可以通过将配置选项test
设置为true
来保持生产中的测试模式。
测试模式使用测试出版商ID,因此您不会违反Adsense TOS。
请注意,测试广告通常会作为空白空间出现,但将具有正确的尺寸(即,渲染广告所需的正确空间)。
插入<Adsbygoogle />
组件,无论您想在哪里放置广告。
您应该将<Adsbygoogle />
组件放置在具有指定(min /max)宽度和(min /max)高度(可以基于媒体查询)的容器元素中,或在<Adsbygoogle />
将广告限制为特定尺寸(或尺寸)的组件。
使用ad-slot
属性指定您的Google Adsense广告插槽值(指定为字符串)。
有关更多信息,请参阅Adsense文档。 Google Adsense文档
组件道具:
支柱 | 类型 | 描述 |
---|---|---|
ad-slot | 细绳 | Google Adsense Adslot。当不处于测试模式时,需要此道具。请参阅您的AdSense帐户以获取广告插槽值。 |
ad-format | 细绳 | 选修的。有关其他选项,请参阅Adsense文档 |
ad-style | 目的 | 适用于渲染<ins> 元素的样式。默认值: { display: 'block' } 。有关对象格式,请参阅VUEJS样式绑定文档。 |
ad-layout | 细绳 | 选修的。参考Adsense文档 |
ad-layout-key | 细绳 | 选修的。参考Adsense文档 |
hide-unfilled | 布尔 | 选修的。如果是真的,请隐藏未填充的广告。 |
page-url | 细绳 | 选修的。如果广告在需要身份验证的页面上,请设置参考页URL(类似内容)。设置后,此支柱必须是完全合格的URL(包括协议和主机名)。 |
include-query | 布尔 | 覆盖全球选项includeQuery 按广告为基础。确保页面上的所有广告具有相同的设置。 |
analytics-uacct | 细绳 | Google Analytics(分析)帐户ID(如果将分析与Adsense链接,则UA-#######-# )。默认为插件选项analyticsUacct 中指定的值。 |
analytics-domain-name | 细绳 | Google Analytics(分析)帐户域(如果将分析与Adsense链接,即example.com )。默认为插件选项analyticsDomainName 中指定的值。 |
组件暴露了内部数据|名称|类型|描述| ____ | ____ | ___________ | showAd
|方法|触发显示AD方法以显示AD。 | updateAd
|方法|触发更新广告方法以刷新广告。 | isUnfilled
|计算的参考|跟踪广告元素的未填充属性。如果data-ad-state
=“未填充”,则返回true
。
每当您的路由更改或选择您的路由查询参数更改时,任何显示的广告都会像在正常页面加载上一样更新。
page-url
设置在<Adsbygoogle />
组件上的页面上,将公开访问的页面上的一个页面设置为“公开访问”的网站,其中将具有相似的 /相关内容。 该模块使用Angular团队开发的技术(在Google Adsense的帮助下)来处理渐进式Web应用程序上的更新广告:
每次请求新广告时,AdSense参数data-ad-region
都会更新为随机值。因此,您无法在<Adsbygoogle />
组件上设置data-ad-region
属性。
麻省理工学院许可证