Google Analytics 集成

需要开发者协助

您需要开发团队的帮助来设置此集成。请与他们分享本指南。

通过共享的用户 ID 连接 Google Analytics 4 和 Pushwoosh，使访问您网站或应用的同一个人在两个工具中都是同一个用户。ID 一致后，您在 Google Analytics 中分析的用户就是您在 Pushwoosh 中发送消息的用户，您还可以将 Google Analytics 数据引入 Pushwoosh 细分。

选择用户 ID

使用您自己的系统中已为每个用户分配的标识符，例如数据库中的账户 ID。同一个值既作为用户 ID 发送到 Google Analytics，也作为 User ID 发送到 Pushwoosh。

请勿使用电子邮件地址、电话号码或其他个人信息，因为 Google Analytics 政策不允许在用户 ID 中包含个人信息。请在用户登录或以其他方式被识别时设置该 ID。

从网站发送用户 ID

在 Google 代码的 user_id 参数中将 ID 传递给 Google Analytics。如果您使用 Google Tag Manager，请改为在 Google 代码配置中设置 user_id 字段。请参阅 Google 文档中的 Send user IDs。

JavaScript

gtag('config', 'G-XXXXXXXXXX', {
  'user_id': 'USER_ID'
});

使用 Web Push SDK 将同一个 ID 传递给 Pushwoosh：

JavaScript

Pushwoosh.push((api) => {
  api.registerUser('USER_ID');
});

从移动应用发送用户 ID

移动应用通过 Firebase 向 Google Analytics 4 发送数据。使用 Firebase Analytics 的 setUserId 设置 ID（请参阅 Firebase 文档中的 Set a user ID），并使用 Pushwoosh SDK 设置相同的值。

Android

Java

FirebaseAnalytics.getInstance(context).setUserId("USER_ID");
Pushwoosh.getInstance().setUserId("USER_ID");

iOS

Swift

Analytics.setUserID("USER_ID")
Pushwoosh.sharedInstance().setUserId("USER_ID")

基于 Google Analytics 数据构建细分

Pushwoosh 可以通过两种方式将 Google Analytics 数据转换为细分，两种方式都通过外部细分实现：

• 导入 Google Analytics 受众：选择您已在 Google Analytics 中构建的受众。无需 SQL，也无需 BigQuery。
• 查询 BigQuery 导出数据：针对 Google Analytics 导出到 BigQuery 的原始事件编写您自己的 SQL，用于受众无法表达的条件。

在这两种情况下，只有当用户的 Google Analytics 用户 ID 与您应用中的 Pushwoosh User ID 匹配时，该用户才会进入细分。Google Analytics 仅通过匿名客户端 ID 识别的用户不会进入细分。

导入 Google Analytics 受众

开始之前，请准备一个 Google Cloud 服务帐户及其 JSON 密钥。请参阅 Google Cloud 文档中的 Create and delete service account keys。然后：

1. 在该服务帐户所属的 Google Cloud 项目中，启用 Google Analytics Data API 和 Google Analytics Admin API。
2. 在 Google Analytics 中，前往 Admin → Property access management，以 Viewer 角色添加该服务帐户的电子邮件地址。在 Google Cloud IAM 中授予的角色不会提供对 Google Analytics 的访问权限。
3. 在 Pushwoosh 中，创建一个外部细分，并将数据库类型设置为 Google Analytics 4 audience。
4. 输入 GA4 property ID。您可以在 Google Analytics 的 Admin → Property details 中找到它。
5. 将密钥粘贴到 Service account JSON 中。
6. 点击 Load audiences 并选择 Audience。
7. 点击 Check connection，然后点击 Create。

Google Analytics 大约每天更新一次受众成员，因此 Pushwoosh 也会在细分被使用时每天刷新一次该细分。

查询 BigQuery 导出数据

如果您将 Google Analytics 4 数据导出到 BigQuery，就可以使用针对用户事件的任意 SQL 条件来选择用户，例如过去 30 天内进行过购买的所有用户。

1. 将您的 Google Analytics 4 媒体资源关联到 BigQuery 项目，并开启每日导出。请按照 Google 文档中的 Set up BigQuery Export 操作。之后，Google Analytics 会将每天的事件写入名为 analytics_<property ID> 的数据集中名为 events_YYYYMMDD 的表，前面几节中的 ID 位于 user_id 列。
2. 在 Pushwoosh 中，创建一个外部细分，将数据库类型设置为 Google BigQuery，并编写返回这些用户 ID 的查询。连接时，请使用具有 BigQuery Data Viewer 和 BigQuery Job User 角色的服务帐户密钥。如果没有 BigQuery Job User 角色，Check connection 和 Check query 都会失败，因为两者都会在您的项目中运行测试查询作业。

例如，以下查询返回过去 30 天内进行过购买的用户。请将 my-project 替换为您的 Google Cloud 项目 ID，将 analytics_123456789 替换为您的数据集名称：

SQL

SELECT DISTINCT user_id
FROM `my-project.analytics_123456789.events_*`
WHERE event_name = 'purchase'
  AND user_id IS NOT NULL
  AND _TABLE_SUFFIX >= FORMAT_DATE('%Y%m%d', DATE_SUB(CURRENT_DATE(), INTERVAL 30 DAY))

Google Analytics 每天导出一次数据，因此细分反映的是截至前一天的活动。