コネクタを追加する

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

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

コネクタを追加する

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

EventStreamまたはAudienceStreamコネクタを追加するには、以下のステップを使用します：

1. Connect > Connectors > Marketplace に移動します。
   または、Connect > 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 をクリックします。

訪問ソースを追加する

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. Data Source を選択します。
2. Segment を選択します。
3. Continue をクリックします。

アクションを追加する

1. New Action 画面で Action Name を入力します。
2. Action Type を選択します。
   アクションタイプのリストはコネクタによって異なります。AWS KinesisやGoogle Pub/Subのようなビッグデータコネクタは通常、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. 保存して公開します。

コネクタメタデータ

コネクタメタデータは、コネクタのコンテキストを説明するマッピング可能な値です。どのコネクタ、アクション、オーディエンス、またはイベントフィードがアクションをトリガーしたかを識別します。これらはコネクタアクションの構成時にのみマッピングドロップダウンに表示され、訪問プロファイルや属性管理では利用できません。

たとえば、ベンダーAPIにオーディエンス名を送信するには、手動でオーディエンス名を入力する代わりにAudience Name属性をマッピングします。オーディエンスが改名された場合、属性は自動的に新しい名前を反映します。

マッピングドロップダウンで利用可能な次のコネクタメタデータ属性があります：

アクションのソースタイプに一致する属性のみがマッピングドロップダウンに表示されます。

コピーマッピング

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

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

1. コピーするアクションを選択します。
   マッピング画面からコピーマッピングをクリックし、以下のいずれかを選択します：
   • アクションからマッピングを挿入：選択したアクションから現在のアクションにマッピングをコピーします。
   • アクションにマッピングをコピー：現在のアクションから選択したアクションにマッピングをコピーします。
2. 上書きモードを選択します。
   ターゲットアクションに既に存在するマッピングのコピー方法を決定するために、以下のオプションのいずれかを選択します：
   • 元のマッピングを保持：ソースから新しいマッピングを追加し、目的地の既存のマッピングは変更しません。
   • すべてのマッピングを上書き：ソースアクションからのもので目的地のすべての既存のマッピングを置き換えます。
3. アクションを選択します。
   フィルターを適用するか検索してソースアクションのリストを絞り込み、次にアクションのラジオボタンを選択します。
4. 完了をクリックします

テンプレート

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

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

コネクタのテスト

コネクタを追加して構成した後は、テストする必要があります。コネクタをテストする最も簡単な方法は、次のようにトレースツールを使用することです：

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

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