コネクタを追加する

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

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

コネクタを追加する

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

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 タブには、必要なパラメータに続いて利用可能なマッピングカテゴリ（イベントデータ、ユーザーデータなど）が表示されます。

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

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

新しいコネクタは自動的にアクティブ化されません。コネクタをアクティブ化する方法については、コネクタのアクティブ化または非アクティブ化を参照してください。

コネクタをテストする

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

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

EventStreamとAudienceStreamは有効なTrace IDのみを渡します。無効なTrace IDはペイロードから削除されます。