コネクタを追加する

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

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

コネクタを追加する

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

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 画面が表示されます。

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

Send Visitor Data アクションを Include Current Visit 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はペイロードから削除されます。