コンソールのエンドユーザー更新API Incomingインテグレーション

概要

コンソールのData Integration Centerを使用して、安全なAPIコールを通じてユーザーデータをWalkMeにインポートします。 インポートされると、ユーザープロファイルを充実させ、コンテンツをセグメント化し、ユーザーエクスペリエンスをパーソナライズするためにデータを使用できます。 このインテグレーションにより、あらゆるシステムからのリアルタイムまデータ転送が可能となり、ファイルのアップロードに頼ることなく、ユーザー属性をWalkMeに簡単に同期できます。

使用方法

エンドユーザー更新API Incomingインテグレーションの設定方法

1. コンソールの「データ統合」ページに移動します。

2. 右上隅の「統合を作成」をクリックしてください。

1. 統合タイプを選択するオプションが提示されたモーダルが開きます。

2. 「データ入力」タイルをクリックします。

3. ドロップダウンメニューの「接続タイプ」から「エンドユーザー更新API」を選択します。

4. 「続行」をクリックして、設定に進みます。

5. 「Create Incoming APIインテグレーション」ページが表示されますので、以下の3つのステップに沿って進めてください。

   1. 統合の定義

   2. マップ列

   3. インテグレーションエンドポイントを取得する

統合の定義

1. データ統合リストに、この統合を識別するのに役立つ名前を入力してください。

   1. 例：APIによるリアルタイムエンリッチメント

2. インポートされたデータが適用されるWalkMeシステムを選択してください。

3. 関連する環境を選択してください（本番、QA）

4. [次へ]をクリックします。

マップ列

このステップでは、受信するAPIデータがWalkMeのユーザー属性にマッピングされる方法を定義します。

1. ユーザー識別子プロパティを入力します。

   1. これは、データ内のユーザーを特定するための情報で、APIから取得したデータとWalkMeユーザーを一致させるために使用されます。

2. + プロパティを追加をクリックして、インポートするユーザー属性を設定してください。

   1. 各プロパティについて、以下の操作が可能です。

      1. プロパティ名を入力してください（APIペイロードに表示されているもの）。

      2. WalkMeで識別しやすくするために名前を変更してください。

      3. 正しいデータタイプ（文字列、番号、日付）を割り当ててください。

3. [次へ]をクリックします。

インテグレーションエンドポイントを取得してください。

設定完了後、WalkMeは、すべての受信APIインテグレーションで使用される固定のAPIエンドポイントを提供します。 このエンドポイントは、インテグレーションごとに変更されることはありません。

データを正しく安全に送信するには、APIリクエストに以下が含まれている必要があります。

1. 承認ベアラートークン：自身の承認トークンを追加してください。

2. リクエスト本文：

   1. インテグレーショントークン：特定のインテグレーションを識別し、データを適切なシステムにルーティングします。

   2. データ：先ほどマッピングした属性と、自身の値を含むオブジェクトの配列

4. ［Save（保存）］をクリックします