(API) Oracle Eloqua 接続

マーケター 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 の宛先に対して認証を行う前に、以下の項目をメモしておきます。

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

ガードレール guardrails

サポートされる ID supported-identities

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

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

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

宛先への接続 connect

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

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

宛先に対する認証 authenticate

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

宛先を認証するには、「 宛先に接続」を選択します。

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

宛先の詳細を入力 destination-details

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

アラートの有効化 enable-alerts

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

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

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

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

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

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

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

{
     "type":"ObjectValidationError",
     "container":{
           "type":"ObjectKey",
           "objectType":"Contact"
     },
     "property":"emailAddress",
     "requirement":{
           "type":"EmailAddressRequirement"
     },
     "value":"<null>"
}

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

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

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

データの使用とガバナンス data-usage-governance

Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。Adobe Experience Platform がどのようにデータガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。

エラーとトラブルシューティング errors-and-troubleshooting

宛先を作成すると、次のいずれかのエラーメッセージが表示される場合があります：400: There was a validation error または 400 BAD_REQUEST。 これは、 ガードレールの節で説明しているように、カスタムの連絡先フィールドの上限である 250 を超えた場合に発生します。 このエラーを修正するには、Oracle Eloqua のカスタム連絡先フィールド制限を超えていないことを確認してください。

ステータスコードとエラーコードの包括的なリストと説明については、Oracle Eloqua HTTP ステータスコードページおよび Oracle Eloqua 検証エラーページを参照してください。

その他のリソース additional-resources

詳しくは、Oracle Eloqua のドキュメントを参照してください。

変更ログ

この節では、この宛先コネクタに対する機能の概要と重要なドキュメントの更新について説明します。