(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目标之前,您必须在Experience Platform中创建一个架构数据集区段

如果您需要受众状态的指导,请参阅受众成员资格详细信息架构字段组的Experience Platform文档。

Oracle Eloqua先决条件 prerequisites-destination

若要将数据从Platform导出到您的Oracle Eloqua帐户,您需要拥有Oracle Eloqua帐户。

此外,您至少需要Oracle Eloqua实例的​ “高级用户 — 营销权限”。 有关指导,请参阅安全用户访问页面上的​ “安全组” ​部分。 目标需要在调用Oracle Eloqua API时以编程方式确定您的基本URL,也需要该访问权限。

收集Oracle Eloqua凭据 gather-credentials

在对Oracle Eloqua目标进行身份验证之前,请记下以下项目:

凭据
描述
Company Name
与您的Oracle Eloqua帐户关联的公司名称。
您稍后将使用Company Name和Oracle Eloqua Username作为连接字符串,在对目标进行身份验证时用作​ 用户名
Username
Oracle Eloqua帐户的用户名。
Password
Oracle Eloqua帐户的密码。
Pod
Oracle Eloqua支持多个数据中心,每个数据中心具有唯一的域名。 Oracle Eloqua将这些称为“pods”,目前共有7个,即p01、p02、p03、p04、p06、p07和p08。 要获取您所在的POD,请登录到Oracle Eloqua,并在成功登录后记下浏览器中的URL。 例如,如果浏览器URL为secure.p01.eloqua.com,则podp01。 有关其他指导,请参阅确定POD页面。

请参阅登录 Oracle Eloqua以获取指导。

护栏 guardrails

NOTE
  • 使用在​ 选择区段 ​步骤期间选择的受众的名称自动创建Oracle Eloqua自定义联系人字段。
  • Oracle Eloqua的最大限制为250个自定义联系人字段。

  • 在导出新受众之前,请确保Oracle Eloqua内的Platform受众数和现有受众数不超过此限制。

  • 如果超过此限制,您将在Experience Platform中遇到错误。 这是因为Oracle Eloqua API无法验证请求,并以 — 400做出响应:存在验证错误 — 描述问题的错误消息。

  • 如果您已达到以上指定的限制,则需要从目标中删除现有映射,并删除Oracle Eloqua帐户中相应的自定义联系人字段,然后才能导出更多区段。

  • 有关其他限制的信息,请参阅Oracle Eloqua 创建联系人字段页面。

支持的身份 supported-identities

Oracle Eloqua支持更新下表中描述的标识。 了解有关标识的更多信息。

目标身份
描述
必需
EloquaId
联系人的唯一标识符。

导出类型和频率 export-type-frequency

有关目标导出类型和频率的信息,请参阅下表。

项目
类型
注释
导出类型
基于配置文件
  • 您正在根据字段映射导出区段的所有成员,以及所需的架构字段​ (例如:电子邮件地址、电话号码、姓氏)
  • 对于Platform中的每个选定受众,相应的Oracle Eloqua区段状态将通过Platform中的受众状态进行更新。
导出频率
正在流式传输
  • 流目标为基于API的“始终运行”连接。 一旦根据受众评估在Experience Platform中更新了用户档案,连接器就会将更新发送到下游目标平台。 阅读有关流式目标的更多信息。

连接到目标 connect

IMPORTANT
若要连接到目标,您需要​ 查看目标 ​和​ 管理目标 访问控制权限。 阅读访问控制概述或联系您的产品管理员以获取所需的权限。

要连接到此目标,请按照目标配置教程中描述的步骤操作。 在配置目标工作流中,填写下面两个部分中列出的字段。

在​ 目标 > 目录 ​中,搜索(API) Oracle Eloqua。 或者,您可以在​ 电子邮件营销 ​类别下找到它。

验证目标 authenticate

填写下面的必填字段。 有关任何指导,请参阅收集 Oracle Eloqua 凭据部分。

  • 密码: Oracle Eloqua帐户的密码。
  • 用户名:由Oracle Eloqua公司名称和Oracle Eloqua用户名组成的连接字符串。
    连接值采用{COMPANY_NAME}\{USERNAME}的形式。
    注意,不要使用任何大括号或空格并保留\
    例如,如果您的Oracle Eloqua公司名称为MyCompany,Oracle Eloqua用户名为Username,则您在​ 用户名 ​字段中使用的串联值为MyCompany\Username

要验证到目标,请选择​ 连接到目标
显示如何进行身份验证的平台UI屏幕截图。

如果提供的详细信息有效,则UI会显示​ 已连接 ​状态,并带有绿色复选标记。 然后,您可以继续执行下一步。

填写目标详细信息 destination-details

要配置目标的详细信息,请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。
显示目标详细信息的平台UI屏幕截图。

  • 名称:将来用于识别此目标的名称。
  • 描述:可帮助您将来识别此目标的描述。
  • Pod:若要获取您所在的pod,请登录到Oracle Eloqua,并在成功登录后记下浏览器中的URL。 例如,如果您的浏览器URL为secure.p01.eloqua.com,则需要选择的pod值为p01。 有关其他指导,请参阅收集 Oracle Eloqua 凭据部分。

启用警报 enable-alerts

您可以启用警报,以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息,请参阅使用UI订阅目标警报的指南

完成提供目标连接的详细信息后,选择​ 下一步

激活此目标的受众 activate

IMPORTANT
  • 若要激活数据,您需要​ 查看目标激活目标查看配置文件 ​和​ 查看区段 访问控制权限。 阅读访问控制概述或联系您的产品管理员以获取所需的权限。
  • 要导出​ 标识,您需要​ 查看标识图形 访问控制权限
    选择工作流中突出显示的身份命名空间以将受众激活到目标。 {width="100" modal="regular"}

有关将受众激活到此目标的说明,请阅读将配置文件和受众激活到流式受众导出目标

映射注意事项和示例 mapping-considerations-example

要将受众数据从Adobe Experience Platform正确发送到Oracle Eloqua目标,您需要完成字段映射步骤。 映射包括在您的Platform帐户中的Experience Data Model (XDM)架构字段与其在目标目标中的相应等效字段之间创建链接。

要将XDM字段映射到Oracle Eloqua目标字段,请执行以下步骤:

  1. 在​ 映射 ​步骤中,选择​ 添加新映射。 您将在屏幕上看到一个新映射行。

  2. 在​ 选择源字段 ​窗口中,选择​ 选择属性 ​类别并选择XDM属性,或选择​ 选择身份命名空间 ​并选择身份。

  3. 在​ 选择目标字段 ​窗口中,选择​ 选择标识命名空间 ​并选择标识,或选择​ 选择自定义属性 ​并在​ 属性名称 ​字段中键入所需的属性名称。 您提供的属性名称应与Oracle Eloqua中的现有联系人属性匹配。 有关您可以在Oracle Eloqua中使用的确切属性名称,请参阅create a contact

    • 重复这些步骤以在XDM配置文件架构和Oracle Eloqua之间添加所需的和任何所需的属性映射:
      | Source字段 | 目标字段 | 必需 |
      |—|—|—|
      |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| |

    • 下面显示了具有上述映射的示例:

      具有属性映射的Platform UI屏幕快照示例。

IMPORTANT
  • 在​ 目标字段 ​中指定的属性的名称应该与Create a contact中指定的名称完全相同,因为这些属性将构成请求正文。
  • 在​ Source字段 ​中指定的属性不遵循任何此类限制。 您可以根据需要进行映射,但是,如果推送到Oracle Eloqua时数据格式不正确,则会导致错误。 例如,您可以映射​ Source字段 ​标识命名空间contact keyABC ID等。 到​ 目标字段 :在确保ID值与Oracle Eloqua接受的格式匹配后,EloquaId
  • EloquaID映射是更新与标识对应的属性的必备项。
  • 需要emailAddress映射。 如果不使用这项调用,API将引发如下所示的错误:
code language-json
{
     "type":"ObjectValidationError",
     "container":{
           "type":"ObjectKey",
           "objectType":"Contact"
     },
     "property":"emailAddress",
     "requirement":{
           "type":"EmailAddressRequirement"
     },
     "value":"<null>"
}

完成提供目标连接的映射后,请选择​ 下一步

NOTE
在向Oracle Eloqua发送联系人字段信息时,目标会在每次执行时自动为所选受众名称添加唯一标识符的后缀。 这可确保与受众名称对应的联系人字段名称不重叠。 请参阅包含使用受众名称创建的自定义联系人字段的Oracle Eloqua联系人详细信息页面的验证数据导出部分屏幕快照示例。

验证数据导出 exported-data

要验证您是否正确设置了目标,请执行以下步骤:

  1. 选择​ 目标 > 浏览 ​并导航到目标列表。

  2. 接下来,选择目标并切换到​ 激活数据 ​选项卡,然后选择受众名称。
    显示目标激活数据的Platform UI屏幕快照示例。

  3. 监控受众摘要,并确保用户档案计数对应于区段中的计数。
    显示区段的Platform UI屏幕快照示例。

  4. 登录到Oracle Eloqua网站,然后导航到​ 联系人概述 ​页面以检查是否已添加受众中的配置文件。 要查看受众状态,请深入到​ 联系人详细信息 ​页面,并检查是否创建了以选定受众名称作为其前缀的联系人字段。

OracleEloqua UI屏幕截图显示“联系人详细信息”页面,该页面具有使用受众名称创建的自定义联系人字段。

数据使用和治理 data-usage-governance

在处理您的数据时,所有Adobe Experience Platform目标都符合数据使用策略。 有关Adobe Experience Platform如何实施数据治理的详细信息,请参阅数据治理概述

错误和故障排除 errors-and-troubleshooting

创建目标时,您可能会收到以下错误消息之一: 400: There was a validation error400 BAD_REQUEST。 当您超过护栏部分中所述的250个自定义联系人字段限制时,会发生这种情况。 要修复此错误,请确保在Oracle Eloqua中未超出自定义联系人字段限制。
平台UI屏幕快照显示错误。

请参阅Oracle Eloqua HTTP状态代码Oracle Eloqua 验证错误页,获取包含说明的状态和错误代码的完整列表。

其他资源 additional-resources

有关其他详细信息,请参阅Oracle Eloqua文档:

Changelog

此部分捕获此目标连接器的功能和重要文档更新。

查看更改日志
table 0-row-3 1-row-3 2-row-3 layout-auto
发行月份 更新类型 描述
2023 年 4 月 文档更新
  • 我们更新了用例部分,更清楚地说明了客户何时将从使用此目标中受益。
  • 我们更新了映射部分,提供了强制映射和可选映射的明确示例。
  • 我们更新了连接到目标部分,并提供有关如何使用Oracle Eloqua公司名称和Oracle Eloqua用户名构造​ 用户名 ​字段的串联值的示例。 (PLATIR-28343)
  • 我们更新了收集 Oracle Eloqua 凭据填写目标详细信息部分,其中包含有关Oracle Eloqua Pod ​选择的指导。 目标使用​ “Pod” ​值来构造API调用的基本URL。 Oracle Eloqua 先决条件部分也已更新,其中包含将​ “高级用户 — 营销权限” ​分配为Oracle Eloqua实例所需的​ “安全组” ​的指南。
2023 年 3 月 初始版本 初始目标版本和文档发布。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6