通过 Apsis One 集成,每位注册用户都会在你选择的分区中被创建或更新为 Apsis One 资料,并可以选择加入你的某个 Apsis One 订阅。
准备工作
- 一个 Apsis One 账户,以及一位可以管理 API 密钥的用户(通常是管理员)。
- 了解你的 Apsis One 账户位于欧洲还是亚洲区域。大多数账户位于欧洲。
第 1 步:在 Apsis One 中创建 API 密钥
- 在 Apsis One 中打开 Account settings,前往 API keys(位于集成下)。
- 点击创建新的 API 密钥。为其起一个易于识别的名称,例如“Scratcher”。
- 授予该密钥访问你希望 Scratcher 发送资料的一个或多个分区的权限,并设置下列权限。
- 保存,然后复制 Client ID 和 Client secret。Secret 只会显示一次。
Apsis 为此提供了自己的分步指南。在 Scratcher 的安装对话框中,可以通过设置指南找到它(“要安装此集成,请按照此处的指南操作”)。
密钥所需的权限
Scratcher 使用该密钥来:
- 读取你的分区及其中的属性、订阅(同意主题)和事件,以便你在活动中进行选择;
- 创建资料并更新其属性;
- 为资料添加同意(选择加入);
- 为资料添加事件。
因此,该密钥需要分区的读取权限,以及你所用分区中资料、同意和事件的写入权限。如果没有写入权限,发送会失败,并显示 Apsis One 自身的错误信息。
第 2 步:将 Apsis One 连接到 Scratcher
- 在 Scratcher 中,前往设置 > 集成,然后点击 Apsis One。
- 选择 API 区域:欧洲或亚洲。
- 粘贴 Client ID 和 Client secret。
- 点击安装集成。Scratcher 会登录 Apsis One 以验证信息。
第 3 步:在活动中启用
- 在编辑器中,前往连接 > 集成 > Apsis One,然后点击激活。
- 如果你连接了多个 Apsis One 账户,请在选择账户下选择要使用的账户。
- 在 Apsis 分区下选择分区(选择分区)。
- 在字段映射下,为每个字段点击添加字段映射,并将 Scratcher 字段与目标字段中的 Apsis One 属性对应起来。列表会显示所选分区的属性,包括你自己创建的属性。
- 在订阅(同意)下,选择用户应加入的订阅,或选择无。“选择参与者应选择加入的订阅。”
- 在**按许可筛选(可选)**下,选择你的营销同意复选框,这样只会发送勾选了该复选框的用户。
- 点击保存,然后点击测试发送一份测试资料。
字段映射
- 电子邮件地址始终会被发送,并用于识别资料。你无需映射它。
- 对于电话号码,请使用格式设置,按照属性要求的格式发送号码。
- 是/否属性接收 true 或 false,因此请将同意的已接受字段映射到是/否属性。
同意
如果你选择了订阅,每个人都会以“Subscribed via”加活动名称作为原因、以“Scratcher”作为来源加入该订阅。如果该用户已经加入,则不会有任何变化。使用按许可筛选,确保只有勾选了营销复选框的用户才会加入。
如果你的分区包含 Apsis One 的同意表单事件,Scratcher 还会将这次注册作为事件记录到资料中,并附上活动地址。
发送内容和时间
新注册用户会在一两分钟内发送。激活集成时,活动的现有潜在客户也会被发送。当有人再次参与时,其资料会被更新。在设置 > 集成 > 发送状态下查看每次发送;其中还会显示该资料是新建的还是已存在的。请参阅查看发送状态并重新发送潜在客户。
故障排除
- 安装时出现“All or some of the fields are invalid...”:请检查区域,并重新复制 Client ID 和 Secret。
- 发送失败并显示 Apsis One 的访问错误:该密钥无权访问该分区,或缺少写入权限。请在 Apsis One 中编辑该密钥。
- **订阅(同意)**为空:该分区尚无订阅。请在 Apsis One 中创建一个订阅,然后重新打开集成。