导入谷歌分析数据
Google Analytics Importer插件将Google Analytics报告导入Matomo实例。
当您运行导入时,您的Google Analytics(GA)属性将自动创建为网站进入马托莫(以及您的目标和自定义尺寸)GA中的所有历史报告都将被导入,因此您可以在Matomo中查看所有web分析数据。
要求
注意:目前导入器插件只支持谷歌Analytics属性开始UA -
. 该插件目前不支持属性ID以G
. 我们正在努力添加对这些新属性ID的支持。
对于Matomo On亚博账号每天2000元出租-Premise和Matomo的WordPress:
- 使用Google Analytics importer至少需要Matomo 3.12.0。
- PHP配置需要允许使用这些函数
shell_exec()
或行政长官()
- 您的服务器必须允许从web请求中执行CLI PHP,并且必须具有
诺胡普
可获得的 - 你的Matomo实例应该有cron存档设置.
- 继续安装谷歌Analytics Importer插件在你的马托莫遵循这些步骤。
注意:在某些情况下,插件不能在运行在Windows上的服务器上工作,我们正在调查这个问题,并将很快提供一个修复。
马托莫云
- 我们的云托管服务自动满足所有要求。
安装程序
在我们开始从API导出Google Analytics数据并将其导入您的Matomo之前,有两个设置步骤需要完成:1)创建Google OAuth客户端配置,2)授权Matomo导出您的Google Analytics数据。这两个步骤只需执行一次。
1)可选:购买临时产品谷歌工作区账户
此步骤不是必需的,但可以简化导入过程。
可以在GoogleAPI控制台中定义两种类型的Google项目:外部和内部。
任何人都可以创建外部应用程序,但谷歌对API授权的使用时间设置了限制:一周后,API授权将过期。使用这种类型的应用程序,您必须人工每周重新授权Matomo,以便您的导入继续运行。这是不幸的,但谷歌制定了这一政策,我们没有办法解决。
另一方面,内部应用就没有这种限制。使用内部应用程序,你只需要授权Matomo一次,但是,内部应用程序只对已购买的用户可用谷歌工作区. 如果您想避免定期重新授权Matomo带来的不便,建议您购买一个帐户,无论您需要多长时间从Google Analytics运行导入。
2) 创建GoogleOAuth客户端配置
开始之前请注意重要事项:在这些步骤中,任何时候都不会要求您将“应用程序”提交给谷歌进行验证。如果系统提示您提交“应用程序”,但您没有单击的选项不或取消,然后请再次查看本指南中的步骤,以确保您没有错过重要步骤,或在不必要的情况下添加其他信息。
遵循以下步骤获得你的OAuth客户端配置:
登录到谷歌API控制台
点击选择一个项目在菜单上。
要创建新项目,请单击覆盖中的“新建项目”按钮:
给你的新项目起一个有用的名字(例如
马托莫谷歌分析进口商
).创建项目后,在项目列表中手动选择该项目,然后单击“打开”。
点击图书馆在左侧的菜单中,然后搜索谷歌分析API,然后单击该项目谷歌分析API. 然后在该API的描述页面上,单击使可能按钮
同样的方法也适用于谷歌分析报告API.
接下来我们需要设置OAuth同意屏幕。单击顶部的Google徽标返回仪表板,然后单击OAuth同意屏幕在左边的菜单中。如果您有Google Workspace帐户,请选择内部. 否则,选择外部的。然后单击创造.
为你的应用选择一个名称,然后单击添加域并添加matomo实例的顶级域。马托莫云
从下面的下拉菜单中选择您的电子邮件地址用户支持电子邮件,并填写您的电子邮件地址开发人员联系信息
重要提示:请勿上传应用程序徽标在这里,你需要将你的“应用”提交给谷歌进行验证,这可能需要几个月才能完成。点击保存并继续然后单击添加或删除作用域
使用
只读
属性并单击更新然后点击保存并继续接下来,我们需要添加测试用户以允许访问Google Analytics API范围。
点击添加用户并输入您将用于访问Google Analytics数据的电子邮件地址。点击保存并继续然后单击返回仪表板
去医院资格证书左边菜单上的选项卡
点击创建凭据
选择OAuth客户端ID
选择Web应用程序作为应用程序类型
例如,为应用程序设置名称
Matomo https://matomo.my-website.example
点击添加URI在下面授权的JavaScript源代码并将其设置为您的Matomo URL域,例如:
https://matomo.my-website.example
注意:这需要是一个域。如果您已将Matomo安装到子目录中,则需要输入不带路径的域。(因此https://my-website.example
万一https://my-website.example/matomo/
)点击添加URI在下面授权重定向uri.这需要通过这个特殊的URL/查询设置为Matomo URL
/php?module=GoogleAnalyticsImporter&action=processAuthCode
加在末尾。例如:https://matomo.my-website.com/index.php?module=GoogleAnalyticsImporter&action=processAuthCode
注意:上面的URL是HTTPS:我们强烈建议您运行Matomo实例通过SSL. 如果您的Matomo还不支持https,您可以替换URL并使用http。
如果您正在使用Matomo for WordPress:URL必须以Matomo的管理页面的整个路径开始,例如,http://mysite.com/wp-content/plugins/matomo/app/index.php?module=GoogleAnalyticsImporter&action=processAuthCode
注意:Matomo的URL不必有子域,这只是一个示例。输入两个URI后,单击创造完成创建OAuth客户端凭据的步骤
现在您将看到刚刚创建的OAuth凭据,您可以单击好啊要关闭此对话框,然后通过单击凭据概述页面上的下载图标下载OAuth客户端凭据。(注意:如果您稍后更改了上述任何设置,例如为了修复其中一个值中的键入错误,则需要再次下载OAuth凭据并在Matomo中重新上载。)
创建OAuth客户端配置的步骤现已完成。在此过程中创建的“应用程序”可以保留为“测试”或“测试阶段”应用程序,无需提交审查。
在这些步骤中,你不会被要求将你的“应用程序”提交给谷歌进行验证。如果系统提示您提交“应用程序”,但您没有选择单击“否”或“取消”,请再次查看本指南中的步骤,以确保您没有错过重要步骤,或在不必要的情况下添加其他信息。
在完成OAuth过程时,您可能仍然会收到来自Google的警告,称“Google尚未验证此应用程序”。
在这种情况下,您可以通过点击“高级”,然后“转到matomo”安全地继续。云(不安全)”或“去yourdomain.com(不安全)”
3) 授权马托莫
下载OAuth客户端凭据后,您可以授权您的Matomo访问您的Google Analytics数据:
以用户身份登录超级用户然后去政府.
在左侧菜单中,单击系统然后谷歌分析进口。如果没有看到此菜单,请确保已安装GoogleAnalyticImporter插件.
上载在中下载的OAuth客户端凭据如何设置谷歌OAuth客户端配置点击配置文件,选择文件,然后单击拯救.
重要提示:如果你选择外部的在配置谷歌项目时,您可能需要定期重新授权Matomo。谷歌确保对测试用户的授权外部的项目将在七天后到期,此时导入将失败,您必须重新授权Matomo。不幸的是,解决这一问题的唯一方法是临时购买一个Google Workspace帐户并使您的项目内部.
运行谷歌分析导入
授权Matomo后,即可开始导入数据。这主要是通过管理页面完成的,不过您也可以使用命令行。根据导入的数据量,完成导入可能需要很长时间(大多数情况下超过一天)。
注意:谷歌对你每天可以发出的API请求数量设置了一个每日限制(最多50000个)。在导入大约4个月的数据(每天都有数据)后,导入将达到此限制。这只需要几个小时。这意味着导入必须运行数天,直到导入整个数据集。
使用管理页面
要使用管理UI,请执行以下操作:
- 去医院谷歌分析进口管理页面。
填写表格安排导入表单并单击开始:
随着导入的继续,您将能够通过进口工作下表:
随时刷新页面以获取更新的状态。
导入标记为完成后,可以随时删除状态。如果导入失败,您可以查看位于中的日志
/路径/to/your/matomo/tmp/logs/
.每项工作都应该有一个。
使用命令行
如果希望在导入过程中查看有关其进度的更多信息,也可以在命令行上运行导入:
- 首先你需要一些信息。在Google Analytics仪表板中,打开属性选择器。
- 注意属性ID和视图ID对于要导入的属性/视图。
ssh
进入你的Matomo实例- 运行以下命令以导入站点:
$cd/path/to/my/matomo
$php./console GoogleAnalyticImporter:导入报告--属性=--视图= --日期=
对于属性id
和视图id
替换上面提到的GA属性ID和视图ID。对于日期
指定要导入的日期的日期范围,例如,2015-01-01, 2019-04-31
.
然后等待导入完成,这可能需要一些时间。
如果您想恢复现有的导入,请提供--idsite=
参数,该参数包含为此导入创建的站点(这将位于“管理”页面的“导入状态”表中)。
导入完成后,可以删除先前授予的授权。Matomo只需要在导入数据时访问Google Analytics,之后将其保存在那里就没有意义了。
进口商选择
导入移动应用程序属性
如果您的GA属性用于移动应用程序,则需要检查移动应用
开始导入前的复选框:
这将确保Matomo导入正确的数据。谷歌Analytics中的屏幕视图指标将被导入,并用作matomo中的页面视图指标。屏幕报告将被导入到Matomo的页面标题报告中。
如果你不勾选此框,而你的属性是针对移动应用程序的,导入器将忽略此数据。
导入不支持的GA维度
一些GA维度在Matomo中不存在,例如人口统计维度。您可能希望在导入时保留此信息,可以通过将数据导入自定义维度来实现。
在导入表单中,用要导入的GA维度填写“额外自定义维度映射”字段:
使用此列表找到GA尺寸的正确ID。
导入时,对于每个额外的映射,导入站点中将使用一个自定义维度槽。(注意:如果您的Matomo中没有足够的自定义标注槽,则会出现错误。)
进口后
将数据导入Matomo后,最好备份Matomo的数据库。如果要清除或以某种方式删除导入的报告数据,则必须从GA重新导入数据。如果GA属性已被删除,则数据将永远消失。
如果您定期备份数据库(或者您的主机为您备份),那么您就不必担心这一点。
从Google Analytics切换的工作流
切换到Matomo时,有几种方法可以使用导入器保留您的Google Analytics数据。本节详细介绍了您可以使用的可能工作流。
设置跟踪到您的matomo并导入带有结束日期的站点
就设置和监控而言,这是最简单的方法。为此,请开始导入旧数据并将结束日期设置为使用Matomo开始跟踪的日期(例如今天的日期),使用新创建站点的跟踪代码并开始跟踪。
确保导入结束日期和开始跟踪的日期没有重叠。例如,如果您在11月12日开始跟踪,请确保导入结束日期为11月11日。
然后,只要你准备好了,就用GA结束你的跟踪从谷歌分析常见问题迁移.
导入到站点并继续导入,直到您准备好停止跟踪到GA
另一种选择是持续导入Matomo,同时仍然跟踪GA。对于这种方法,您可以在不指定结束日期的情况下启动导入。这将导致导入每天都在导入。
当您准备好切换到Matomo时,您可以手动取消导入并开始跟踪Matomo(请确保在取消导入之前已准备好开始跟踪,因为如果需要几天时间进行设置,这些天在Matomo中将不会有数据)。然后您可以停止跟踪到GA。
如果您正在评估Matomo,但还没有准备好投入时间设置对您的Matomo的跟踪,则此方法可能非常有用。
故障排除
我的import永远不会继续
当你开始导入时,插件会在后台开始导入。最终,如果您导入的数据量足够大,那么它将受到速率限制,并将被迫在第二天继续。延续是通过一个计划好的任务来完成的。
为了让计划任务运行,您首先需要设置cron存档. 这是启动计划任务的地方。
完成cron归档设置后,请使用任务可估计插件确定计划任务下次运行的时间(相关任务将具有Piwik\Plugins\GoogleAnalyticImporter\Tasks
以我的名义)。
如果这些任务从未运行过,即使它们已列出,那么cron归档命令中也会出现故障。调试的下一步是检查命令的输出。
我的导入运行了X分钟,然后就停止了
如果您使用的是共享主机,那么您的主机可能只是在一段时间后终止进程。这不是马托莫或你能解决的问题。你要么和你的主人谈谈,要么找到另一种方式来招待马托莫。
如果这两种方法都不适合你,你可以尝试以下方法:
尝试通过CLI命令而不是通过UI导入数据。执行此操作时,请确保使用的PHP可执行文件是CLI PHP版本,而不是其他版本(例如,php7 CLI vs php7 fcgi)。通过运行
php——版本
.寻找像这样的输出PHP 7.2.1(cli)
. 您的主机可能会允许CLI PHP执行运行更长时间。如果在一定时间后可靠地终止了进程,则可以设置一个cron作业来重新启动导入。例如,如果您的导入在15分钟后终止,您可以设置一个cron,使其每20分钟运行一次,从而恢复导入。为此,在UI中启动导入,并记录新创建站点的ID。然后使用
googleanalyticsimporter: import-reports
命令--idsite=
选项(例如:php/path/to/matomo/console-GoogleAnalyticImporter:import-reports--idsite=
).
我的导入每次都在同一天失败
如果您的导入在特定的一天内经常失败,那么您可能在导入过程中发现了一个bug。在这种情况下,您应该在github存储库.为了帮助我们更快的找到原因,请在提交报告时做以下事情:
- 为失败的特定日期启动新导入,并选中表单底部的“启用详细日志记录”复选框:
- 当导入再次遇到错误时,在服务器上查找用于导入的日志文件(它将被命名为
/道路/ /你/ matomo / tmp /日志/ gaimportlog。idSite。matomoHost.log美元
).电邮至support@www.hju8.com(最好不要在bug报告中发布内容,因为它可能包含有关服务器的信息)。 - 取消进口。
这将帮助我们调试您遇到的问题,尽管我们可能仍然无法找到原因。在这种情况下,如果您能够提供对Google Analytics帐户的只读访问,我们将能够进一步调试该问题。
局限性
并非Google Analytics中的所有数据都可以通过API访问,请在下面的数据报告列表中查找Matomo中不会显示的数据报告:
- 导入器仅导入聚合报告数据,而不是原始访问和操作数据。这意味着访问日志,
电子商务日志和分段功能不适用于导入的报告。
这也意味着非日间时段(如周和月时段)的唯一访客度量和用户度量将不可用。 - Google Analytics不支持Matomo中的某些报告,例如“无结果的搜索关键字”和内容报告。这些报告在导入后不会显示数据。
- 谷歌Analytics的一些报告还没有导入Matomo(如Funnels报告)。如果您在Matomo发现任何您希望看到进口的丢失报告,请告知我们详情在本期《追踪器》中.
- 谷歌从内部站点搜索URL中删除搜索参数,但在页面URL报告中显示这些URL。这意味着,当我们导入该报告时,我们无法判断其中一个页面是否确实是内部站点搜索,因此在导入的报告中,站点搜索页面URL将包含在页面URL和页面标题报告中。
- 谷歌的电子商务转化率不同于马托莫。Google将其定义为每个会话的事务数,Matomo将其定义为至少有一个订单的访问百分比。因此,无法导入此度量。
- 谷歌的出入境率与马托莫不同。Matomo将进入/退出率定义为页面URL/页面标题成为访问中第一个/最后一个页面视图的次数百分比。在Google Analytics中,比率定义为页面URL/标题是会话中第一个/最后一个页面视图的所有点击的百分比。因此,马托莫的利率将有所不同。
- 此外,谷歌Analytics在记录页面浏览量时并不总是设置会话计数(参见他们的文件更多信息)。这意味着Google Analytics不会统计某些会话,并且会话计数可能低于某些操作的应有值。在这种情况下,出入口率将计算为>100%。这不会影响谷歌分析,因为那里的进入/退出率是使用点击总数而不是会话数计算的。
- 产品报告缺少产品转化率和访问量指标,因为无法通过Google Analytics API使用产品维度查询会话。
- 导入器假定您已经安装了GeoIp2。如果不这样做,数据将被正确导入,但报告将显示许多未知区域,直到安装GeoIp2。