コネクタを追加する

コネクタの追加には、次の手順が含まれます。

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

コネクタを追加する

新しいコネクタは、デフォルトでは無効になっています。コネクタを有効にする方法については、コネクタを有効または無効にするを参照してください。

イベントストリーミングまたは顧客データプラットフォーム（CDP）コネクタを追加するには、次の手順を実行します。

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

新しいアクションは、デフォルトでは無効になっています。

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

マッピング

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はペイロードから削除されます。