コネクタを追加する

コネクタを追加するには、以下のステップが含まれます：

• コネクタを追加する
• ソースを選択する
• コネクタアクションを追加する
• データをマッピングする

コネクタを追加する

新しいコネクタはデフォルトで非アクティブです。コネクタをアクティブ化する方法については、コネクタのアクティブ化または非アクティブ化を参照してください。

EventStreamまたはAudienceStreamコネクタを追加するには、以下の手順を使用します：

1. Server-Side > Connectors > Marketplace に移動します。 または、Server-Side > Connectors > Overview に移動し、+ New Connector をクリックします。 コネクタのリストはデフォルトでアルファベット順に並べられています。
2. 必要に応じて以下の方法でコネクタのリストをフィルタリングします：
   • Data Type フィルタをクリックし、Event または Visitor を選択します。
   • Device Type フィルタをクリックし、Mobile Device、Web Browser、IoT/Connected Devices、または Custom Devices を選択します。
   • Sort By フィルタをクリックし、A-Z または Z-A を選択します。
   • Search ボックスにコネクタ名の一部または全体を入力します。
3. コネクタを選択し、New Connector をクリックします。 Connector Summary が表示され、ベンダーのドキュメントと構成指示へのリンクが含まれます。
4. New Connector をクリックします。
5. コネクタのNameを入力します。
6. 必要に応じて、EULA契約に対してI Acceptを選択します。
7. Authenticationについて、ログイン資格情報、トークンまたはパスワード、アカウントID、およびベンダーサービスとの接続を確立するために必要なその他の情報を入力します。
8. コネクタのアクションを構成するには、Done & New Action をクリックします。 アクションを後で構成する場合は、Done をクリックします。

ソースを選択する

コネクタのソースは、コネクタのタイプに応じてイベントフィードまたはオーディエンスです。

イベントソースを追加する

1. Data Type で Event Data を選択します。
2. Data Source を選択します。
3. Event Feed を選択します。
4. Next をクリックします。 New Action 画面が表示されます。

訪問ソースを追加する

1. Data Type で Visitor Data を選択します。
2. Audience を選択します。
3. Trigger で以下のいずれかを選択します：
   • Joined Audience - この訪問中に訪問がオーディエンスに参加した場合にアクションをトリガーします。たとえば、カート放棄者や頻繁なショッパーがオーディエンスに参加したときなどです。
   • Left Audience - この訪問中に訪問がオーディエンスを離れた場合にアクションをトリガーします。訪問が削除されたときにはこのアクションは発生しません。詳細については、訪問の削除を参照してください。
   • In Audience at start of visit - 訪問の開始時に訪問がすでにオーディエンスにいる場合にアクションをトリガーします。
   • In Audience at end of visit - 訪問の終了時に訪問がオーディエンスにいる場合にアクションをトリガーします。
4. このアクションがトリガーされる頻度を制限するには、Frequency Cap を On に切り替え、Action Priority と Action Cooldown Group を選択します。 詳細については、アクションの頻度キャッピングと優先順位付けを参照してください。
5. Next をクリックします。 New Action 画面が表示されます。

アクションを追加する

1. New Action 画面で、Action Name を入力します。
2. Action Type を選択します。 コネクタによっては、アクションタイプのリストが異なります。たとえば、AWS KinesisやGoogle Pub/SubのようなBig Dataコネクタには通常、Send Visitor Data アクションがあります。
3. 必要なフィールドをすべて入力し、利用可能なドロップダウンリストを使用して完了します。 必要なフィールドにデータが欠けている場合は、赤いテキストでエラーメッセージが表示されます。

   

   すべての必要なフィールドに値が選択または入力されると、COMPLETED と表示されます。
4. Save をクリックします。 Action Details 画面が表示されます。

新しいアクションはデフォルトで非アクティブです。

Include Current Visit Data オプションを選択して Send Visitor Data アクションを使用する場合、訪問データの events 配列には、AudienceStreamで定義されている属性（属性またはエンリッチメントとして）のイベント属性のみが含まれます。コネクタが訪問データを必要とする場合にのみ、Include Current Visit Data オプションを選択することがベストプラクティスです。詳細については、AudienceStore Data Guideを参照してください。

マッピング

Mappings タブには、必要なパラメータと利用可能なマッピングカテゴリが表示されます。

ベンダーパラメータに属性をマッピングするには、次の手順を使用します：

1. 必要な各パラメータに値を入力するか、必要に応じて属性をパラメータにマッピングします。 選択したSourceに基づいて属性のリストが作成されます。たとえば、オーディエンスを選択すると、訪問および訪問スコープの属性が表示されますが、イベント属性は表示されません。
2. 各カテゴリを展開して利用可能なマッピングを表示します。
3. 必要に応じて属性をベンダーパラメータにマッピングします。
4. 追加の属性をマッピングするには、+ Add Mapping をクリックします。
5. Back をクリックして修正するか、Finish をクリックします。
6. 新しいアクションをアクティブ化するには、クリックします
7. 保存して公開します。

マッピングのコピー

Copy Mappings 機能を使用すると、既存のコネクタアクションからデータマッピングをコピーしたり、既存のアクションにデータマッピングをコピーしたりすることができます。この画面では、コピー先またはコピー元のアクションを選択し、上書きの取り扱いを選択します。

既存のアクションからまたは既存のアクションにマッピングをコピーするには、次の手順に従います：

1. コピーするアクションを選択します。 Mappings 画面から Copy Mappings をクリックし、次のいずれかを選択します：
   • Insert Mappings From an Action：選択したアクションから現在のアクションにマッピングをコピーします。
   • Copy Mappings to an Action：現在のアクションから選択したアクションにマッピングをコピーします。
2. 上書きモードを選択します。 ターゲットアクションにすでに存在するマッピングをコピーする方法を決定するために、次のオプションのいずれかを選択します：
   • Keep Original Mappings：ソースからの新しいマッピングを追加し、宛先の既存のマッピングを変更せずに追加します。
   • Overwrite All Mappings：ソースアクションからのすべての既存のマッピングを置き換えます。
3. アクションを選択します。 フィルタを適用するか検索してソースアクションのリストを絞り込み、アクションの隣のラジオボタンを選択します。
4. Done をクリックします

テンプレート

コネクタテンプレートを使用すると、コネクタ用のカスタムAPIリクエストを構築できます。これらを使用して、ベンダーのエンドポイントに必要な形式（JSONまたはXMLなど）でペイロードを動的に入力します。

詳細については、コネクタテンプレートについてを参照してください。

コネクタをテストする

コネクタを追加して構成した後、テストする必要があります。コネクタをテストする最も簡単な方法は、Trace Toolを使用することです：

1. 新しいトレースを開始します。
2. リアルタイムログを調べます。
3. Actions Triggered エントリをクリックして展開し、検証したいアクションを確認します。
4. アクションを検証し、ログステータスを表示します。

コネクタは有効なトレースIDのみを渡します。無効なトレースIDはペイロードから削除されます。