通过 Bloomreach 集成,每位注册用户都会在你的 Bloomreach Engagement 项目中被创建或更新为客户,并通过电子邮件地址进行识别。你还可以为他们添加 Bloomreach 同意,以便向其发送营销信息。
准备工作
- 一个 Bloomreach Engagement 项目,以及一位可以在项目设置中管理 API 访问权限的用户(通常是项目管理员)。
第 1 步:在 Bloomreach 中创建 API 密钥
- 在 Bloomreach Engagement 中打开项目,前往 Project settings > Access management > API。
- 复制页面上显示的 Project token 和 API base URL。
- 在 API 组下,创建一个具有 Private access 的新组,并为其命名,例如“Scratcher”。
- 在该组中创建新的 API 密钥。复制 API key ID 和 API secret。Secret 只会显示一次。
- 为该组授予下列权限并保存。
密钥所需的权限
在该组的权限中,允许:
- Customer properties:get 和 set,用于查找客户、创建或更新客户,并在字段映射中显示你的客户属性。
- Events:set,用于
consent事件,以便 Scratcher 记录同意信息。
除此之外无需其他权限。如果没有 set 权限,发送会失败,并显示 Bloomreach 自身的访问错误。
第 2 步:将 Bloomreach 连接到 Scratcher
- 在 Scratcher 中,前往设置 > 集成,然后点击 Bloomreach。
- 将 API base URL、Project token、API key ID 和 API secret 粘贴到对应字段中。
- 点击安装集成。Scratcher 会向 Bloomreach 验证这些信息。
第 3 步:在活动中启用
- 在编辑器中,前往连接 > 集成 > Bloomreach,然后点击激活。
- 如果你连接了多个项目,请在选择账户下选择要使用的项目。
- 在字段映射下,点击添加字段映射,将每个 Scratcher 字段与一个 Bloomreach 客户属性对应起来,例如将“潜在客户 - 名字”对应到 first_name。
- 选择用户应获得的同意类别,例如“newsletter”,或不选择。
- 在**按许可筛选(可选)**下,选择你的营销同意复选框,这样只会发送勾选了该复选框的用户。
- 点击保存,然后点击测试。
须知:Bloomreach 没有列表。所有人都会进入项目,你可以在 Bloomreach 中使用细分对他们进行分组。因此,你一点击激活,Scratcher 就会开始发送。请在活动上线之前激活集成,或者立即完成设置。
字段映射
- 电子邮件地址始终会被发送,并用于查找客户。你无需映射它。
- 目标字段列表显示项目中的客户属性。如果缺少某个属性,请先在 Bloomreach 中创建。
- 要标记客户的来源,请将使用自定义值(例如“Scratcher 夏季游戏”)映射到你用于记录来源的属性。
同意
如果你选择了同意类别,Scratcher 会记录一个 consent 事件,其操作为 accept,来源为活动名称。该类别必须已存在于 Bloomreach 中(位于 Project settings 的同意设置下)。使用按许可筛选,确保只有勾选了营销复选框的用户才会获得该同意。
发送内容和时间
新注册用户会在一两分钟内发送。激活集成时,活动的现有潜在客户也会被发送。当有人再次参与时,该客户的信息会被更新。在设置 > 集成 > 发送状态下查看每次发送。请参阅查看发送状态并重新发送潜在客户。
故障排除
- 安装时出现“All or some of the fields are invalid...”:请检查 API base URL 和 Project token,并重新复制 API key ID 和 Secret。
- 发送失败并显示访问错误:该 API 组缺少上述某项权限。请在 Bloomreach 中进行编辑。
- 客户信息中没有显示同意:该同意类别在 Bloomreach 中不存在,或拼写不同。
- Bloomreach 提供了关于 API 密钥的指南。如果菜单看起来有所不同,请在 Bloomreach 文档中搜索“API access management”。