ドキュメントExperience Platform宛先ガイド

(API) Oracle Eloqua 接続

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

作成対象：

  • 管理者
  • ユーザー

マーケター Oracle Eloqua キャンペーンを計画および実行しながら、パーソナライズされたカスタマーエクスペリエンスを見込み客に提供できます。 統合されたリード管理と簡単なキャンペーン作成により、マーケターがバイヤージャーニーで適切なオーディエンスを適切なタイミングで惹きつけ、メール、ディスプレイ検索、ビデオ、モバイルなどのあらゆるチャネルでオーディエンスにリーチするようにエレガントに拡張できます。 セールスチームは、より迅速により多くの取引を成立させ、リアルタイムinsightを通じてマーケティングの ROI を向上させることができます。

この Adobe Experience Platform​ 宛先 ​ は、​ REST API の ​ 連絡先を更新 Oracle Eloqua 操作を活用し、オーディエンス内の ID を更新 して 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 を呼び出す際に宛先がプログラムで ​ ベース URL を決定 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 の合計 7 つがあります。 使用しているポッドを取得するには、Oracle Eloqua にログインし、正常にログインしたらブラウザーに URL をメモします。 例えば、ブラウザーの URL が secure.p01.eloqua.com の場合、pod は p01 です。 詳しくは、POD の決定 ​ ページを参照してください。

詳しくは、​ へのログイン Oracle Eloqua を参照してください。

ガードレール guardrails

NOTE
  • カスタム連絡先フィールド Oracle Eloqua、Select segments の手順で選択したオーディエンスの名前を使用して自動的に作成されます。

  • Oracle Eloqua には、最大 250 個のカスタム連絡先フィールドという制限があります。

  • 新しいオーディエンスを書き出す前に、Experience Platform オーディエンスの数と Oracle Eloqua 内の既存のオーディエンスの数がこの制限を超えないようにしてください。

  • この制限を超えると、Experience Platformでエラーが発生します。 これは、Oracle Eloqua API がリクエストを検証できず、- 400：検証エラーが発生しました – 問題を説明するエラーメッセージと応答するからです。

  • 上記の上限に達した場合、さらにセグメントを書き出す前に、既存のマッピングを宛先から削除し、Oracle Eloqua アカウントの対応するカスタム連絡先フィールドを削除する必要があります。

  • 追加の制限について詳しくは、Oracle Eloqua 連絡先フィールドの作成 ​ ページを参照してください。

サポートされる ID supported-identities

Oracle Eloqua では、以下の表で説明する ID の更新をサポートしています。ID についての詳細情報。

ターゲット ID
説明
必須
EloquaId
連絡先の一意の ID。
○

書き出しのタイプと頻度 export-type-frequency

宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。

項目
タイプ
メモ
書き出しタイプ
Profile-based
  • セグメントのすべてのメンバーを、フィールドマッピングに従って、必要なスキーマフィールドと共に書き出します​（例：メールアドレス、電話番号、姓）。
  • Experience Platformで選択した各オーディエンスについて、対応する Oracle Eloqua セグメントのステータスが、Experience Platformのオーディエンスステータスで更新されます。
書き出し頻度
Streaming
  • ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。詳しくは、ストリーミングの宛先を参照してください。

宛先への接続 connect

IMPORTANT
宛先に接続するには、View Destinations および Manage Destinations​​ アクセス制御権限 ​ が必要です。 詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。

Destinations > Catalog 内で (API) Oracle Eloqua を検索します。 または、Email Marketing カテゴリの下に配置することもできます。

宛先に対する認証 authenticate

以下の必須のフィールドに入力します。詳しくは、Gather Oracle Eloqua credentials の節を参照してください。

  • 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 です。 追加のガイダンスについては、Gather Oracle Eloqua credentials の節を参照してください。

アラートの有効化 enable-alerts

アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。

宛先接続への詳細の入力を終えたら「Next」を選択します。

この宛先に対してオーディエンスをアクティブ化 activate

IMPORTANT

この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。

マッピングの考慮事項と例 mapping-considerations-example

Adobe Experience Platform から Oracle Eloqua 宛先にオーディエンスデータを正しく送信するには、フィールドマッピングの手順を実行する必要があります。マッピングは、Experience Platform アカウント内の Experience Data Model （XDM）スキーマフィールドと、ターゲット宛先から対応する同等のスキーマフィールドとの間にリンクを作成して構成されます。

XDM フィールドを Oracle Eloqua の宛先フィールドにマッピングするには、次の手順に従います。

  1. Mapping の手順で、「Add new mapping」を選択します。 画面に新しいマッピング行が表示されます。

  2. Select source field ウィンドウで、Select attributes カテゴリを選択して XDM 属性を選択するか、Select identity namespace を選択して ID を選択します。

  3. Select target field ウィンドウで、「Select identity namespace」を選択して ID を選択するか、「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 の ID 名前空間 contact key などをマッピング ABC ID きます。 Target field :ID 値が EloquaId で受け入れられる形式と一致することを確認した後、Oracle Eloqua します。
  • ID に対応する属性を更新するには、EloquaID マッピングが必須です。
  • emailAddress マッピングが必要です。 ない場合、次に示すように、API はエラーをスローします。
code language-json 
{
     "type":"ObjectValidationError",
     "container":{
           "type":"ObjectKey",
           "objectType":"Contact"
     },
     "property":"emailAddress",
     "requirement":{
           "type":"EmailAddressRequirement"
     },
     "value":"<null>"
}

宛先接続のマッピングの指定を終えたら「Next」を選択します。

NOTE
宛先は、連絡先フィールド情報を Oracle Eloqua に送信する際に、各実行で選択されたオーディエンス名に自動的に一意の ID を付加します。 これにより、オーディエンス名に対応する連絡先フィールド名が重複するのを防ぐことができます。 オーディエンス名を使用して作成されたカスタム連絡先フィールドを含む ​ スタム連絡先詳細ページのスクリーンショットの例については、 データ書き出しの検証 Oracle Eloqua の節を参照してください。

データの書き出しを検証する exported-data

宛先が正しく設定されていることを検証するには、次の手順に従います。

  1. Destinations/Browse を選択し、宛先のリストに移動します。

  2. 次に、宛先を選択し、「オーディ Activation data ンス」タブに切り替えて、オーディエンス名を選択します。
    宛先のアクティベーションデータを示したExperience Platform UI のスクリーンショットの例。

  3. オーディエンスの概要を監視し、プロファイルの数がセグメント内の数と一致していることを確認します。
    セグメントを示すExperience Platform UI のスクリーンショットの例。

  4. Oracle Eloqua web サイトにログインし、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