文件Experience Platform目的地指南

(API) Oracle Eloqua個連線

Last update: Wed Jul 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 管理員
  • 使用者

Oracle Eloqua可讓行銷人員規劃及執行行銷活動，同時為其潛在客戶提供個人化的客戶體驗。 透過整合式銷售機會管理和輕鬆建立行銷活動，可協助行銷人員在買家歷程中的適當時間，與適當的對象互動，並可優雅地擴充，以涵蓋多個管道，包括電子郵件、顯示搜尋、視訊和行動裝置。 銷售團隊能以更快的速度完成更多交易，透過即時見解提高行銷ROI。

此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」，目前總共有七個 — p01、p02、p03、p04、p06、p07和p08。 若要取得您目前所在的POD，請登入Oracle Eloqua，並在您成功登入後記下瀏覽器的URL。 例如，如果瀏覽器URL為secure.p01.eloqua.com，則pod為p01。 如需其他指南，請參閱決定您的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中現有的連絡人屬性。 請參閱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

    • 具有上述對應的範例如下所示：

      具有屬性對應的平台UI熒幕擷圖範例。

IMPORTANT
  • 在​ 目標欄位 ​中指定的屬性應該與Create a contact中指定的屬性完全相同，因為這些屬性會形成要求內文。
  • 在​ Source欄位 ​中指定的屬性未遵循任何此類限制。 您可以視需要加以對應，但如果資料格式在推送至Oracle Eloqua時不正確，則會導致錯誤。 例如，您可以對應​ Source欄位 ​身分名稱空間contact key、ABC ID等 至​ 目標欄位：在確認ID值符合Oracle Eloqua接受的格式之後，EloquaId。
  • EloquaID對應是更新與識別相對應的屬性的必要專案。
  • 需要emailAddress對應。 若未包含API，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 error或400 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