Hightouch - 用于事件处理的服务器到服务器集成

关注
Avatar
Jared Ornstead
Updated
文档

Hightouch 是一个数据集成平台，使企业能够在其数据仓库与用于分析、营销和运营的各种其他工具或平台之间同步数据。用户无需复杂的 ETL（提取、转换、加载）流程或自定义编码，即可轻松地将数据仓库连接到 CRM、营销自动化平台、客户支持系统等工具。

Hightouch与 Singular 的集成使用 Singular Server-to-Server(S2S) REST API 从 Hightouch 源（仓库）发送移动（iOS/Android）事件数据。这在 Hightouch 平台中被称为"目的地"。下面的说明介绍了如何在 Hightouch 中配置 Singular Destination。

工程团队需求指南
  1. 在您的移动应用程序中集成 Singular iOS/Android SDK。

    这至少应包括一个应用内事件，以记录用户登录事件。

    有关所有 SDK 集成选项的文档，请参见此处的 Singular 帮助中心 SDK 部分。

  2. 以下数据采集方法之一：
  • 建议使用奇异内部商业智能配置

    在移动应用程序中每次发生用户登录时，向内部 BI 端点配置事件回传，并将此数据保存到用户表中。更多信息请点击此处

  • 或者，使用应用程序内代码片段捕获 Singular 事件 API 所需的数据点

    Singular 数据点必须传回您的仓库，以便与设备/用户关联，并在同步事件时提供给 Hightouch 中的源。Singular在此处记录了关键参数所需的代码片段。

要使用此集成，您必须使用具有所有必要 Singular 数据点的 Hightouch 源，这些数据点必须与 Singular Mobile SDK 的最后已知事件相匹配。

此集成与非移动事件数据不兼容。不支持服务器或网络事件。

支持内容
  1. Hightouch 支持的同步类型：事件

    Hightouch 支持将应用程序内的事件同步到 Singular

    支持的同步模式：仅插入

不支持的功能
  1. 会话事件
  2. 网络事件
  3. 无移动数据点的服务器端事件

Hightouch 集成不能替代 Singular SDK。您必须同时使用 Singular SDK 和 Hightouch。这是一种混合集成，通过 Singular 发布的 SDK 在客户端内收集数据，并通过 REST API 端点收集同一设备/用户的数据。从 Hightouch 发送到 Singular 的任何事件都将与用户最后已知的移动设备相关联，并与该设备最后已知的营销活动数据相关联。

开始使用

首先在 Hightouch 中创建一个 Singular 目的地实例。创建实例后，您必须输入 Singular SDK 密钥进行身份验证。

  1. 在 Hightouch 导航菜单中，点击"设置 > 目的地"。
  2. 点击 "添加目的地 "按钮。
  3. 搜索 "Singular"，然后点击 "继续"。
  4. 在 "API 密钥 "字段中输入 Singular SDK 密钥。然后点击继续。

    获取 Singular 的"SDK 密钥"，可在 Singular 控制面板的"开发工具 > SDK 集成 > SDK 密钥 "下找到。


  5. 为目的地命名，然后点击 "完成"。

重要提示： 如果点击 "测试连接 "按钮，可能会出现以下错误：

这只是因为 API 需要额外的数据点，将在以下步骤中进行配置。

附加设置

配置模型

  1. 从 Hightouch 导航菜单中选择 "模型 "并添加新模型。
  2. 选择数据源，然后点击 "继续"。
  3. 为模型提供名称，并从下拉菜单中选择主键。

    为确保同步发送每个事件，事件模型必须使用真正唯一的主键。有关详细信息，请参阅事件同步文档。

配置同步

  1. 从 Hightouch 导航菜单中选择 "同步 "和 "添加同步"。
  2. 选择 "为单一事件配置的模型"。
  3. 选择单一目的地。
  4. 需要：从下拉菜单中选择事件名称列，作为单事件名称。
  5. 必填：从下拉菜单中选择时间戳列，用作单一事件时间。
  6. 选择要同步到 Singular 的其他列。

    配置如何将查询结果中的列映射到目标中的字段。请注意，Singular 目的地有一些基于 "平台 "字段的条件必填字段。

    所需的附加参数映射：

    有关应为事件映射哪些参数的详细信息，请参阅 Singular S2S ReferenceHERE中的 Required Event Parameters。

    如果不映射IP字段，则默认使用来自 Hightouch 服务器的IP。

    关于设备标识符

    为了将从 Hightouch 发送的事件正确归属到 Singular 中的现有设备，必须使用匹配的设备标识符。如果内部 BI 端点选项被配置为从仓库登录事件中捕获数据，则应在此事件请求中使用相同的标识符。

    对于 iOS，这将是 IDFA 或 IDFV。请勿提供 "NULL "值或归零的标识符。如果在 Singular SDK 初始化时设备上没有 IDFA，那么 Singular 将使用 IDFV 值。

    对于安卓系统，这将是 AIFA（又称 GAID）或 ASID。请勿提供 "NULL "值或归零的标识符。如果在 Singular SDK 初始化时设备上没有 AIFA，那么 Singular 将使用 ASID 值。如果设备上既没有 AIFA 也没有 ASID 值，则只能提供 Android ID (ANDI)。

  7. 参数映射完成后，就可以使用 "Test（测试）"按钮测试事件了。

    从测试中使用的源数据中捕获标识符，并使用 Singular 测试控制台查看实时接收的事件。点击此处了解更多如何测试事件。

    示例：

    映射


    测试


    奇异测试控制台
  8. 测试成功后，单击 "继续 "并设置日程类型，然后单击 "完成"。

支持 SkAdNetwork

要在 Singular 的 SkAdNetwork(SKAN)转换模型中使用 Hightouch 发送的事件，您的 Singular 账户必须启用 "混合 SKAN "功能。请联系您的 CSM 或提交 Singular 支持请求进行激活。

活动

添加到源中的任何记录都会被视为新事件，并在同步运行时发送到 Singular。

您可以使用自定义映射来附加与您的应用程序相关的自定义数据。

自定义映射包含在 API 请求有效载荷的"e " 参数中。

提示和故障排除

差异

如果服务器到服务器事件请求中使用的设备标识符在 Singular 中没有匹配的设备标识符，就会出现差异。请注意以下可能性：

  • 如果事件请求是在Singular SDK 从应用程序会话记录设备标识符之前收到的，那么该事件请求将被视为未知设备的 "第一次会话"，Singular 将把该设备归为有机属性。
  • 如果 Singular SDK 确实记录了设备标识符，但 Singular SDK 标识符与服务器到服务器事件请求中指定的设备标识符不同，那么事件将被错误归属。

常见错误

如果收到错误，请确保包含了 Singular 的所有必填字段："平台"、"软件包名称"、"操作系统版本 "和相关平台的设备标识符。

实时调试器

Hightouch 提供对每次同步运行期间所进行的 API 调用的完全可见性。我们建议您阅读我们关于调试技巧和窍门的文章，了解更多信息。

同步警报

Hightouch 可以通过 Slack、PagerDuty、短信或电子邮件提醒您同步问题。有关详细信息，请访问我们的"警报 "文章。