Silverpop Engageコネクタの構成ガイド | サーバーサイドコネクタ

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

アクション名	AudienceStream	EventStream
データベースに訪問を挿入/更新する	✓	✗
データベースの訪問を更新する	✓	✗
コンタクトリストに訪問を挿入する	✓	✗
データベースに訪問を挿入/更新し、プログラムに追加する	✓	✗
プログラムに訪問を挿入する	✓	✗
カスタムトリガーオートレスポンダーを使用してメールを送信する	✓	✗
リレーショナルテーブルに訪問を挿入/更新する	✓	✗

構成の構成

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

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

APIユーザー名
APIパスワード
サーバーホスト：例えば、api5.silverrpop.comのようなサーバーホストです（http（s）://プロトコルは含めないでください）

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

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

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

アクション - データベースに訪問を挿入/更新する

パラメータ

パラメータ	説明
データベース名	これはターゲットのデータベース（コンタクトリストではない）です。以下の方法で見つけることができます： Silverpopアカウントにログインするデータ -> データベースに移動する
構成するデータ列	主キーフィールドは必須です。 `VISITOR_KEY`（オプション）：提供された場合、Webトラッキング機能を使用して以前に不明な訪問に連絡先を関連付けるための訪問キーを指定することができます。 `CONTACT_LIST_ID`（オプション）：提供された場合、新しい連絡先を指定されたコンタクトリストIDに追加することができます。
参照用の受信者主キーカラム	受信者データベース列の更新条件を有効にするが有効になっている場合にのみ必要です。また、エラーを防ぐために、Upsertを有効にするオプションを有効にする必要があります。 `RECIPIENT_ID`または主キーフィールドのいずれかが必要です。 `Email`：APIの要件として、Email列が構成されている場合は、`OLD_EMAIL`列も構成してください。
受信者データベース列の一致条件	受信者データベース列の更新条件を有効にするが有効になっている場合にのみ必要です。指定したすべての条件が評価されます。たとえば、論理AND操作が行われます。注意：このオプションを使用すると、データベースの受信者の検索に追加のAPI呼び出しが強制されます。必要な場合にのみ使用してください。

アクション - データベースの訪問を更新する

パラメータ

パラメータ	説明
データベース名	これはターゲットのデータベース（コンタクトリストではない）です。以下の方法で見つけることができます： Silverpopアカウントにログインするデータ -> データベースに移動する
参照用の主キーカラム	`RECIPIENT_ID`または主キーフィールドのいずれかが必要です。 `Email`：APIの要件として、Email列が構成されている場合は、`OLD_EMAIL`列も構成してください。
更新するデータ列	カスタムフィールド名にキーワード`_tealium_as`が含まれているフィールドのみ更新可能です。カスタムの列名にキーワード`_tealium_as`を追加してください。
受信者データベース列の一致条件	受信者データベース列の更新条件を有効にするが有効になっている場合にのみ必要です。指定したすべての条件が評価されます（論理AND操作）。注意：このオプションを使用すると、データベースの受信者の検索に追加のAPI呼び出しが強制されます。必要な場合にのみ使用してください。

アクション - コンタクトリストに訪問を挿入する

パラメータ

パラメータ	説明
コンタクトリスト名	これはコンタクトリスト（データベースではない）です。以下の方法で見つけることができます： Silverpopアカウントにログインするデータ -> コンタクトリストに移動する
コンタクトリストに対応するデータベース	これは対応するコンタクトリストのデータベースです。以下の方法で見つけることができます： Silverpopアカウントにログインするデータ -> データベースに移動する
参照用の主キーカラム	受信者IDまたは主キーフィールドのいずれかが必要です。追加する連絡先が、対象コンタクトリストの対応するデータベースにすでに存在していることを確認してください。

アクション - データベースに訪問を挿入/更新し、プログラムに追加する

パラメータ

パラメータ	説明
データベース名	これはターゲットのデータベース（コンタクトリストではない）です。以下の方法で見つけることができます： Silverpopアカウントにログインするデータ -> データベースに移動する
構成するデータ列	主キーフィールドは必須です。 `VISITOR_KEY`（オプション）：提供された場合、Webトラッキング機能を使用して以前に不明な訪問に連絡先を関連付けるための訪問キーを指定することができます。 `CONTACT_LIST_ID`（オプション）：提供された場合、新しい連絡先を指定されたコンタクトリストIDに追加することができます。
プログラムID	プログラムの一意のIDです。
参照用の受信者主キーカラム	受信者データベース列の更新条件を有効にするが有効になっている場合にのみ必要です。また、エラーを防ぐために、Upsertを有効にするオプションを有効にする必要があります。 `RECIPIENT_ID`または主キーフィールドのいずれかが必要です。 `Email`：APIの要件として、Email列が構成されている場合は、`OLD_EMAIL`列も構成してください。
受信者データベース列の一致条件	受信者データベース列の更新条件を有効にするが有効になっている場合にのみ必要です。指定したすべての条件が評価されます。たとえば、論理AND操作が行われます。注意：このオプションを使用すると、データベースの受信者の検索に追加のAPI呼び出しが強制されます。必要な場合にのみ使用してください。

アクション - プログラムに訪問を挿入する

パラメータ

パラメータ	説明
コンタクトID	プログラムに追加されるコンタクトの一意のIDです。
プログラムID	プログラムの一意のIDです。

アクション - カスタムトリガーオートレスポンダーを使用してメールを送信する

パラメータ

パラメータ	説明
オートレスポンダーメーリング送信ID	必須：これはオートレスポンダーのIDです（名前ではありません）。この操作が機能するためには、オートレスポンダーがカスタムトリガーである必要があります。たとえば、自動メーリング送信を作成するときにカスタムオプションを選択し、データベースをコンタクトソースとして使用します。オートレスポンダーのIDは、Silverpopアカウントのオートレスポンダーリストのページに移動して、オートレスポンダーを開き、ブラウザのURLクエリ文字列の`mailingId`の値をコピーすることで見つけることができます。たとえば、`https://engage5.silverpop.com/mailingsSummary.do?action=mailingSummary&mailingId=XXXXXXX`
オートレスポンダーに対応するデータベース	これは選択したオートレスポンダーを作成するときに使用したデータベースです。
対応する主キーカラム	`RECIPIENT_EMAIL`：必須です。また、この自動メーリングのために使用されるデータベースの主キーカラムも必要です。

アクション - リレーショナルテーブルに訪問を挿入/更新する

パラメータ

パラメータ 説明

ターゲットリレーショナルテーブル必須

構成するデータを構成する

パラメータ	説明
ターゲットリレーショナルテーブル	必須
構成するデータを構成する	列の値をキーにマップします。主キーフィールドは必須です。Silverpopが主キーを一致させることができる場合、既存のレコードが更新され、それ以外の場合は新しいレコードが挿入されます。注意：このアクションは、1つのAPI呼び出しで複数のリレーショナルテーブルの挿入をサポートしています。この機能を使用する場合は、ターゲットの列をAudienceStreamリストに構成してください。注意：構成されているリレーショナルテーブルの列がSilverpopの列タイプ`DATE`または`TIMESTAMP`であり、AudienceStreamのタイプが日付の場合、このコネクタは日付変数を適切なGMT日付に自動的に変換します。以下に示します。他のAudienceStreamのタイプが構成されている場合は、API呼び出しの失敗を防ぐために適切にフォーマットされたデータを渡すようにしてください。 Silverpop EngageリレーショナルテーブルAPIの期待される日付形式：`MM/dd/yyyy`、例：`06/18/2015` Silverpop EngageリレーショナルテーブルAPIの期待されるタイムスタンプ形式：`MM/dd/yyyy hh:mm:ss`、例：`06/18/2015 10:57:06`

列の値をキーにマップします。
主キーフィールドは必須です。Silverpopが主キーを一致させることができる場合、既存のレコードが更新され、それ以外の場合は新しいレコードが挿入されます。
注意：このアクションは、1つのAPI呼び出しで複数のリレーショナルテーブルの挿入をサポートしています。この機能を使用する場合は、ターゲットの列をAudienceStreamリストに構成してください。
注意：構成されているリレーショナルテーブルの列がSilverpopの列タイプDATEまたはTIMESTAMPであり、AudienceStreamのタイプが日付の場合、このコネクタは日付変数を適切なGMT日付に自動的に変換します。以下に示します。他のAudienceStreamのタイプが構成されている場合は、API呼び出しの失敗を防ぐために適切にフォーマットされたデータを渡すようにしてください。
- Silverpop EngageリレーショナルテーブルAPIの期待される日付形式：MM/dd/yyyy、例：06/18/2015
- Silverpop EngageリレーショナルテーブルAPIの期待されるタイムスタンプ形式：MM/dd/yyyy hh:mm:ss、例：06/18/2015 10:57:06