发布 Google Analytics 插件

2016年2月15日

发布 Google Analytics 插件

在“_你知道的越多_”的类别下，我们通过Google Analytics插件增加了对分析引擎的支持。

除了用户和会话数量等基本信息外，您还可以获得有关用户的丰富人口统计信息，例如城市、国家/地区、语言以及“新”用户与“回访”用户。您还可以获得详细信息，例如应用版本、运行的操作系统、设备类型、屏幕分辨率等。最后，您可以跟踪应用内的自定义事件，例如用户的操作，哪些 UI 元素互动最多等等。

设置 Google Analytics

要使用 Google Analytics，您必须首先在 www.google.com/analytics/ 上设置一个 Google 帐户。您可以在一个登录名下拥有最多 100 个帐户，每个帐户最多可以有 50 个媒体资源，每个媒体资源最多可以有 25 个视图。虽然您的每个应用都可以是自己的帐户，但您可能只需要一个帐户，并将每个应用作为它的唯一媒体资源即可。

首先，在此处激活 Google Analytics 插件。

接下来，您需要在应用程序的 build.settings 中包含该插件

settings =
{
    plugins =
    {
        ["plugin.googleAnalytics"] =
        {
            publisherId = "com.coronalabs",
            supportedPlatforms = { iphone=true, android=true, }
        },
    },
}

settings =

{

plugins =

{

["plugin.googleAnalytics"] =

{

publisherId = "com.coronalabs",

supportedPlatforms = { iphone=true, android=true, }

}

当您在 Google Analytics 信息中心创建一个媒体资源时，同时分配应用名称，您将获得一个唯一的跟踪 ID，例如 UA-12345678-1。您需要将这两个值都传递给 googleAnalytics.init() API。例如

local googleAnalytics = require( "plugin.googleAnalytics" )

googleAnalytics.init( "Mega Race 3000", "UA-12345678-1" )

local googleAnalytics = require( "plugin.googleAnalytics" )

googleAnalytics.init( "Mega Race 3000", "UA-12345678-1" )

记录分析事件

虽然仅仅设置 Google Analytics 就可以让您深入了解上述各种人口统计信息和设备相关详细信息，但您可能希望收集有关用户在应用内的操作的具体数据。一些示例包括

检查用户玩游戏的时间。如果结果未达到您的预期，您可能需要考虑添加奖励或额外功能。
检查用户玩游戏中特定关卡的频率和时长。
检查哪些选项/设置在广泛的用户群体中最受欢迎。

所有这些示例都涉及到使用 Google Analytics 记录事件。要记录事件，只需调用 googleAnalytics.logEvent() 函数

googleAnalytics.logEvent( category, action, label )

1	googleAnalytics.logEvent( category, action, label )

第一个参数 category 是一个必需参数，用于在 Google Analytics 中创建一个事件“组”。例如，可以使用诸如 "userAction" 之类的类别来跟踪用户执行的操作。或者，如果您的应用与服务器交互并且数据由服务器处理，您可能需要一个名为 "serverAction" 的类别。

第二个参数 action 是一个必需参数，它将特定操作与类别关联起来。例如，如果用户与游戏中的按钮交互，您可以在 "userAction" 类别中记录 "buttonPressed" 的操作。

第三个参数 label 是一个可选参数，允许您定义操作的附加信息，例如按下哪个特定按钮。例如，如果用户按下了游戏中的“播放”按钮，则您的 googleAnalytics.logEvent() 调用可能如下所示

googleAnalytics.logEvent( "userAction", "Button pressed", "Play" )

1	googleAnalytics.logEvent( "userAction", "Button pressed", "Play" )

最终，您可以选择记录哪些事件、何时记录以及原因。我们建议在确定哪些事件/操作对于分析应用中的用户行为有用时保持一定的自由裁量权。

跟踪屏幕/场景

Google Analytics 插件具有一个额外的跟踪调用，用于跟踪不同的屏幕。Google Analytics 的传统是基于跟踪网站活动，这是“面向屏幕”的，但屏幕的概念可以轻松地与应用场景进行比较。这可以使您深入了解用户访问应用中特定场景的频率，例如访问“设置”场景的频率或用户是否甚至查看您的“帮助”场景。

要跟踪屏幕使用情况，请使用 googleAnalytics.logScreenName() 函数

googleAnalytics.logScreenName( screenName )

1	googleAnalytics.logScreenName( screenName )

此调用只需要一个命名您的屏幕/场景的字符串。如果您使用的是 Corona 的 Composer 场景管理库，您只需在 scene:show() 函数的 "did" 阶段添加一行代码，即可使用 Google Analytics 记录屏幕/场景名称

function scene:show( event )
    if ( event.phase == "did" ) then
        -- Log the screen/scene name with Google Analytics
        googleAnalytics.logScreenName( composer.getSceneName( "current" ) )
    end
end

function scene:show( event )

if ( event.phase == "did" ) then

-- 使用 Google Analytics 记录屏幕/场景名称

googleAnalytics.logScreenName( composer.getSceneName( "current" ) )

end

附加说明

与任何分析引擎一样，数据只有在积累到足够进行分析时才有用。您可以看到的大部分报告需要“聚合”数据，尽管某些信息是“实时”可用的。

如果您打算跟踪用户信息，您可能需要在您的应用程序或网站上包含一份隐私政策，以便用户了解正在跟踪的内容。如果您需要隐私政策，请在网上搜索可以根据您的公司/应用程序进行调整的模板。

总结

如您所见，Google Analytics 插件可用于获取关于您的应用程序的几乎任何程度的洞察，从用户人口统计数据到特定的应用内使用模式。

要了解有关 Google Analytics 插件的更多信息，请访问我们的文档，如果您有其他问题，请访问 Corona 论坛。

Rob Miracle

[email protected]

Rob 是 Corona Labs 的开发者关系经理。除了热衷于帮助其他开发者使用 Corona 制作出色的游戏外，他还喜欢在业余时间制作游戏。Rob 自 1979 年起就开始编写游戏代码，从个人电脑到大型机都有涉猎。他在游戏行业拥有超过 16 年的专业经验。

23 条评论

Scott Harrison
发布于 18:07，2 月 15 日

我两周前提交了两个插件，但仍然没有任何进展。
- Rob Miracle
  发布于 18:14，2 月 15 日
  
  这里似乎不是问这个问题的合适地方。请发送电子邮件至 support AT coronalabs DOT com 以了解情况。
Marcus
发布于 19:07，2 月 15 日

很高兴看到插件存储库中又新增了一个插件。做得好，伙计们。
jch_APPLE
发布于 08:42，2 月 16 日

感谢您提供的这款有价值的插件，这是法国客户经常要求的。
Daniel
发布于 14:35，2 月 16 日

这很棒，但是，在您在此页面上的 build.settings 示例中，您建议设置 osx=true，但是当我在模拟器中运行我的应用程序时，我收到以下消息“警告：‘plugin.googleAnalytics’ 库在此平台上不可用。” 版本为 2828？
- Rob Miracle
  发布于 15:59，2 月 16 日
  
  此插件在模拟器中不起作用。您只能在 Android 或 iOS 设备上运行此插件。您将在模拟器中继续收到此警告。
Wilson Wan
发布于 19:27，2 月 18 日

logEvent 函数仅发送类别、操作和标签。
标签值怎么样（https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#ev）？
Gili
发布于 02:01，2 月 19 日

此插件可以在 Kindle 设备上使用吗？
如果可以，为什么不在支持的平台中添加[“android-kindle”]=true？
- George
  发布于 08:50，4 月 15 日
  
  有人可以回复一下吗？
  - Rob Miracle
    发布于 11:13，4 月 15 日
    
    不，这不是 Kindle Fire 设备可用的插件。
    - George
      发布于 11:52，4 月 15 日
      
      感谢 Rob 的快速回复。是否有计划支持 Kindle 设备？我认为支持 Kindle 设备所需要的只是在 AndroidManifest 文件中添加几行代码。
      - Rob Miracle
        发布于 12:14，4 月 15 日
        
        让我试着解释一下。我们需要来自供应商的 SDK，在本例中是 Google Analytics。我们的大多数供应商都没有提供 Amazon Kindle SDK 供我们使用。该插件需要在 Android 上安装 Google Play 插件。任何安装了 Google Play 的 Android 设备都可以使用 GA 插件。由于没有 Kindle Fire SDK，并且 Kindle Fire 设备往往没有安装 Google Play。在 Google 推出 Amazon Kindle Fire SDK 或 Amazon 将 Google Play 添加到他们的 Kindle 设备之前，我们对此无能为力。
      - George
        发布于 12:36，4 月 15 日
        
        嗨，Rob，
        
        据我所知，相同的 SDK 应该适用于 Kindle。唯一的区别是，在没有 Google Play 的设备上，您需要在应用程序的清单中导出/启用一些服务。
        
        https://developers.google.com/analytics/devguides/collection/android/v4/dispatch#background
        
        我可能弄错了，但该指南似乎暗示了这一点。
Renato - Red Beach
发布于 20:54，2 月 20 日

刚刚在这里测试了 Google Analytics，看来“label”不是可选的。（错误：googleAnalytics.logEvent() 期望标签，得到：没有值）。

另外，正如 @WILSON WAN 提到的，为什么我们没有“value”参数？
Marcus
发布于 05:01，4 月 12 日

有人设法让它在 iOS 上工作了吗？
- George
  发布于 13:09，4 月 15 日
  
  我的第一次测试似乎在 iOS 上不起作用。但在 Android 上可以工作。iOS 上是否有已知问题？
- Sam
  发布于 14:50，4 月 24 日
  
  我无法让它在 iOS 或 Android 上工作……我似乎没有收到任何错误，只是我的 GA 中没有任何显示。我按照说明操作，激活了插件，我设置了我的 GA，并且我的跟踪代码和应用程序名称在 init 中正确设置，但没有任何显示……
  
  另外，我认为他们应该添加一些东西，这样它就不会使模拟器崩溃。如果您正在使用模拟器来构建应用程序，那么他们应该在那里添加一个 if 语句，说如果是模拟器，则不要运行……这给我添加了更多我觉得不需要的代码行。
  - Sam
    发布于 15:56，4 月 24 日
    
    在 Android 上成功运行了，由于某种原因，它延迟了很长时间……仍然无法在 iOS 上工作
  - Rob Miracle
    发布于 07:40，4 月 25 日
    
    Sam，听起来你遇到了一些问题。由于我们至少需要查看您的 build.settings，请在论坛中提出这个问题。https://forums.coronalabs.com/forum/631-corona-premium-plugins/
    我们将为您提供一些帮助。对于模拟器，您说得对，它不运行，但它应该下载了我们称之为“存根插件”的东西，该插件使模拟器不会出错，而是在控制台中打印一条消息，告诉您在设备上进行测试。
Daniel
发布于 23:51，5 月 5 日

你们有 Google Tag Manager 的插件吗？
- Rob Miracle
  发布于 13:13，5 月 6 日
  
  不，我们没有。您可以访问 http://feedback.coronalabs.com 并提出此功能请求。
Daniel
发布于 01:24，8 月 3 日

你们最新的插件更新 2016.2906，似乎在 Android 上崩溃了。我没有更改任何代码。在 iOS 上可以正常工作。降级 Corona SDK 没有帮助。删除 Facebook v4 插件没有帮助。
Javier
发布于 16:49，8 月 9 日

有没有人遇到过使用此插件与 apple 上的 IDFA 相关的问题？

发布 Google Analytics 插件