Oracle Eloqua コネクタ構成ガイド

要件

• Oracle Eloqua アカウント
• あなたの Oracle Eloqua アカウントの会社名
• あなたの Oracle Eloqua アカウントのユーザー名
• あなたの Oracle Eloqua アカウントのパスワード
• Oracle Eloqua で許可リストが有効になっている場合は、AudienceStream サーバー IP アドレスを Oracle Eloqua の許可リストに追加してください。

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

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

アクション名	AudienceStream	EventStream
バルク API 経由での連絡先更新	✓	✗
共有リストへの連絡先追加	✓	✗
共有リストからの連絡先削除	✓	✗
連絡先の挿入または更新	✓	✗
連絡先の挿入	✓	✗
連絡先の更新	✓	✗
メールグループへの連絡先の登録	✓	✗
メールグループからの連絡先の登録解除	✓	✗
連絡先のカスタムオブジェクトデータの挿入	✓	✗
連絡先のカスタムオブジェクトデータの挿入または更新	✓	✗

バッチ制限

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

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

構成の構成

コネクタマーケットプレイスに移動して、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについての記事を参照してください。

コネクタを追加した後、次の必要な構成を構成します：

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

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

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

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

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

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

次へ をクリックするか、アクション タブに進みます。ここでコネクタアクションを構成します。

このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

アクション - バルク API 経由での連絡先更新

バルク API は、次のいずれかのしきい値に達するか、プロファイルが公開されるまでリクエストをキューに入れます：

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

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

パラメータ

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

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

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

“API Contact ID"が指定されていない場合、連絡先フィールドで指定された連絡先検索パラメータに従ってターゲット連絡先を検索するために追加の API コールが行われます。

パラメータ

パラメータ	説明
ターゲット共有リスト	(必須) ターゲット連絡先のターゲット共有リスト。
連絡先検索	API Contact ID – ターゲット連絡先 ID 連絡先フィールド – “API Contact ID"が指定されていない場合、連絡先フィールドがターゲット連絡先を検索するために使用されます。 日付属性は次の形式に変換されます：yyyy-MM-dd HH:mm:ss

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

“API Contact ID"が指定されていない場合、連絡先フィールドで指定された連絡先検索パラメータに従ってターゲット連絡先を検索するために追加の API コールが行われます。

パラメータ

パラメータ	説明
ターゲット共有リスト	(必須) ターゲット連絡先のターゲット共有リスト。
連絡先検索	API Contact ID – ターゲット連絡先 ID 連絡先フィールド – “API Contact ID"が指定されていない場合、連絡先フィールドがターゲット連絡先を検索するために使用されます。 日付属性は次の形式に変換されます：yyyy-MM-dd HH:mm:ss

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

“API Contact ID"が指定されていない場合、連絡先フィールドで指定された連絡先検索パラメータに従ってターゲット連絡先を検索するために追加の API コールが行われます。

パラメータ

パラメータ	説明
更新戦略	(必須) 適用可能な更新戦略を選択します。 Create Only – 連絡先を検索せずに新しい連絡先を作成します。 Update Only – 既存の連絡先を検索して更新します。 Create or Update – 既存の連絡先を検索し、見つかった場合は更新し、そうでない場合は新しい連絡先を作成します。
連絡先検索	更新戦略が Update Only、Create、または Update の場合は必須です。 連絡先フィールド – “API Contact ID"が指定されていない場合、これらのフィールドがターゲット連絡先を検索するために使用されます。 日付属性は次の形式に変換されます：yyyy-MM-dd HH:mm:ss
新規連絡先データ	更新戦略が Create Only、Create、または Update の場合は必須です。 新しい連絡先を作成するための値をマッピングします。 日付属性は Unix タイムスタンプ（秒単位）に変換されます。
連絡先データの更新	更新戦略が Update Only、Create、または Update の場合は必須です。 既存の連絡先を更新するための値をマッピングします。 日付属性は Unix タイムスタンプ（秒単位）に変換されます。

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

パラメータ

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

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

“API Contact ID"が指定されていない場合、連絡先フィールドで指定された連絡先検索パラメータに従ってターゲット連絡先を検索するために追加の API コールが行われます。

パラメータ

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

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

「API 連絡先 ID」が指定されていない場合、連絡先フィールドに指定された内容に基づいて対象の連絡先を検索するために追加のAPIコールが行われます。

パラメータ

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

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

「API 連絡先 ID」が指定されていない場合、連絡先フィールドに指定された内容に基づいて対象の連絡先を検索するために追加のAPIコールが行われます。

パラメータ

パラメータ	説明
対象メールグループ	(必須) 対象の連絡先のための対象メールグループ
連絡先検索	API 連絡先 ID – 対象の連絡先 ID 連絡先フィールド – 「API 連絡先 ID」が指定されていない場合、連絡先フィールドを使用して対象の連絡先を検索します。 日付属性は次の形式に変換されます: 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タイムスタンプに変換されます。