通过 Agillic 集成,每位注册用户都会在 Agillic 中被创建或更新为收件人。此处 Agillic 不使用列表:收件人会添加到你的 Agillic 数据中,你可以在 Agillic 中构建目标群组。
准备工作
- 一个位于 Agillic 欧洲平台上的 Agillic 账户,以及一位可以创建 API 密钥的用户(通常是管理员)。
第 1 步:在 Agillic 中创建 API 密钥
- 在 Agillic 中打开 Settings,找到 API 密钥(API credentials)。
- 创建一个新密钥,并为其起一个易于识别的名称,例如“Scratcher”。
- 复制 Developer key(也称为 API key)和 Secret。Secret 只会显示一次。
密钥所需的权限
Scratcher 使用该密钥读取你的个人数据字段、按电子邮件查找收件人,以及创建和更新收件人。如果 Agillic 允许限制密钥权限,则该密钥需要收件人的读写权限以及个人数据的读取权限。无需其他权限。
第 2 步:将 Agillic 连接到 Scratcher
- 在 Scratcher 中,前往设置 > 集成,然后点击 Agillic。
- 粘贴开发者密钥和 Secret。
- 点击安装集成。Scratcher 会登录 Agillic 以验证它们。
第 3 步:在活动中启用
- 在编辑器中,前往连接 > 集成 > Agillic,然后点击激活。
- 如果你连接了多个账户,请在选择账户下选择要使用的账户。
- 在字段映射下,将每个 Scratcher 字段与一个 Agillic 个人数据字段对应起来。
- 在唯一电子邮件字段下,选择你在 Agillic 中用于电子邮件的字段:“选择你在 Agillic 中用于电子邮件的字段(请确保该字段在 Agillic 中也是唯一的)”。列表中只显示唯一的文本字段。如果留空,Scratcher 将使用 EMAIL 字段。
- 在**按许可筛选(可选)**下,选择你的营销同意复选框,这样只会发送表示同意的用户。
- 点击保存,然后点击测试。
须知:Agillic 没有可供选择的列表,因此你一点击激活,Scratcher 就会开始发送。请在活动上线之前激活集成,或者立即完成设置。
字段映射
- 电子邮件地址始终会发送到唯一电子邮件字段。你无需映射它。
- 字段列表会显示你的 Agillic 个人数据及其类型。日期以 Agillic 的格式发送,例如 31.12.2025。
- 如果你有用于选择加入的个人数据字段,请将同意的已接受字段映射到该字段。
发送内容和时间
Scratcher 会按电子邮件查找收件人。如果收件人不存在,则会创建;否则会更新。新注册用户会在一两分钟内发送,现有潜在客户会在你激活集成时发送。在设置 > 集成 > 发送状态下,你可以看到每条潜在客户在 Agillic 中是新建的还是已存在的。
故障排除
- “Agillic API request failed with status code ...”:Agillic 未接受该请求。401 或 403 表示密钥已被删除或缺少访问权限;请连接新密钥。
- Agillic 关于某个字段的信息:某个值与字段类型不符,或缺少必填字段。请检查映射。