(API) Oracle Eloqua 连接
Oracle Eloqua 使营销人员能够规划和执行营销活动,同时为其潜在客户提供个性化的客户体验。 借助集成的商机管理和轻松的营销活动创建,它可帮助营销人员在其购买者的历程中在正确的时间吸引正确的受众,并进行优雅的扩展以跨渠道(包括电子邮件、显示搜索、视频和移动设备)触及受众。 销售团队能够以更快的速度完成更多交易,从而通过实时洞察提高营销投资回报率。
此 Adobe Experience Platform 目标 利用 更新联系人 来自的操作 Oracle Eloqua REST API,允许您 更新身份 在受众中进入 Oracle Eloqua.
Oracle Eloqua 用途 基本身份验证 以与 Oracle Eloqua REST API。 向您的验证的说明 Oracle Eloqua 实例位于 向目标进行身份验证 部分。
用例 use-cases
在线平台的营销部门希望向策划的潜在客户受众广播基于电子邮件的营销活动。 该平台的营销团队可以通过Adobe Experience Platform更新现有的潜在客户信息,从受众自己的离线数据构建受众,并将这些受众发送至 Oracle Eloqua,然后将其用于发送营销活动电子邮件。
先决条件 prerequisites
Experience Platform先决条件 prerequisites-in-experience-platform
将数据激活到之前 Oracle Eloqua 目标,您必须拥有 架构, a 数据集、和 区段 创建于 Experience Platform.
请参阅Experience Platform文档,了解 受众成员资格详细信息架构字段组 如果您需要有关受众状态的指南。
Oracle Eloqua 先决条件 prerequisites-destination
为了将数据从Platform导出到 Oracle Eloqua 您需要拥有 Oracle Eloqua 帐户。
此外,您至少需要 “高级用户 — 营销权限” 您的 Oracle Eloqua 实例。 请参阅 “安全组” 部分,位于 安全的用户访问 页面获取指导。 目标需要访问才能以编程方式访问 确定基本URL 调用时 Oracle Eloqua API。
收集 Oracle Eloqua 凭据 gather-credentials
在对进行身份验证之前,请记下以下各项 Oracle Eloqua 目标:
Company Name
Username
Password
Pod
secure.p01.eloqua.com
您的 pod
是 p01
. 请参阅 确定POD 页面以获取其他指导。请参阅 登录 Oracle Eloqua 作为指导。
护栏 guardrails
- Oracle Eloqua 自定义联系人字段是使用以下期间选择的受众的名称自动创建的 选择区段 步骤。
-
Oracle Eloqua 具有250个自定义联系人字段的最大限制。
-
在导出新受众之前,请确保包含的平台受众数量和现有受众数量 Oracle Eloqua 不要超过此限制。
-
如果超过此限制,您将在Experience Platform中遇到错误。 这是因为 Oracle Eloqua API无法验证请求,响应为 — 400:存在验证错误 — 描述问题的错误消息。
-
如果您已达到以上指定的限制,则需要从目标中删除现有映射,并删除中相应的自定义联系人字段。 Oracle Eloqua 帐户,然后才能导出更多区段。
-
请参阅 Oracle Eloqua 创建联系人字段 页面以了解有关其他限制的信息。
支持的身份 supported-identities
Oracle Eloqua 支持更新下表中描述的标识。 了解有关 身份.
EloquaId
导出类型和频率 export-type-frequency
有关目标导出类型和频率的信息,请参阅下表。
- 您正在导出区段的所有成员以及所需的架构字段 (例如:电子邮件地址、电话号码、姓氏),根据您的字段映射。
- 对于Platform中的每个选定受众,将 Oracle Eloqua 区段状态将从Platform更新为受众状态。
连接到目标 connect
要连接到此目标,请按照 目标配置教程. 在配置目标工作流中,填写下面两个部分中列出的字段。
范围 目标 > 目录 搜索 (API) Oracle Eloqua. 或者,您可以将其定位到 电子邮件营销 类别。
验证目标 authenticate
填写下面的必填字段。 请参阅 收集 Oracle Eloqua 凭据 部分获取任何指导。
- 密码:您的密码 Oracle Eloqua 帐户。
- 用户名:由以下各项组成的连接字符串: Oracle Eloqua 公司名称和 Oracle Eloqua 用户名。
连接的值采用以下形式{COMPANY_NAME}\{USERNAME}
.
注意,请勿使用任何大括号或空格,并保留\
.
例如,如果您的 Oracle Eloqua 公司名称为MyCompany
和 Oracle Eloqua 用户名是Username
,则您将在 用户名 字段为MyCompany\Username
.
要验证目标,请选择 连接到目标.
如果提供的详细信息有效,UI将显示 已连接 带有绿色复选标记的状态。 然后,您可以继续执行下一步。
填写目标详细信息 destination-details
要配置目标的详细信息,请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。
- 名称:将来用于识别此目标的名称。
- 描述:可帮助您将来识别此目标的描述。
- Pod:要获取哪个
pod
您已登录,请登录 Oracle Eloqua 并记下成功登录后浏览器中的URL。 例如,如果您的浏览器URL为secure.p01.eloqua.com
该pod
您需要选择的值为p01
. 请参阅 收集 Oracle Eloqua 凭据 部分以获取其他指导。
启用警报 enable-alerts
您可以启用警报,以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息,请参阅以下内容中的指南: 使用UI订阅目标警报.
完成提供目标连接的详细信息后,选择 下一个.
激活此目标的受众 activate
读取 将用户档案和受众激活到流式受众导出目标 有关将受众激活到此目标的说明。
映射注意事项和示例 mapping-considerations-example
要正确地将受众数据从Adobe Experience Platform发送到 Oracle Eloqua 目标,您需要执行字段映射步骤。 映射包括在您的Platform帐户中的Experience Data Model (XDM)架构字段与其在目标目标中的相应等效字段之间创建链接。
要将XDM字段映射到 Oracle Eloqua 目标字段,请执行以下步骤:
-
在 映射 步骤,选择 添加新映射. 您将在屏幕上看到一个新映射行。
-
在 选择源字段 窗口中,选择 选择属性 类别并选择XDM属性或选择 选择身份命名空间 并选择身份。
-
在 选择目标字段 窗口,选择 选择身份命名空间 并选择一个身份,或选择 选择自定义属性 并在中键入所需的属性名称 属性名称 字段。 您提供的属性名称应与中的现有联系人属性匹配 Oracle Eloqua. 请参阅 create a contact 中可以使用的确切属性名称 Oracle Eloqua.
-
重复这些步骤以在XDM配置文件架构和之间添加所需的和任何所需的属性映射。 Oracle Eloqua: | 源字段 | 目标字段 | 必需 | |—|—|—| |
IdentityMap: Eid
|Identity: EloquaId
| 是 | |xdm: personalEmail.address
|Attribute: emailAddress
| 是 | |xdm: personName.firstName
|Attribute: firstName
| | |xdm: personName.lastName
|Attribute: lastName
| | |xdm: workAddress.street1
|Attribute: address1
| | |xdm: workAddress.street2
|Attribute: address2
| | |xdm: workAddress.street3
|Attribute: address3
| | |xdm: workAddress.postalCode
|Attribute: postalCode
| | |xdm: workAddress.country
|Attribute: country
| | |xdm: workAddress.city
|Attribute: city
| | -
下面显示了具有上述映射的示例:
-
- 中指定的属性 目标字段 应完全按照 Create a contact 因为这些属性将构成请求正文。
- 中指定的属性 源字段 请勿遵循任何此类限制。 您可以根据需要进行映射,但是,如果数据格式在推送到时不正确 Oracle Eloqua 这将导致出现错误。 例如,您可以映射 源字段 身份命名空间
contact key
,ABC ID
等等。 到 目标字段 :EloquaId
在确保ID值与接受的格式匹配之后 Oracle Eloqua. - 此
EloquaID
必须执行映射才能更新与标识对应的属性。 - 此
emailAddress
需要映射。 如果不使用这项调用,API将引发如下所示的错误:
code language-json |
---|
|
完成提供目标连接的映射后,选择 下一个.
验证数据导出 exported-data
要验证您是否正确设置了目标,请执行以下步骤:
-
选择 目标 > 浏览 并导航到目标列表。
-
接下来,选择目标并切换到 激活数据 选项卡,然后选择受众名称。
-
监控受众摘要,并确保用户档案计数对应于区段中的计数。
-
登录到 Oracle Eloqua 网站,然后导航到 联系人概述 页面检查是否已添加受众的用户档案。 要查看受众状态,请深入了解 联系人详细信息 页面,并检查是否已创建具有选定受众名称作为其前缀的联系人字段。
数据使用和治理 data-usage-governance
全部 Adobe Experience Platform 目标在处理您的数据时符合数据使用策略。 有关如何执行操作的详细信息 Adobe Experience Platform 强制执行数据管理,请参见 数据管理概述.
错误和故障排除 errors-and-troubleshooting
在创建目标时,您可能会收到以下错误消息之一: 400: There was a validation error
或 400 BAD_REQUEST
. 当超过250个自定义联系人字段限制时,会发生这种情况,如 护栏 部分。 要修复此错误,请确保不超过 Oracle Eloqua.
请参阅 Oracle Eloqua HTTP状态代码 和 Oracle Eloqua 验证错误 页面以获取状态和错误代码的完整列表及其说明。
其他资源 additional-resources
欲知更多详情,请参见 Oracle Eloqua 文档:
Changelog
此部分捕获此目标连接器的功能和重要文档更新。
table 0-row-3 1-row-3 2-row-3 layout-auto | ||
---|---|---|
发行月份 | 更新类型 | 描述 |
2023 年 4 月 | 文档更新 |
|
2023 年 3 月 | 初始版本 | 初始目标版本和文档发布。 |