@amplitude/plugin-ga-events-forwarder-浏览器
Google 分析事件转发器的官方浏览器 SDK 插件
安装
该软件包发布在国家预防机制登记册上,可用npm和纱线安装.
# npm
npm install @amplitude/plugin-ga-events-forwarder-browser
# yarn
yarn add @amplitude/plugin-ga-events-forwarder-browser
使用量
这个插件在Amplitude浏览器SDK上方工作,它通过Google Analytics监听所跟踪的事件,并将这些事件发送到Amplitude. 要使用此插件, 您需要安装 @amplitude/analytics-browser 版本 v1.9.1 或后会.
如果使用片段加载器安装了Amplitude SDK,请遵循这些指令来加载此插件.
1. 加载振幅的Google分析事件转发器插件
在您的 Google Tag 标签片段之前, 加上 Google 分析事件转发器片段 。 之前添加它可确保您收集的所有 Google 分析( GA4) 事件被传送到 Amplition .
<script src="https://cdn.amplitude.com/libs/plugin-ga-events-forwarder-browser-0.2.0-min.js.gz"></script>
3. 浏览器装入高度SDK
<!-- Amplitude SDK -->
<script type="text/javascript">
!function(){"use strict";!function(e,t){var r=e.amplitude||{_q:[],_iq:{}};if(r.invoked)e.console&&console.error&&console.error("Amplitude snippet has been loaded.");else{var n=function(e,t){e.prototype[t]=function(){return this._q.push({name:t,args:Array.prototype.slice.call(arguments,0)}),this}},s=function(e,t,r){return function(n){e._q.push({name:t,args:Array.prototype.slice.call(r,0),resolve:n})}},o=function(e,t,r){e[t]=function(){if(r)return{promise:new Promise(s(e,t,Array.prototype.slice.call(arguments)))}}},i=function(e){for(var t=0;t<m.length;t++)o(e,m[t],!1);for(var r=0;r<y.length;r++)o(e,y[r],!0)};r.invoked=!0;var a=t.createElement("script");a.type="text/javascript",a.crossOrigin="anonymous",a.src="https://cdn.amplitude.com/libs/plugin-ga-events-forwarder-browser-0.2.0-min.js.gz",a.onload=function(){e.gaEventsForwarder&&e.gaEventsForwarder.plugin&&e.amplitude.add(e.gaEventsForwarder.plugin())};var c=t.createElement("script");c.type="text/javascript",c.integrity="sha384-HpnlFSsUOQTaqmMKb6/PqZKVOBEpRji3JNLr81x6XElQ4bkquzRyG/F8rY8IDMuw",c.crossOrigin="anonymous",c.async=!0,c.src="https://cdn.amplitude.com/libs/analytics-browser-2.2.1-min.js.gz",c.onload=function(){e.amplitude.runQueuedFunctions||console.log("[Amplitude] Error: could not load SDK")};var u=t.getElementsByTagName("script")[0];u.parentNode.insertBefore(a,u),u.parentNode.insertBefore(c,u);for(var p=function(){return this._q=[],this},d=["add","append","clearAll","prepend","set","setOnce","unset","preInsert","postInsert","remove","getUserProperties"],l=0;l<d.length;l++)n(p,d[l]);r.Identify=p;for(var g=function(){return this._q=[],this},v=["getEventProperties","setProductId","setQuantity","setPrice","setRevenue","setRevenueType","setEventProperties"],f=0;f<v.length;f++)n(g,v[f]);r.Revenue=g;var m=["getDeviceId","setDeviceId","getSessionId","setSessionId","getUserId","setUserId","setOptOut","setTransport","reset","extendSession"],y=["init","add","remove","track","logEvent","identify","groupIdentify","setGroup","revenue","flush"];i(r),r.createInstance=function(e){return r._iq[e]={_q:[]},i(r._iq[e]),r._iq[e]},e.amplitude=r}}(window,document)}();
</script>
3. 将 Amplitude 的 Google 分析事件转发器插件添加到 Amplitude SDK 以供浏览
您必须将“ YOUR API KEY” 替换为您实际的振幅 API 密钥, 您可以在您的振幅账户中找到 .
amplitude.add(gaEventsForwarder.plugin());
amplitude.add('YOUR_API_KEY');
如果你跟着,你应该到达 这样的东西.
<!-- Amplitude's GA events forwarder plugin -->
<script src="https://cdn.amplitude.com/libs/plugin-ga-events-forwarder-browser-0.2.0-min.js.gz"></script>
<!-- Amplitude SDK -->
<script type="text/javascript">
!function(){"use strict";!function(e,t){var r=e.amplitude||{_q:[],_iq:{}};if(r.invoked)e.console&&console.error&&console.error("Amplitude snippet has been loaded.");else{var n=function(e,t){e.prototype[t]=function(){return this._q.push({name:t,args:Array.prototype.slice.call(arguments,0)}),this}},s=function(e,t,r){return function(n){e._q.push({name:t,args:Array.prototype.slice.call(r,0),resolve:n})}},o=function(e,t,r){e[t]=function(){if(r)return{promise:new Promise(s(e,t,Array.prototype.slice.call(arguments)))}}},i=function(e){for(var t=0;t<m.length;t++)o(e,m[t],!1);for(var r=0;r<y.length;r++)o(e,y[r],!0)};r.invoked=!0;var a=t.createElement("script");a.type="text/javascript",a.crossOrigin="anonymous",a.src="https://cdn.amplitude.com/libs/plugin-ga-events-forwarder-browser-0.2.0-min.js.gz",a.onload=function(){e.gaEventsForwarder&&e.gaEventsForwarder.plugin&&e.amplitude.add(e.gaEventsForwarder.plugin())};var c=t.createElement("script");c.type="text/javascript",c.integrity="sha384-HpnlFSsUOQTaqmMKb6/PqZKVOBEpRji3JNLr81x6XElQ4bkquzRyG/F8rY8IDMuw",c.crossOrigin="anonymous",c.async=!0,c.src="https://cdn.amplitude.com/libs/analytics-browser-2.2.1-min.js.gz",c.onload=function(){e.amplitude.runQueuedFunctions||console.log("[Amplitude] Error: could not load SDK")};var u=t.getElementsByTagName("script")[0];u.parentNode.insertBefore(a,u),u.parentNode.insertBefore(c,u);for(var p=function(){return this._q=[],this},d=["add","append","clearAll","prepend","set","setOnce","unset","preInsert","postInsert","remove","getUserProperties"],l=0;l<d.length;l++)n(p,d[l]);r.Identify=p;for(var g=function(){return this._q=[],this},v=["getEventProperties","setProductId","setQuantity","setPrice","setRevenue","setRevenueType","setEventProperties"],f=0;f<v.length;f++)n(g,v[f]);r.Revenue=g;var m=["getDeviceId","setDeviceId","getSessionId","setSessionId","getUserId","setUserId","setOptOut","setTransport","reset","extendSession"],y=["init","add","remove","track","logEvent","identify","groupIdentify","setGroup","revenue","flush"];i(r),r.createInstance=function(e){return r._iq[e]={_q:[]},i(r._iq[e]),r._iq[e]},e.amplitude=r}}(window,document)}();
amplitude.add(gaEventsForwarder.plugin());
amplitude.add('YOUR_API_KEY');
</script>
为了保证谷歌分析事件全部被传送到Amplitude,在您Google标签之前添加所有与Aplitude相关的代码.
我在哪里找到我的谷歌标签?
您的谷歌 标记可以在您网站的每个页面中找到, 就在元素之后 。 您账户的 Google Tag 应该是下面的片段 .
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'G-XXXXXXXXXX');
</script>
如果您使用 npm 或 纱线安装了 Amplition SDK, 请遵循这些指令安装此插件 .
1. 进口宽度包
@amplitude/plugin-ga-events-forwarder-browser
import { gaEventsForwarderPlugin } from '@amplitude/plugin-ga-events-forwarder-browser';
2. 证明谷歌分析活动听众
const gaEventsForwarder = gaEventsForwarderPlugin();
3. 安装插件到振幅 SDK
amplitude.add(gaEventsForwarder);
4. 振幅SDK初始化
amplitude.init('API_KEY');
选项
| 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|
measurementIds | string 或者说 string[] | 默认值是 [] 它听所有事件 跟踪所有测量ID. | 谷歌分析测量ID或谷歌分析测量ID列表. 这限制了插件只听用指定的测量 ID/s 跟踪的事件 . 要听一个Google测量ID,通过字符串,例如: const gaEventsForwarder = gaEventsForwarderPlugin({ measurementIds: 'G-XXXXXXXXXX' });要听多个 Google 测量 ID, 通过一系列字符串, 例如 : const gaEventsForwarder = gaEventsForwarderPlugin({ measurementIds: ['G-XXXXXXXXXX', 'G-YYYYYYYYYY'] }); |