Oracle Eloquaコネクタ構成ガイド

要件

Oracle Eloquaアカウント
Oracle Eloquaアカウントの会社名
Oracle Eloquaアカウントのユーザー名
Oracle Eloquaアカウントのパスワード
Oracle Eloquaで許可リストが有効になっている場合は、Customer Data Platform（CDP）サーバーのIPアドレスをOracle Eloquaの許可リストに追加します。

Oracle Eloquaの許可リストにIPアドレスが追加されておらず、かつOracle Eloquaの許可リストが無効になっていない場合、Import DefinitionアクションはDD: ELOQUA UNABLE TO RETRIEVE VENDOR ENDPOINTエラーで失敗します。

サポートされているアクション

アクション名	訪問プロファイル	イベントデータ
Bulk APIによる連絡先の更新	✓	✗
共有リストへの連絡先の追加	✓	✗
共有リストからの連絡先の削除	✓	✗
連絡先の挿入または更新	✓	✗
連絡先の挿入	✓	✗
連絡先の更新	✓	✗
連絡先のメールグループへの登録	✓	✗
連絡先のメールグループからの登録解除	✓	✗
連絡先のカスタムオブジェクトデータの挿入	✓	✗
連絡先のカスタムオブジェクトデータの挿入または更新	✓	✗

バッチ制限

このコネクタは、ベンダーへの大量データ転送に対応するため、バッチリクエストを使用します。詳細については、バッチアクションを参照してください。次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに保持されます。

リクエストの最大数：100,000
最も古いリクエストからの最大経過時間：60分
リクエストの最大サイズ：32 MB

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

コネクタを追加した後、次の必須構成を構成します。

会社
ユーザー名
パスワード

新しいインポート定義の構成

インポート定義は、アップロードするデータの構造を作成します。この定義では、Tealiumにアップロードするフィールドを構成します。連絡先リストまたはメールリストへのデータ同期も構成できます。

インポート定義を作成すると、データのインポート時にTealiumが自動的にデータを同期します。

パラメータ	説明
インポート定義名	（必須）連絡先インポート定義の名前。
連絡先フィールド	（必須）アップロード時に使用する連絡先フィールドを選択します。
識別子フィールド名	（必須）インポートしたデータをOracle Eloqua内の既存レコードと照合するためのフィールドを選択します。このフィールドは、いずれかの連絡先フィールドと一致し、各レコードに固有のデータを含んでいる必要があります。
オプション - 更新ルール	このインポート定義でインポートした値を使用して、Oracle Eloquaデータベース内の値を更新するアクションを選択します。 `always`：常に値を更新します。 `ifNewIsNotNull`：新しい値が空白でない場合に値を更新します。 `ifExistingIsNull`：既存の値が空白の場合に値を更新します。 `useFieldRule`：フィールドレベルで定義されたルールを使用します。
オプション - 連絡先リストに同期	この連絡先の同期先となる連絡先リストを選択します。
オプション - 連絡先リストへの同期アクション	このインポート定義に対する連絡先リストの同期アクション（`add`または`remove`）を選択します。
オプション - メールグループに同期	この連絡先の同期先となるメールグループを選択します。
オプション - メールグループへの同期アクション	このインポート定義に対するメールグループの同期アクション（`subscribed`または`unsubscribed`）を選択します。

アクション構成 - パラメータとオプション

続行をクリックして、コネクタアクションを構成します。アクションの名前を入力し、リストからアクションタイプを選択します。

アクション - Bulk APIによる連絡先の更新

Bulk APIでは、次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストがキューに保持されます。

リクエストの最大数：100,000
最も古いリクエストからの最大経過時間：60分
リクエストの最大サイズ：32 MB

詳細については、Oracle Eloqua Bulk APIを参照してください。

パラメータ

パラメータ	説明
連絡先インポート定義	（必須）このバッチアップロードに使用するインポート定義を選択します。
連絡先データ	属性をインポート定義のフィールドにマッピングします。

アクション - 共有リストへの連絡先の追加

アカウントから取得される共有リストは、最初の1,000件のみです。特定の共有リストが見つからない場合は、「カスタムテキスト」オプションを使用し、共有リストの数値IDのみを指定してください。テキスト名を入力すると、エラーが発生する可能性があります。

「API連絡先ID」が指定されていない場合、連絡先検索パラメータで指定した連絡先フィールドに基づいて対象の連絡先を検索するため、追加のAPI呼び出しが行われます。

パラメータ

パラメータ	説明
対象の共有リスト	（必須）対象の連絡先を追加する共有リスト。
連絡先検索	API連絡先ID – 対象の連絡先ID 連絡先フィールド – 「API連絡先ID」が指定されていない場合、連絡先フィールドを使用して対象の連絡先を検索します。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`

アクション - 共有リストからの連絡先の削除

パラメータ

パラメータ	説明
対象の共有リスト	（必須）対象の連絡先を削除する共有リスト。
連絡先検索	API連絡先ID – 対象の連絡先ID 連絡先フィールド – 「API連絡先ID」が指定されていない場合、連絡先フィールドを使用して対象の連絡先を検索します。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`

アクション - 連絡先の挿入または更新

パラメータ

パラメータ	説明
更新方法	（必須）該当する更新方法を選択します。作成のみ – 検索せずに新しい連絡先を作成します。更新のみ – 既存の連絡先を検索して更新します。作成または更新 – 既存の連絡先を検索し、見つかった場合は更新し、見つからない場合は新しい連絡先を作成します。
連絡先検索	更新方法が更新のみ、作成、または更新の場合は必須です。連絡先フィールド – 「API連絡先ID」が指定されていない場合、これらのフィールドを使用して対象の連絡先を検索します。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`
連絡先作成データ	更新方法が作成のみ、作成、または更新の場合は必須です。新しい連絡先を作成するための値をマッピングします。日付属性は秒単位のUnixタイムスタンプに変換されます。
連絡先更新データ	更新方法が更新のみ、作成、または更新の場合は必須です。既存の連絡先を更新するための値をマッピングします。日付属性は秒単位のUnixタイムスタンプに変換されます。

アクション - 連絡先の挿入

パラメータ

パラメータ	説明
構成するデータ	（必須）値を連絡先フィールドにマッピングします。日付属性は秒単位のUnixタイムスタンプに変換されます。

アクション - 連絡先の更新

パラメーター

パラメーター	説明
連絡先の検索	API Contact ID – 対象の連絡先ID Contact Fields – 「API Contact ID」が指定されていない場合、これらのフィールドを使用して対象の連絡先を検索します。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`
構成するデータ	（必須）値を連絡先フィールドにマッピングします日付属性は秒単位のUnixタイムスタンプに変換されます

アクション - 連絡先をメールグループに登録する

「API Contact ID」が指定されていない場合、Contact Lookupパラメーターで指定されたContact Fieldsに基づいて対象の連絡先を検索するため、追加のAPI呼び出しが行われます。

パラメーター

パラメーター	説明
対象のメールグループ	（必須）対象の連絡先を登録するメールグループ
連絡先の検索	API Contact ID – 対象の連絡先ID Contact Fields – 「API Contact ID」が指定されていない場合、Contact Fieldsを使用して対象の連絡先を検索します。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`

アクション - 連絡先をメールグループから登録解除する

パラメーター

パラメーター	説明
対象のメールグループ	（必須）対象の連絡先が属するメールグループ
連絡先の検索	API Contact ID – 対象の連絡先ID Contact Fields – 「API Contact ID」が指定されていない場合、Contact Fieldsを使用して対象の連絡先を検索します。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`

アクション - 連絡先のカスタムオブジェクトデータを挿入する

パラメーター

パラメーター	説明
連絡先の検索	（必須）連絡先を対象のカスタムオブジェクトにマッピングするために使用します。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`
対象のカスタムオブジェクト	（必須）
構成するカスタムオブジェクトデータ	（必須）値を連絡先のカスタムオブジェクトフィールドにマッピングします。日付属性は秒単位のUnixタイムスタンプに変換されます。

アクション - 連絡先のカスタムオブジェクトデータを挿入または更新する

パラメーター

パラメーター	説明
連絡先の検索	（必須）連絡先を対象のカスタムオブジェクトにマッピングするために使用します。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`
対象のカスタムオブジェクト	（必須）レコードを作成または更新するカスタムオブジェクト。
レコードの検索	（必須）これらのフィールドと値に一致するレコードが見つかった場合、以下の更新パラメーターを使用して更新が実行されます。レコードが見つからない場合、以下の挿入パラメーターを使用して挿入が実行されます。更新を実行するには、すべてのフィールドと値が存在し、一致している必要があります。（連絡先の検索に関連する）最大50件のレコードが検索されます。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`
構成するレコード作成データ	（必須）レコードが見つからない場合、これらの値を使用してレコードを作成します。日付属性は秒単位のUnixタイムスタンプに変換されます。
構成するレコード更新データ	（必須）レコードが見つかった場合、これらの値を使用してレコードを更新します。日付属性は秒単位のUnixタイムスタンプに変換されます。