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

(API) Oracle Eloqua 接続

Last update: Mon Apr 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 管理者
  • ユーザー

Oracle Eloquaを使用すると、マーケターはキャンペーンを計画および実行しながら、見込客にパーソナライズされた顧客体験を提供できます。 統合されたリード管理と簡単なキャンペーン作成により、マーケターはバイヤーズジャーニーにおいて適切なオーディエンスをタイミングよく惹きつけ、メール、ディスプレイ検索、動画、モバイルなどのチャネルをまたいでオーディエンスにリーチできるようにエレガントに拡張できます。 Adobe Real-Time insightを利用すれば、営業部門はより多くの商談をより迅速に成立させ、マーケティング ROIを向上できます。

このAdobe Experience Platform 宛先は、​ REST APIからIDの更新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を呼び出す際に、プログラムで ベース 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はこれらを「ポッド」と呼びます。現在、合計7つのポッドがあります（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個のカスタム連絡先フィールドは、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。
○

サポートされるオーディエンス supported-audiences

この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。

オーディエンスの由来
サポートあり
説明
Segmentation Service
○
Experience Platform ​ セグメント化サービス ​を通じて生成されたオーディエンス。
その他すべてのオーディエンスの生成元
×

このカテゴリには、Segmentation Serviceを通じて生成されたオーディエンス以外のすべてのオーディエンスのオリジンが含まれます。 様々なオーディエンスの起源について読みます。 次に例を示します。

  • カスタムアップロードオーディエンス がCSV ファイルからExperience Platformにをインポートしました。
  • 類似オーディエンス，
  • 連合オーディエンス，
  • Adobe Journey Optimizerなどの他のExperience Platform アプリで生成されたオーディエンス
  • その他。

オーディエンスのデータタイプ別にサポートされるオーディエンス：

オーディエンスのデータタイプ
サポートあり
説明
ユースケース
人物オーディエンス ​
○
顧客プロファイルにもとづいて、マーケティング施策の特定のグループをターゲットにすることができます。
買い物客やカートの放棄が多い
​ アカウントオーディエンス ​
×
アカウントベースドマーケティング戦略のために、特定の組織内の個人をターゲットにします。
B2B マーケティング
見込みオーディエンス ​
×
まだ顧客ではないが、ターゲットオーディエンスと特徴を共有する個人をターゲットにします。
サードパーティデータによる見込み顧客の開拓
​ データセットの書き出し
×
Adobe Experience Platform データ レイクに保存されている構造化データのコレクション。
レポート，データサイエンスワークフロー

書き出しのタイプと頻度 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

以下の必須のフィールドに入力します。ガイダンスについては、収集 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 ​ アクセス制御権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
  • ID​をエクスポートするには、View Identity Graph ​ アクセス制御権限が必要です。
    ​ ワークフローで強調表示されているID名前空間を選択して、オーディエンスを宛先にアクティブ化します。 {width="100" modal="regular"}

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

マッピングの考慮事項と例 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 ドキュメントを参照してください。

変更ログ 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 セクションを更新しました。 "Pod"​値は、宛先がAPI呼び出しのベース URLを構築するために使用します。 Oracle Eloqua 前提条件 セクションも更新され、インスタンスに必要な 「セキュリティグループ」 として 「高度なユーザー – マーケティング権限」 Oracle Eloquaを割り当てる方法が示されました。
2023年3月 初回リリース 最初の宛先リリースとドキュメントの公開。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6