设置谷歌分析导入

您的Matomo实例需要访问谷歌API来导入谷歌Analytics数据。该API是谷歌分析报告API，有几个选项如何设置访问Matomo。

授权Matomo访问您的数据的一种方法是建立一个谷歌应用程序-您可以通过创建谷歌OAuth客户端配置来做到这一点。当您创建这个配置时，您可以在谷歌API控制台中选择两种类型的应用程序:外部或内部。

外部应用程序

任何人都可以创建外部应用程序。在大多数情况下，我们建议创建一个已发布的外部应用程序，以确保导入工作无缝进行。如果你不想或不能发布应用，你仍然可以继续。但是，对于未发布的应用程序，谷歌在授权后设置了7天的限制，之后授权将过期。你必须手动每7天重新授权Matomo，直到您的导入完成。

内部应用程序

内部应用程序没有7天的过期时间。使用内部应用程序，你只需要授权Matomo一次，但是，内部应用程序只对已经购买的用户开放谷歌的工作空间．如果你订阅了谷歌工作空间，你可以使用内部应用程序从谷歌Analytics导入数据。

创建谷歌OAuth客户端配置

重要提示:在这些步骤中，您将不需要将您的“应用程序”提交到谷歌进行验证。如果你被提示提交你的“应用程序”，但没有点击的选项没有或取消，然后请再次检查本指南中的步骤，以确保没有遗漏重要步骤，或在不必要的地方添加额外信息。

按照以下步骤获取您的OAuth客户端配置:

  1. 登录到谷歌API控制台

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

  3. 要创建一个新项目，点击覆盖层中的“新建项目”按钮:

  4. 为您的新项目取一个有用的名称(例如Matomo谷歌分析进口商）.

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

  6. 点击图书馆在左边的菜单中，然后搜索谷歌分析API，然后单击该项目谷歌分析API．然后在该API的描述页面上，单击启用按钮。

  7. 对谷歌分析报告API．

  8. 对谷歌分析数据API除非你想要迁移谷歌分析数据．

  9. 对谷歌分析管理API除非你想要迁移谷歌分析数据．

  10. 接下来我们需要设置OAuth Consent屏幕。点击菜单图标旁边的谷歌标志在顶部和导航到api和服务>OAuth同意屏幕在左边的菜单中。如果您有一个谷歌工作区帐户，请选择内部．否则,选择外部．然后单击创建．

  11. 为您的应用程序选择一个名称，然后单击加域并添加你的matomo实例的顶级域。matomo.cloud

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

  13. 点击保存并继续对于两者作用域而且测试用户步骤。

  14. 在Summary步骤中单击返回仪表盘

  15. 如果你之前将应用类型设置为“内部”，那么你不需要在这里将应用状态设置为“发布”，可以跳过第15和16步
    在仪表板上，单击发布应用程序下发布状态

  16. 确认弹出窗口显示“您不需要提交应用程序进行验证”，然后单击确认

  17. 去凭证选项卡在左侧菜单

  18. 点击创建凭证

  19. 选择OAuth客户端ID

  20. 选择Web应用程序随着应用程序类型

  21. 例如，为应用程序设置一个名称Matomo在https://matomo.my-website.example

  22. 点击添加URI下授权JavaScript来源并将其设置为您的Matomo URL域，例如:https://matomo.my-website.example
    注意:这需要是一个域。如果您已将Matomo安装到子目录中，则需要输入不带路径的域。(所以https://my-website.example如果https://my-website.example/matomo/）

  23. 点击添加URI下授权重定向uri．这需要设置为您的Matomo URL与这个特殊的URL/查询/ index . php ?模块= GoogleAnalyticsImporter&action = processAuthCode最后添加。例如:https://matomo.my-website.com/index.php?module=GoogleAnalyticsImporter&action=processAuthCode
    注意:上面的url是HTTPS:我们强烈建议您运行您的Matomo实例通过SSL．如果您的Matomo还不支持https，您可以替换URL并使用http。
    如果你正在使用Matomo WordPress:URL必须以Matomo管理页面的整个路径开头，例如，http://mysite.com/wp-content/plugins/matomo/app/index.php?module=GoogleAnalyticsImporter&action=processAuthCode
    注意:Matomo的URL不一定要有子域，这只是一个例子。

  24. 输入两个uri后，单击创建完成OAuth客户端凭证的创建

  25. 现在，您将看到刚刚创建的OAuth凭据。点击下载JSON下载OAuth凭据。
    (注意:如果你在后面修改了上面的任何设置，例如修复了其中一个值的错字，你将需要再次下载OAuth凭证并在Matomo中重新上传它。)

创建OAuth客户端配置的步骤现在已经完成。
在这些步骤的任何时候，你都不会被要求提交你的“应用程序”到谷歌进行验证。如果你被提示提交你的“应用”，但没有选择“否”或“取消”，那么请再次检查本指南中的步骤，以确保你没有错过重要的步骤，或者在不必要的地方添加额外的信息。

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

3)授权Matomo

一旦您下载了OAuth客户端凭据，您可以授权您的Matomo访问您的谷歌Analytics数据:

  1. 登录为超级用户在Matomo，然后去政府．

  2. 在左侧菜单中，单击系统然后谷歌分析导入．如果您没有看到此菜单，请确保您已安装GoogleAnalyticsImporter插件．

  3. 上传您下载的OAuth客户端凭证如何设置谷歌OAuth客户端配置通过点击配置文件，选择文件，单击保存．
    上传导入器的客户端配置

  4. 现在,点击授权并按照提示让Matomo访问您的谷歌分析数据。
    授权进口商

重要提示:如果你选择了外部当配置您的谷歌项目并且还没有发布应用程序时，您可能需要定期重新授权Matomo。谷歌确保测试用户的授权外部项目将在7天内到期，此时您的导入将失败，您将不得不重新授权Matomo。不幸的是，解决这个问题的唯一方法是临时购买一个谷歌工作空间帐户并创建您的项目内部．

下一个常见问题：运行谷歌Analytics导入
Baidu