ドキュメント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 の 連絡先を更新操作を活用し、オーディエンス内の 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

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 として使用される連結文字列として使用します。
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、セグメントの選択 手順で選択したオーディエンスの名前を使用して自動的に作成されます。

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

  • 新しいオーディエンスを書き出す前に、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

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

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

宛先への接続 connect

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

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

宛先／カタログ ​内で (API) Oracle Eloqua を検索します。または、「メールマーケティング」カテゴリの下に配置することもできます。

宛先に対する認証 authenticate

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

  • パスワード:Oracle Eloqua アカウントのパスワード。
  • Username:Oracle Eloqua の会社名と Oracle Eloqua のユーザー名を連結した文字列です。
    連結された値は、{COMPANY_NAME}\{USERNAME} の形式になります。
    注意：中括弧やスペースを使用せず、\ を保持します。
    例えば、Oracle Eloqua の会社名が MyCompany で Oracle Eloqua ユーザー名が Username の場合、「ユーザー名」フィールドで使用する連結された値は MyCompany\Username です。

宛先を認証するには、「 宛先に接続」を選択します。
認証方法を示す Platform UI のスクリーンショット。

指定した詳細が有効な場合、UI で​ 接続済み ​ステータスに緑色のチェックマークが付きます。その後、次の手順に進むことができます。

宛先の詳細を入力 destination-details

宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横にアスタリスクが表示される場合は、そのフィールドが必須であることを示します。
宛先の詳細を示す Platform UI のスクリーンショット。

  • 名前：今後この宛先を認識するための名前。
  • 説明：今後この宛先を識別するのに役立つ説明。
  • ポッド：現在の pod を取得するには、Oracle Eloqua にログインし、正常にログインしたらブラウザーに URL をメモします。 例えば、ブラウザーの URL が secure.p01.eloqua.com の場合、選択する必要がある pod の値は p01 です。 追加のガイダンスについては、Gather Oracle Eloqua credentials の節を参照してください。

アラートの有効化 enable-alerts

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

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

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

IMPORTANT

  • データをアクティブ化するには、宛先の表示、宛先のアクティブ化、プロファイルの表示 および セグメントの表示 ​ アクセス制御権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。

  • ID を書き出すには、ID グラフの表示 ​ アクセス制御権限が必要です。

    宛先に対してオーディエンスをアクティブ化するために、ワークフローでハイライト表示されている ID 名前空間を選択します。 {width="100" modal="regular"}

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

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

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

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

  1. マッピング ​手順で、「新しいマッピングを追加」を選択します。画面に新しいマッピング行が表示されます。

  2. ソースフィールドを選択 ウィンドウで、属性を選択 カテゴリを選択して XDM 属性を選択するか、ID 名前空間を選択 を選択して ID を選択します。

  3. ターゲットフィールドを選択 ウィンドウで、ID 名前空間を選択 を選択して ID を選択するか、カスタム属性を選択 を選択して 属性名 フィールドに目的の属性名を入力します。 指定する属性名は、Oracle Eloqua の既存の連絡先属性と一致する必要があります。 Oracle Eloqua で使用できる正確な属性名については、create a contact を参照してください。

    • これらの手順を繰り返して、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

    • 上記のマッピングの例を以下に示します。

      属性マッピングを含む Platform UI のスクリーンショットの例。

IMPORTANT
  • ターゲットフィールド で指定する属性には、リクエスト本文を形成するので、Create a contact で指定されたとおりに正確に名前を付ける必要があります。
  • Source フィールドで指定された属性は そのような制限には従いません。 必要に応じてマッピングできますが、Oracle Eloqua にプッシュした際にデータ形式が正しくない場合は、エラーが発生します。 例えば、Source フィールド ID 名前空間 contact key な ABC ID をマッピングできます。 ターゲットフィールド へ：ID 値が Oracle Eloqua で受け入れられる形式と一致することを確認した後、EloquaId します。
  • ID に対応する属性を更新するには、EloquaID マッピングが必須です。
  • emailAddress マッピングが必要です。 ない場合、次に示すように、API はエラーをスローします。
code language-json 
{
     "type":"ObjectValidationError",
     "container":{
           "type":"ObjectKey",
           "objectType":"Contact"
     },
     "property":"emailAddress",
     "requirement":{
           "type":"EmailAddressRequirement"
     },
     "value":"<null>"
}

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

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

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

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

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

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

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

  4. Oracle Eloqua Web サイトにログインして、連絡先の概要 ページに移動し、オーディエンスのプロファイルが追加されたかどうかを確認します。 オーディエンスのステータスを表示するには、連絡先の詳細 ページにドリルダウンし、選択したオーディエンス名をプレフィックスとして持つ連絡先フィールドが作成されたかどうかを確認します。

オーディエンス名で作成されたカスタム連絡先フィールドを含む連絡先詳細ページを示す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 のカスタム連絡先フィールド制限を超えていないことを確認してください。
エラーを示す 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月 ドキュメントの更新
  • ユースケースの節を更新し、この宛先を使用することで、お客様にメリットが得られるタイミングをより明確に例を示しました。
  • マッピングの節を更新し、必須マッピングとオプションマッピングの両方の明確な例を追加しました。
  • 「 宛先への接続」の節を更新し、Oracle Eloqua ーザーの会社名と Oracle Eloqua ユーザー名を使用して ユーザー名 フィールドの連結された値を作成する方法の例を追加しました。 （PLATIR-28343）
  • 「ポッド ​ の選択に関するガイダンスを使用して、「 収集 Oracle Eloqua 資格情報と [ 宛先の詳細の入力] の節 Oracle Eloqua 更新しました。 「Pod」 値は、API 呼び出しのベース URL を作成するために宛先で使用されます。 また、Oracle Eloqua 前提条件の節が更新され、Oracle Eloqua インスタンスの必須の 「セキュリティグループ」として 「詳細設定ユーザー – マーケティング権限」 を割り当てる際のガイダンスが追加されました
2023年3月 初回リリース 宛先の初回リリースとドキュメントの公開。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6