Eloquaコネクタ構成ガイド

必要条件

• Eloquaアカウント
• Eloquaアカウントの会社名
• Eloquaアカウントのユーザー名
• Eloquaアカウントのパスワード

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

アクション名	AudienceStream	EventStream
共有リストにコンタクトを追加	✓	✗
共有リストからコンタクトを削除	✓	✗
コンタクトを挿入または更新	✓	✗
コンタクトを挿入	✓	✗
コンタクトを更新	✓	✗
コンタクトをメールグループに登録	✓	✗
コンタクトをメールグループから解除	✓	✗
コンタクトのカスタムオブジェクトデータを挿入	✓	✗
コンタクトのカスタムオブジェクトデータを挿入または更新	✓	✗

構成の構成

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

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

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

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

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

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

アクション - 共有リストにコンタクトを追加

アカウントから最初の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呼び出しが行われます。

パラメータ

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

アクション - コンタクトを挿入

パラメータ

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

アクション - コンタクトを更新

「API Contact ID」が指定されていない場合、指定されたフィールドに従ってターゲットコンタクトを検索するための追加のAPI呼び出しが行われます。

パラメータ

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

アクション - コンタクトをメールグループに登録

「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

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

パラメータ

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

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

パラメータ

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