文件Experience Platform目的地指南

(API) Oracle Eloqua 連線

Last update: Thu Nov 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 管理員
  • 使用者

Oracle Eloqua 它讓行銷人員能夠規劃並執行活動，同時為潛在客戶提供個人化的顧客體驗。 透過整合的潛在客戶管理與簡易的活動創建，它幫助行銷人員在買家旅程中於正確時間吸引正確的受眾，並優雅地擴展至電子郵件、展示搜尋、影片及行動裝置等管道中觸及受眾。 銷售團隊能以更快速度完成更多交易，透過即時洞察提升行銷投資報酬率。

此Adobe Experience Platform 目的地利用​ REST API中的更新連絡人Oracle Eloqua作業，可讓您​ 將對象內的身分識別 ​更新為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

若要將資料從Experience Platform匯出至您的Oracle Eloqua帳戶，您需要有Oracle Eloqua帳戶。

此外，你至少需要為你的​實例取得「進階使用者 - 行銷權限」。Oracle Eloqua請參閱​ 安全使用者存取 ​頁面的「安全群組」區塊以獲得指引。存取權限是目的地在呼叫 ​ API 時，程式化決定你的基礎網址Oracle 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 這些稱為「艙」，目前共有七個——P01、P02、P03、P04、P06、P07和P08。 要知道你使用的 POD，請 Oracle Eloqua 在成功登入後，在瀏覽器中記錄網址。 例如，如果瀏覽器URL為secure.p01.eloqua.com，則pod為p01。 如需其他指南，請參閱決定您的POD頁面。

如需指引，請參閱登入 Oracle Eloqua。

護欄 guardrails

NOTE
  • Oracle Eloqua自訂連絡人欄位是使用在​ Select segments ​步驟期間選取的對象名稱自動建立。

  • Oracle Eloqua的最大限製為250個自訂連絡人欄位。

  • 在匯出新對象之前，請確保Oracle Eloqua內的Experience Platform對象數量和現有對象數量不超過此限制。

  • 若超過此限制，體驗平台會出現錯誤。 這是因為 Oracle Eloqua API 未能驗證請求，並回應 - 400：有驗證錯誤 - 錯誤訊息描述問題。

  • 如果你已經達到上述限制，你需要先從目的地移除現有的映射，並刪除帳戶中相應的自訂聯絡欄位 Oracle Eloqua ，才能匯出更多分段。

  • 請參閱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熒幕擷圖顯示如何驗證。

如果提供的詳細資料有效，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

你可以啟用警示，接收資料流狀態通知到目的地。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊，請參閱使用UI訂閱目的地警示的指南。

當您完成提供目的地連線的詳細資訊時，請選取​Next。

啟動此目標的對象 activate

IMPORTANT
  • 若要啟用資料，您需要​View Destinations、Activate Destinations、View Profiles​和​View Segments 存取控制許可權。 閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。
  • 若要匯出​身分，您需要​View Identity Graph 存取控制許可權。
    選取工作流程中反白的身分名稱空間，以啟用目的地的對象。 {width="100" modal="regular"}

閱讀將設定檔和對象啟用至串流對象匯出目的地，以瞭解啟用此目的地對象的指示。

對應考量事項和範例 mapping-considerations-example

若要將對象資料從Adobe Experience Platform正確傳送至Oracle Eloqua目的地，您必須完成欄位對應步驟。 映射是指在你的體驗平台帳號中，建立經驗資料模型（XDM）架構欄位與其對應的目標目的地對應欄位之間的連結。

要將 XDM 欄位對應到 Oracle Eloqua 目的地欄位，請依照以下步驟操作：

  1. 在​ Mapping ​步驟中，選取​Add new mapping。 您會在畫面上看到新的對應列。

  2. 在​ Select source field ​視窗中，選擇​ Select attributes ​類別並選取XDM屬性，或選擇​ Select identity namespace ​並選取身分。

  3. 在​ Select target field ​視窗中，選擇​ Select identity namespace ​並選取身分，或選擇​ Select custom attributes ​並在​ Attribute name ​欄位中輸入所需的屬性名稱。 您提供的屬性名稱應符合Oracle Eloqua中現有的連絡人屬性。 請參考 create a contact 你可以在 中使用的 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 ​中指定的屬性應該與Create a contact中指定的屬性完全相同，因為這些屬性會形成要求內文。
  • Source field​中指定的屬性未遵循任何此類限制。 您可以視需要加以對應，但如果資料格式在推送至Oracle Eloqua時不正確，則會導致錯誤。 例如，您可以對應​ Source field ​身分名稱空間contact key、ABC ID等。 至​Target field ：在確認ID值符合EloquaId接受的格式之後Oracle Eloqua。
  • EloquaID對應是更新與識別相對應的屬性的必要專案。
  • 需要emailAddress對應。 若未包含API，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

處理您的資料時，所有Adobe Experience Platform目的地都符合資料使用原則。 如需Adobe Experience Platform如何強制資料控管的詳細資訊，請參閱資料控管概觀。

錯誤與疑難排解 errors-and-troubleshooting

建立目的地時，您可能會收到下列其中一個錯誤訊息： 400: There was a validation error或400 BAD_REQUEST。 如護欄區段所述，當您超過250個自訂連絡人欄位限制時，就會發生這種情況。 若要修正此錯誤，請確定您在Oracle Eloqua中未超過自訂連絡人欄位限制。
Experience Platform UI熒幕擷圖顯示錯誤。

請參閱Oracle Eloqua HTTP狀態碼和Oracle Eloqua 驗證錯誤頁面，以取得包含說明的狀態和錯誤碼的完整清單。

其他資源 additional-resources

更多細節請參閱文件：Oracle Eloqua

更新日誌

本節擷取此目的地聯結器的功能和重要檔案更新。

檢視變更記錄檔
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​選擇的指引。 目的地使用​ "Pod" ​值來建構API呼叫的基本URL。 Oracle Eloqua 必要條件區段也已更新，其中包含指派​ 「進階使用者 — 行銷許可權」 ​為您​執行個體的必要「安全性群組」Oracle Eloqua的指引。
2023 年 3 月 首次發行 初始目的地版本和檔案發佈。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6