文档Experience Platform源连接器指南

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

RainFocus

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 开发人员
NOTE
RainFocus源为测试版。 有关使用测试版标记源的更多信息，请阅读源概述。

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

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

IMPORTANT
此源连接器和文档页面由RainFocus团队创建和维护。 如有任何查询或更新请求，请直接通过clientcare@rainfocus.com联系他们，或访问RainFocus 帮助中心

先决条件

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

在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

为了在Experience Platform中存储来自RainFocus的体验事件，您必须创建体验数据模型(XDM)架构以描述可以存储可能从RainFocus发送的字段和数据类型的数据集。

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

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

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

架构应包含以下字段：

字段
类型
示例
描述
attendee.registered
字符串
是
确定与会者是否被视为已注册的标志。
attendee.attendeeId
字符串
1619119968857001fvLB
RainFocus中的与会者ID。
attendee.externalId
字符串
1666809456617001wyPj
组织指定的外部ID。
attendee.clientId
字符串
8EFC1F57631CAFE70A495ECB@8f3f1f5c631caf3e495fd8.e
与会者SSO客户端ID。
attendee.email
字符串
user@company.com
与会者的电子邮件地址。
transmissionId
字符串
1680309557133001YHhz
用于数据推送的唯一标识符。
eventType
字符串
已计划会话
与会者体验活动的名称。
timestamp
日期时间
2023-04-01T00:41:57.000Z
数据推送的时间戳。
event.name
字符串
Adobe Summit2023
发生传输的事件的名称。
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架构准备就绪后，您现在可以通过RainFocus平台激活Integration Profile。 Integration Profile负责将数据流式传输到Experience Platform。

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

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

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

RainFocus UI中的创建集成配置文件窗口。

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

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

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

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

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

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

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

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

后续步骤

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

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