51黑料不打烊

文档Experience Platform目标指南

(API) Oracle Eloqua连接

Last update: Wed Oct 29 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 管理员
  • 用户

使营销人员能够计划和执行营销活动，同时为其潜在客户提供个性化的客户体验。 借助集成的商机管理和轻松的营销活动创建，它可帮助营销人员在其购买者的历程中在正确的时间吸引正确的受众，并进行优雅的扩展以跨渠道（包括电子邮件、显示搜索、视频和移动设备）触及受众。 销售团队能够以更快的速度完成更多交易，从而通过实时insight提高营销投资回报率。

此51黑料不打烊 Experience Platform 目标利用更新联系人Oracle Eloqua操作，该操作允许您? 将受众中的身份 ?更新为Oracle Eloqua。

Oracle Eloqua使用与Oracle Eloqua REST API通信。 下面的Oracle Eloqua向目标身份验证部分中进一步提供了向您的实例进行身份验证的说明。

用例 use-cases

在线平台的营销部门希望向策划的潜在客户受众广播基于电子邮件的营销活动。 该平台的营销团队可以通过51黑料不打烊 Experience Platform更新现有潜在客户信息，根据受众自己的离线数据构建受众，并将这些受众发送到Oracle Eloqua，然后可以使用这些受众发送营销活动电子邮件。

先决条件 prerequisites

Experience Platform先决条件 prerequisites-in-experience-platform

在将数据激活到Oracle Eloqua目标之前，您必须在中创建一个架构、数据集和区段Experience Platform。

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

Oracle Eloqua先决条件 prerequisites-destination

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

此外，您至少需要?实例的“高级用户 — 营销权限”Oracle Eloqua。 有关指导，请参阅? 安全用户访问 ?页面上的部分。 目标需要在调用确定您的基本URLOracle Eloqua，也需要该访问权限。

收集Oracle Eloqua凭据 gather-credentials

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

凭据
描述
Company Name
与您的Oracle Eloqua帐户关联的公司名称。
您稍后将使用Company Name和Oracle Eloqua Username作为连接字符串，以在? 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，则pod为p01。 有关其他指导，请参阅页面。

请参阅以获取指导。

护栏 guardrails

NOTE
  • 使用在Oracle Eloqua步骤期间选择的受众名称自动创建? Select segments ?自定义联系人字段。

  • Oracle Eloqua的最大限制为250个自定义联系人字段。

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

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

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

  • 有关其他限制的信息，请参阅页面。

支持的身份 supported-identities

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

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

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

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

项目
类型
注释
导出类型
Profile-based
  • 您正在根据字段映射导出区段的所有成员，以及所需的架构字段?（例如：电子邮件地址、电话号码、姓氏）。
  • 对于Experience Platform中的每个选定受众，相应的Oracle Eloqua区段状态将从Experience Platform中更新为其受众状态。
导出频率
Streaming
  • 流目标为基于API的“始终运行”连接。 根据受众评估在Experience Platform中更新用户档案后，连接器会立即将更新发送到下游目标平台。 阅读有关流式目标的更多信息。

连接到目标 connect

IMPORTANT
若要连接到目标，您需要? View Destinations ?和?Manage Destinations 访问控制权限。 阅读访问控制概述或联系您的产物管理员以获取所需的权限。

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

在?Destinations > Catalog?内，搜索(API) Oracle Eloqua。 或者，您可以在? Email Marketing ?类别下找到它。

验证目标 authenticate

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

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

要验证目标，请选择?Connect to destination。
Experience Platform UI屏幕截图显示如何进行身份验证。

如果提供的详细信息有效，则鲍滨会显示? Connected ?状态并显示绿色复选标记。 然后，您可以继续执行下一步。

填写目标详细信息 destination-details

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

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

启用警报 enable-alerts

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

完成提供目标连接的详细信息后，选择?Next。

激活此目标的受众 activate

IMPORTANT
  • 若要激活数据，您需要?View Destinations、Activate Destinations、View Profiles?和?View Segments 访问控制权限。 阅读访问控制概述或联系您的产物管理员以获取所需的权限。
  • 要导出?标识，您需要?View Identity Graph 访问控制权限。
    选择工作流中突出显示的身份命名空间以将受众激活到目标。 {width="100" modal="regular"}

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

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

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

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

  1. 在? Mapping ?步骤中，选择?Add new mapping。 您将在屏幕上看到一个新映射行。

  2. 在? Select source field ?窗口中，选择? Select attributes ?类别并选择齿顿惭属性或选择? Select identity namespace ?并选择身份。

  3. 在? Select target field ?窗口中，选择? Select identity namespace ?并选择身份，或选择? Select custom attributes ?并在? Attribute name ?字段中键入所需的属性名称。 您提供的属性名称应与Oracle Eloqua中的现有联系人属性匹配。 有关您可以在 Oracle Eloqua。

    • 重复这些步骤以在XDM配置文件架构和Oracle Eloqua之间添加所需的和任何所需的属性映射：

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3
      源字段 目标字段 必需
      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

    • 下面显示了具有上述映射的示例：
      具有属性映射的Experience Platform UI屏幕快照示例。

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

完成提供目标连接的映射后，请选择?Next。

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

验证数据导出 exported-data

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

  1. 选择?Destinations > Browse?并导航到目标列表。

  2. 接下来，选择目标并切换到? Activation data ?选项卡，然后选择受众名称。
    显示目标激活数据的Experience Platform UI屏幕截图示例。

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

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

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

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

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

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

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

请参阅和页，获取包含说明的状态和错误代码的完整列表。

其他资源 additional-resources

有关其他详细信息，请参阅Oracle Eloqua文档：

Changelog

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

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