文档Experience Platform源连接器指南

[Beta 版]{class="badge informative"}

RainFocus

Last update: Tue Oct 31 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • Developer
NOTE
此 RainFocus 源为测试版。 请阅读 源概述 有关使用测试版标记源代码的更多信息。

RainFocus 是一个可用于推广活动和构建受众的平台。 您可以使用 RainFocus 创建精美的促销页面、跟踪促销活动效果并优化注册转化。

使用 RainFocus Adobe Experience Platform和Real-time Customer Data Platform中的源代码，以便通过实时的与会者体验活动自动丰富您的客户数据配置文件。 在启用后，体验事件会自动流式传输到Real-Time CDP中，以便利用下游目标和应用程序(如Customer Journey Analytics和Adobe Journey Optimizer)进行强大的受众分段、数据分析和激活与会者历程。

IMPORTANT
此源连接器和文档页面由 RainFocus 团队。 如有任何查询或更新请求，请直接通过客户关怀部门联系@rainfocus.com或访问 RainFocus 帮助中心

先决条件

您必须先完成以下先决条件，然后才能激活 RainFocus Experience Platform集成：

在Adobe Developer门户中创建Adobe服务帐户(JWT)

IMPORTANT
Adobe最近宣布弃用JWT令牌以支持OAuth。 为了适应此更改， RainFocus 源将在不久的将来迁移到OAuth。

收集所需的凭据

为了连接 RainFocus 要Experience Platform，必须在以下位置提供以下连接属性的值： RainFocus：

凭据
描述
示例
客户端ID
可从Adobe Developer门户的Adobe服务帐户中获取客户端ID。
b9c32a63e7d41a0f87d3e8b52a16e7a2
客户端密码
客户端密钥可以从Adobe Developer门户中的Adobe服务帐户获取。
k1b-p-umplcjtg_arnw-R-Bx44bybu
技术帐户ID
技术帐户ID可以从Adobe Developer门户的Adobe服务帐户中获取。
B3F9D2E8A64C573D21ABFE97@techacct.adobe.com
组织 ID
组织ID可以从Adobe Developer门户的Adobe服务帐户中获取
D9A6F3BCE82FD147C50E3A19@techacct.adobe.com

创建XDM架构并定义标识字段 create-an-xdm-schema-and-define-the-identity-field

要从中存储体验事件，请执行以下操作 RainFocus 在Experience Platform中，必须创建一个Experience Data Model (XDM)架构来描述一个数据集，该数据集可以存储可能发送的字段和数据类型 RainFocus.

RainFocus 建议使用以下字段，其中包含默认发送的所有可能数据。

还建议使用以下字段组（用前缀表示）：

  • 与会者
  • 参展商
  • 潜在客户
  • 会话
  • 会话时间

架构应包含以下字段：

字段
类型
示例
描述
attendee.registered
字符串
是
确定与会者是否被视为已注册的标志。
attendee.attendeeId
字符串
1619119968857001fvLB
中的与会者ID RainFocus.
attendee.externalId
字符串
1666809456617001wyPj
组织指定的外部ID。
attendee.clientId
字符串
8EFC1F57631CAFE70A495ECB@8f3f1f5c631caf3e495fd8.e
与会者SSO客户端ID。
attendee.email
字符串
用户@company.com
与会者的电子邮件地址。
transmissionId
字符串
1680309557133001YHhz
用于数据推送的唯一标识符。
eventType
字符串
已计划会话
与会者体验活动的名称。
timestamp
日期时间
2023-04-01T00:41:57.000赫
数据推送的时间戳。
event.name
字符串
Adobe Summit 2023
发生传输的事件的名称。
exhibitor.exhibitorId
字符串
1680309557133001YHhz
此 RainFocus 参展商的标识符。
exhibitor.externalId
字符串
1666809514105001lSJN
客户端系统中参展商的标识符。
exhibitor.name
字符串
IBM
参展商的名称。
lead.leadId
字符串
1666809456617001wyPj
此 RainFocus 商机的标识符。
lead.note
字符串
session.sessionId
字符串
1666809373585001t4aV
此 RainFocus 会话的标识符。
session.externalId
字符串
1666809456617001wyPj
客户端系统中会话的标识符。
session.code
字符串
GS3
会话的代码。
session.title
字符串
Inspiration主题演讲
会话的标题。
session.length
整数
90
会话的长度。
sessiontime.sessiontimeId
字符串
1673033149739001OJLZ
此 RainFocus 会话时间的标识符。
sessiontime.startTime
字符串
2023-03-22 10:00:00
会话的开始时间。
sessiontime.endTime
字符串
2023-03-22 10:00:00
会话的结束时间。
sessiontime.room
字符串
B32
用于会话的房间。

要为创建架构，请执行以下操作 RainFocus 数据，请阅读以下文档以了解有关如何使用API或UI创建架构的步骤。

IMPORTANT
  • 架构必须扩展 XDM ExperienceEvent类。
  • 您必须确保架构包含 主要身份、和 已为配置文件启用. 有关详细信息，请阅读上的指南 在UI中定义身份字段
  • 您可以将示例身份(Email)替换为另一个合适的标识符，例如sha256电子邮件或ECID。

在RainFocus中创建集成配置文件 create-an-integration-profile-in-rainfocus

服务帐户和XDM架构准备就绪后，您现在可以激活 Integration Profile 通过 RainFocus 平台。 此 Integration Profile 负责将数据流式传输到Experience Platform。

登录 RainFocus 平台. 在主导航中，选择 Libraries 然后选择 Integration Profiles

选择了库和集成配置文件的RainFocus UI。

要创建新配置文件，请选择 (+) 图标。 接下来，选择 Adobe Real-time Customer Data Platform 然后选择 确定.

RainFocus UI中的创建集成用户档案窗口。

接下来，提供您在Adobe Developer门户项目中检索到的凭据：

  • 客户端ID
  • 客户端密码
  • 技术帐户ID
  • 组织 ID

提供凭据后，选择 Save。您现在应会看到新的 Integration Profile 列于 RainFocus 仪表板。

选择 Integration Profile 您刚刚创建的，以查看预定义的列表 推送类型 已配置。 这些是 体验事件 将在发生时发送到Experience Platform的内容。

RainFocus仪表板中预定义的推送类型列表。

要检索示例JSON有效负载的副本，请选择 Sample JSON Payload. 接下来，突出显示并复制示例JSON有效负载和 将其保存在扩展名为.json的新文件中. 这稍后将在Experience Platform中使用 映射配置.

RainFocus仪表板中的JSON有效负载示例。

TIP
设置尚未完成：创建数据流后，您需要返回到 RainFocus 仪表板以完成您的 Integration Profile 通过提供 流端点URL 和 数据流ID.

后续步骤

通过阅读本文档，您已完成流传输数据所需的先决条件设置 RainFocus 帐户到Experience Platform。 您现在可以继续阅读以下指南： 连接 RainFocus 使用用户界面Experience Platform.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089