导入谷歌分析数据用户指南-分析平台-马托莫

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

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

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

要求

注意:目前导入器插件只支持谷歌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访问您的谷歌Analytics数据。

重要提示：如果你选择外部的在配置谷歌项目时，您可能需要定期重新授权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。

要求