Google Analytics Importer插件将Google Analytics报告导入Matomo实例。

当您运行导入时,您的Google Analytics(GA)属性将自动创建为网站进入马托莫(以及您的目标自定义尺寸)GA中的所有历史报告都将被导入,因此您可以在Matomo中查看所有web分析数据。

如果您发现错误或有任何反馈,请在Github上报告。

要求

注意:目前导入器插件只支持谷歌Analytics属性开始UA -. 该插件目前不支持属性ID以G. 我们正在努力添加对这些新属性ID的支持。

对于Matomo On亚博账号每天2000元出租-Premise和Matomo的WordPress:

注意:在某些情况下,插件不能在运行在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客户端配置:

  1. 登录到谷歌API控制台

  2. 点击选择一个项目在菜单上。

  3. 要创建新项目,请单击覆盖中的“新建项目”按钮:

  4. 给你的新项目起一个有用的名字(例如马托莫谷歌分析进口商).

  5. 创建项目后,在项目列表中手动选择该项目,然后单击“打开”。

  6. 点击图书馆在左侧的菜单中,然后搜索谷歌分析API,然后单击该项目谷歌分析API. 然后在该API的描述页面上,单击使可能按钮

  7. 同样的方法也适用于谷歌分析报告API

  8. 接下来我们需要设置OAuth同意屏幕。单击顶部的Google徽标返回仪表板,然后单击OAuth同意屏幕在左边的菜单中。如果您有Google Workspace帐户,请选择内部. 否则,选择外部的。然后单击创造

  9. 为你的应用选择一个名称,然后单击添加域并添加matomo实例的顶级域。马托莫云

  10. 从下面的下拉菜单中选择您的电子邮件地址用户支持电子邮件,并填写您的电子邮件地址开发人员联系信息
    重要提示:请勿上传应用程序徽标在这里,你需要将你的“应用”提交给谷歌进行验证,这可能需要几个月才能完成。

  11. 点击保存并继续然后单击添加或删除作用域

  12. 使用只读属性并单击更新然后点击保存并继续

  13. 接下来,我们需要添加测试用户以允许访问Google Analytics API范围。
    点击添加用户并输入您将用于访问Google Analytics数据的电子邮件地址。


  14. 点击保存并继续然后单击返回仪表板

  15. 去医院资格证书左边菜单上的选项卡

  16. 点击创建凭据

  17. 选择OAuth客户端ID

  18. 选择Web应用程序作为应用程序类型

  19. 例如,为应用程序设置名称Matomo https://matomo.my-website.example

  20. 点击添加URI在下面授权的JavaScript源代码并将其设置为您的Matomo URL域,例如:https://matomo.my-website.example
    注意:这需要是一个域。如果您已将Matomo安装到子目录中,则需要输入不带路径的域。(因此https://my-website.example万一https://my-website.example/matomo/)

  21. 点击添加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不必有子域,这只是一个示例。

  22. 输入两个URI后,单击创造完成创建OAuth客户端凭据的步骤

  23. 现在您将看到刚刚创建的OAuth凭据,您可以单击好啊要关闭此对话框,然后通过单击凭据概述页面上的下载图标下载OAuth客户端凭据。(注意:如果您稍后更改了上述任何设置,例如为了修复其中一个值中的键入错误,则需要再次下载OAuth凭据并在Matomo中重新上载。)

创建OAuth客户端配置的步骤现已完成。在此过程中创建的“应用程序”可以保留为“测试”或“测试阶段”应用程序,无需提交审查。
在这些步骤中,你不会被要求将你的“应用程序”提交给谷歌进行验证。如果系统提示您提交“应用程序”,但您没有选择单击“否”或“取消”,请再次查看本指南中的步骤,以确保您没有错过重要步骤,或在不必要的情况下添加其他信息。

在完成OAuth过程时,您可能仍然会收到来自Google的警告,称“Google尚未验证此应用程序”。
在这种情况下,您可以通过点击“高级”,然后“转到matomo”安全地继续。云(不安全)”或“去yourdomain.com(不安全)”

3) 授权马托莫

下载OAuth客户端凭据后,您可以授权您的Matomo访问您的Google Analytics数据:

  1. 以用户身份登录超级用户然后去政府

  2. 在左侧菜单中,单击系统然后谷歌分析进口。如果没有看到此菜单,请确保已安装GoogleAnalyticImporter插件

  3. 上载在中下载的OAuth客户端凭据如何设置谷歌OAuth客户端配置点击配置文件,选择文件,然后单击拯救
    上载导入程序的客户端配置

  4. 现在,点击批准并根据提示让Matomo访问您的谷歌Analytics数据。
    授权进口商

重要提示:如果你选择外部的在配置谷歌项目时,您可能需要定期重新授权Matomo。谷歌确保对测试用户的授权外部的项目将在七天后到期,此时导入将失败,您必须重新授权Matomo。不幸的是,解决这一问题的唯一方法是临时购买一个Google Workspace帐户并使您的项目内部

运行谷歌分析导入

授权Matomo后,即可开始导入数据。这主要是通过管理页面完成的,不过您也可以使用命令行。根据导入的数据量,完成导入可能需要很长时间(大多数情况下超过一天)。

注意:谷歌对你每天可以发出的API请求数量设置了一个每日限制(最多50000个)。在导入大约4个月的数据(每天都有数据)后,导入将达到此限制。这只需要几个小时。这意味着导入必须运行数天,直到导入整个数据集。

使用管理页面

要使用管理UI,请执行以下操作:

  1. 去医院谷歌分析进口管理页面。
  2. 填写表格安排导入表单并单击开始:

    附表进口表格

  3. 随着导入的继续,您将能够通过进口工作下表:

    导入作业列表

    随时刷新页面以获取更新的状态。

  4. 导入标记为完成后,可以随时删除状态。如果导入失败,您可以查看位于中的日志/路径/to/your/matomo/tmp/logs/.每项工作都应该有一个。

使用命令行

如果希望在导入过程中查看有关其进度的更多信息,也可以在命令行上运行导入:

  1. 首先你需要一些信息。在Google Analytics仪表板中,打开属性选择器。
  2. 注意属性ID视图ID对于要导入的属性/视图。
  3. ssh进入你的Matomo实例
  4. 运行以下命令以导入站点:
    $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。