Oracle Eloquaコネクタ構成ガイド | サーバーサイドコネクタ

必要条件

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

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

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

アクション名	AudienceStream	EventStream
Update Contact via Bulk API	✓	✗
Add Contact to Shared List	✓	✗
Remove Contact from Shared List	✓	✗
Insert or Update Contact	✓	✗
Insert Contact	✓	✗
Update Contact	✓	✗
Subscribe Contact to Email Group	✓	✗
Unsubscribe Contact from Email Group	✓	✗
Insert Custom Object Data for Contact	✓	✗
Insert or Update Custom Object Data for Contact	✓	✗

バッチ制限

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

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

構成の構成

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

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

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

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

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

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

パラメータ	説明
Import Definition Name	必須。連絡先のインポート定義の名前。
Contact Fields	必須。アップロード中に使用する連絡先フィールドを選択します。
Identifier Field Name	必須。Oracle Eloqua内の既存のレコードとインポートされたデータを照合するフィールドを選択します。これはContact Fieldsのいずれかと一致し、各レコードに対して一意のデータを含むべきです。
Optional - Update Rule	このインポート定義でインポートされた値からOracle Eloquaデータベースの値を更新するアクションを選択します： `always`：常に値を更新します。 `ifNewIsNotNull`：新しい値が空白でない場合に値を更新します。 `ifExistingIsNull`：既存の値が空白の場合に値を更新します。 `useFieldRule`：フィールドレベルで定義されたルールを使用します。
Optional - Sync to Contact List	この連絡先を同期する連絡先リストを選択します。
Optional - Sync to Contact List Action	このインポート定義の連絡先リストの同期アクションを選択します：`add`または`remove`。
Optional - Sync to Email Group	この連絡先を同期するメールグループを選択します。
Optional - Sync to Email Group Action	このインポート定義のメールグループの同期アクションを選択します：`subscribed`または`unsubscribed`。

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

Nextをクリックするか、Actionsタブに移動します。ここでコネクタアクションを構成します。

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

アクション - Update Contact via Bulk API

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

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

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

パラメータ

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

アクション - Add Contact to Shared List

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

“API Contact ID"が指定されていない場合、追加のAPI呼び出しが行われ、Contact Lookupパラメータで指定されたContact Fieldsに従ってTarget Contactを検索します。

パラメータ

パラメータ	説明
Target Shared List	必須。Target ContactのTarget Shared List。
Contact Lookup	API Contact ID – Target Contact ID Contact Fields – “API Contact ID"が指定されていない場合、Contact FieldsがTarget Contactの検索に使用されます。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`

アクション - Remove Contact from Shared List

パラメータ

パラメータ	説明
Target Shared List	必須。Target ContactのTarget Shared List。
Contact Lookup	API Contact ID – Target Contact ID Contact Fields – “API Contact ID"が指定されていない場合、Contact FieldsがTarget Contactの検索に使用されます。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`

アクション - Insert or Update Contact

パラメータ

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

アクション - Insert Contact

パラメータ

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

アクション - Update Contact

パラメータ

パラメータ	説明
Contact Lookup	API Contact ID – ターゲットのContact ID Contact Fields – “API Contact ID"が指定されていない場合、これらのフィールドがターゲットのContactを検索するために使用されます。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`
Data To Set	必須。連絡先フィールドに値をマップします日付属性はUnixタイムスタンプ（秒）に変換されます

アクション - ContactをEmail Groupに登録

“API Contact ID"が指定されていない場合、Contact Fieldsで指定されたContact Lookupパラメータに従ってターゲットのContactを検索するための追加のAPI呼び出しが行われます。

パラメータ

パラメータ	説明
Target Email Group	必須。ターゲットのContactのためのTarget Email Group
Contact Lookup	API Contact ID – ターゲットのContact ID Contact Fields – “API Contact ID"が指定されていない場合、Contact FieldsがターゲットのContactを検索するために使用されます。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`

アクション - ContactをEmail Groupから退会

パラメータ

パラメータ	説明
Target Email Group	必須。ターゲットのContactのためのTarget Email Group
Contact Lookup	API Contact ID – ターゲットのContact ID Contact Fields – “API Contact ID"が指定されていない場合、Contact FieldsがターゲットのContactを検索するために使用されます。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`

アクション - Contactのカスタムオブジェクトデータを挿入

パラメータ

パラメータ	説明
Contact Lookup	必須。 Contactは、ContactをTarget Custom Objectにマップするために使用されます。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`
Target Custom Object	必須。
Custom Object Data to Set	必須。値をContactのカスタムオブジェクトフィールドにマップします。日付属性はUnixタイムスタンプ（秒）に変換されます。

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

パラメータ

パラメータ	説明
Contact Lookup	必須。 Contactは、ContactをTarget Custom Objectにマップするために使用されます。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`
Target Custom Object	必須。カスタムオブジェクトにレコードを作成または更新します。
Record Lookup	必須。これらのフィールドと値でレコードが見つかった場合、以下のUpdate Parametersで更新が行われます。レコードが見つからない場合、以下のInsert Parametersで挿入が行われます。フィールドと値はすべて存在し、一致する必要があります。更新が行われるためには、Contact Lookupに関連する50レコードのみが検索されます。日付属性は次の形式に変換されます：`yyyy-MM-dd HH:mm:ss`
Record create data to set	必須。レコードが見つからない場合、これらの値がレコードの作成に使用されます。日付属性はUnixタイムスタンプ（秒）に変換されます。
Record update data to set	必須。レコードが見つかった場合、これらの値がレコードの更新に使用されます。日付属性はUnixタイムスタンプ（秒）に変換されます。