外部细分

外部细分可让您定位已存储在您自己数据库（如 CRM 或数据仓库）中的用户，而无需在列表每次更改时都将其导出为 CSV 并重新上传。您向 Pushwoosh 提供一个返回正确用户 ID 的 SQL 查询，Pushwoosh 会持续重新运行该查询以保持细分最新。设置完成后，您可以像使用任何其他细分一样使用这些用户。

需要开发者协助

您需要开发者或数据库管理员的帮助来设置连接。请与他们分享本指南以开始使用。

设置连接会涉及您的生产数据库。在开始之前，请让您的开发者或数据库管理员：

• 准备一个只读用户（对于 BigQuery，则为只读服务帐户）
• 确认您计划使用的查询
• 如果数据库位于防火墙后面，请询问 Pushwoosh 支持团队允许哪些 IP 地址

创建外部细分

命名细分并选择数据库

1. 前往 Audience → External Segments。
2. 点击 Create external segment。

3. 为细分输入一个名称（最多 100 个字符）。
4. 选择数据库类型：PostgreSQL、MySQL、Google BigQuery 或 Microsoft SQL Server / Fabric。

填写连接字段

PostgreSQL 和 MySQL

对于 PostgreSQL 和 MySQL，请填写：

• Host 和 Port： 您的数据库服务器地址。Pushwoosh 要求主机可公开访问，并在您检查连接或保存细分时拒绝私有、内部或环回地址。
• Database： 数据库名称。
• User 和 Password： 只读帐户的凭据。
• SSL 模式（仅限 PostgreSQL，因为 MySQL 连接不使用 TLS）设置了 SSL/TLS（加密连接的协议）如何应用于您的数据库连接。请询问您的数据库管理员使用哪种模式：
  • Disable： 不加密。
  • Require： 加密连接，但不检查数据库服务器的身份。
  • Verify CA： 加密连接并检查服务器的证书是否由受信任的证书颁发机构 (CA) 颁发。
  • Verify full： 与 Verify CA 相同，并且还会检查证书是否与您的数据库主机名匹配。这是最强的选项。
• 对于 Disable 以外的任何模式，请在 Certificate source（Upload files 或 Paste PEM）下提供 CA certificate，如果您的数据库需要，还需提供 Client certificate 和 Client key。

BigQuery

对于 Google BigQuery，请填写：

• Project ID： 包含您的数据集的 GCP 项目。
• Service account JSON： 具有 BigQuery 读取权限的服务帐户的密钥。
• Location： 数据集的区域（例如，EU、US 或 europe-west3）。留空可从数据集中自动解析位置。

SQL Server / Fabric

对于 Microsoft SQL Server / Fabric，请填写：

• Host 和 Port： 您的数据库服务器地址，或您的 Fabric SQL 分析端点。Pushwoosh 要求主机可公开访问，并在您检查连接或保存细分时拒绝私有、内部或环回地址。
• Database： 数据库名称。
• User 和 Password： 只读帐户的凭据。
• Microsoft Entra tenant ID： 可选。对于 SQL Server 登录，请留空。对于 Microsoft Fabric（其 SQL 分析端点没有 SQL 登录），请将其设置为以服务主体的身份登录。将其应用程序（客户端）ID 输入为 User，将其客户端密钥输入为 Password。

输入查询

1. 输入查询。它必须返回一个名为 user_id 的单列，每行代表您希望加入细分的一个用户。例如：

SELECT user_id FROM loyalty_members WHERE tier = 'gold'

注意

user_id 值必须与您为用户设置的 Pushwoosh User ID 相匹配（与通过 User ID 构建细分使用的标识符相同）。如果查询返回 Pushwoosh 无法识别的 ID，则不会匹配任何设备。

2. 点击 Check connection 以确认 Pushwoosh 可以访问数据库（30 秒后超时）。
3. 点击 Check query 以确认查询可以运行并返回正确的列（同样在 30 秒后超时）。

验证并创建

当两项检查都成功后，点击 Create。Pushwoosh 会立即保存该细分并将其添加到 External Segments 列表中。

细分如何保持最新

Pushwoosh 不会按固定计划运行您的查询。相反，它会根据细分最近一次的使用情况来刷新：

• 如果细分的数据不到一小时，Pushwoosh 会直接使用当前数据。
• 如果数据超过一小时，Pushwoosh 会在后台刷新的同时继续使用当前数据。
• 如果数据超过三小时，Pushwoosh 会等待一次新的刷新完成后再使用该细分。

在实践中，这意味着您经常使用的细分（例如，在重复的 Journey 中）会保持最新，而您很少接触的细分在再次使用时可能需要一些时间来刷新。

如果刷新失败（例如，数据库无法访问或查询开始出错），Pushwoosh 会记录错误，但 External Segments 列表中的细分状态不会自行改变。在您修复问题后，打开该细分并点击 Check connection 以确认修复。下次细分数据成功刷新时，错误将自动清除。

使用外部细分

创建后，外部细分会自动出现在 Audience → Segments 下，名称相同，可以像任何其他细分一样使用，例如作为营销活动或 Journey 的受众。

要将其与其他条件结合，请将其添加为筛选器：

1. 前往 Audience → Segments → Create Segment。
2. 点击 Add filter by → Segment。
3. 按名称选择您的外部细分。

在复合筛选器中以及在基于受众的入口中选择受众时，也可以使用相同的 Segment 筛选器。有关组合细分的更多信息，请参阅通过现有细分构建细分。

检查细分中有多少人

External Segments 列表不显示成员数量。请在 Audience → Segments 中打开该细分的包装器（请参阅使用外部细分）并在那里计算其规模。

管理外部细分

在 External Segments 列表中，每一行都显示细分的名称、代码（在 API 调用中引用该细分时使用的标识符）、数据库类型、主机和状态（valid 或 invalid）。

• 点击 Edit 更改连接或查询。数据库类型在创建后无法更改。请改为创建一个新的细分。
• 点击 Delete 删除细分。当细分被营销活动、Journey、筛选器或弹出表单使用时，Pushwoosh 会阻止删除。请先移除这些引用，然后再删除细分。此操作无法撤销。