英文原文：Google Apps Script: Tracking add-on usage with Google Analytics
发布人：Romain Vialard，Google 开发技术专家，Google Sheets 扩展 Yet Another Mail Merge 开发者。
Google Apps Script 可以简化 Google Sheets、Docs 和 Forms 扩展(add-on)的开发和发布工作。目前已有数以百计的扩展，其中许多扩展已有数十万用户。要想使扩展取得更大的成功，需要了解扩展在哪些方面受用户青睐以及在哪些方面做出改进，这方面 Google Analytics 是最出色的工具之一。
Cookie 和用户识别
扩展在 Google Sheets、Docs 和 Forms 内运行，它们可以在这些应用中显示对话框或侧边栏中的内容。这些自定义界面由 Apps Script HTML 服务提供服务，后者提供客户端 HTML、CSS 和 JS，但存在若干局限性。
其局限性之一便是 cookie 无法保留。每次用户重新打开对话框或侧边栏时，系统都会使用新的客户 ID 重新创建 Google Analytics cookie。因此，Analytics 会将每个新会话都当成由新用户发起，也就是说，会话数和用户数应该非常相近。
幸运的是，可以利用 localStorage 来存储客户 ID—这是一种比 cookie 更好的用户信息保留方法。完成这一更改后，用户指标的准确性应能得到显著提升。
扩展还可能通过触发事件运行、通过按循环间隔执行代码运行，或者在用户执行打开文档或响应 Google Form 之类的操作时运行。在上述情况下，没有对话框或侧边栏，因此您应该使用 Google Analytics Measurement Protocol（见有关该服务用法的政策），通过 Google Apps Script 中的UrlFetch 服务直接向 Google Analytics 服务器发送用户互动数据。
在这种情况下同样需要客户 ID，因此我建议使用 Apps Script User properties 服务。Web 上的大多数示例都展示了如何为每一次 Analytics 调用生成唯一的客户 ID，但这并不能让您获得准确的用户计数。
您还可以将客户端生成的客户 ID 发送至服务器，以便在客户端和服务器调用 Analytics 时都使用相同的客户 ID，但在这一阶段，最好依靠 Google Analytics 中的可选用户 ID。客户 ID 表示客户/设备，而用户 ID 为每一位用户所独有，可以在用户接受身份验证时方便地在扩展中使用。您可以在服务器端生成用户 ID，将其存储在用户属性中，然后在每一次调用 Analytics（在客户端和服务器端）时重复使用。
自定义维度和指标
在扩展中，我们通常依赖事件追踪而不是页面浏览量。得益于类别、操作、标签和值，可以在每个事件上添加不同的参数，但同样可以利用自定义维度和指标来添加更多信息。
例如，Yet Another Mail Merge 扩展大多用于发送电子邮件，我们添加了许多自定义维度以便深入了解其使用方法。我们会为每一个新活动（批量发送电子邮件）记录链接到用户的数据（例如，免费或付费客户、gmail.com 或 Google for Work/EDU 用户）和链接到活动的数据（例如，电子邮件大小、是否激活了电子邮件追踪）。您随后可以在自定义报告和仪表板内重复使用这些自定义维度。
一旦您开始充分利用所有维度，就可以获得极具深度的数据。到 2015 年 10 月为止，Yet Another Mail Merge 已允许您每天免费发送多达 100 封电子邮件。但我们通过 Analytics 发现，大多数在一次活动中发送超过 50 封电子邮件的人实际发送了 100 封电子邮件—他们能获得的免费配额上限—但我们未能调动起他们转向付费计划的积极性。
根据这一发现，我们将这项免费计划的配额降至每天 50 封邮件，同时推出了一项推荐计划，让用户能免费获得更多配额（他们仍然不付费，但可以邀请到更多用户，因此能引起我们的兴趣）。我们通过这一变化大幅度提高了营收并促进了用户增长。
当然，我们还利用 Google Analytics 来追踪推荐计划的效率。
为帮助您开始更深入地了解扩展，请通过下面这些相关文档页面了解本博客文章中介绍的工具。我们希望这些信息能够帮助您的应用取得更大成功！
Google Analytics：利用 localStorage 存储客户 ID
Google Analytics：Measurement Protocol
Apps Script：UrlFetch 服务
Apps Script：Properties 服务
Google Analytics：用户 ID
Google Analytics：关于事件追踪
Google Analytics：自定义维度和指标
Romain Vialard 个人资料 | 网站
Romain Vialard 是一位 Google 开发技术专家。他曾多年担任 Google 应用顾问，现在专注于面向 Google 应用用户的产品，包括 Yet Another Mail Merge 和Form Publisher 等扩展。