Segment.comインテグレーションの概要

この記事では、Pendoを、ユーザーデータを収集、保存、転送するプラットフォームであるSegmentとインテグレーションする方法について説明します。 Pendoでの訪問者とアカウントのセグメント化に関する情報をお探しの方は、セグメントの記事を参照してください。

Segmentとのインテグレーションにより、Pendoや他のインテグレーションツールにデータを送信できるようになります。Segmentのオープンソースライブラリを使ってデータを追跡すると、Segmentはデータを適切な形式に変換してPendoに転送します。この記事では、PendoをSegmentの送信先として設定する方法について説明します。

インテグレーションの仕組み

Segmentのスニペットがサイトにインストールされると、APIキーで自動的にPendoが初期化されます。これは、開発者のためのPendoインストールガイドで説明している標準的なPendoのインストール方法に代わるものです。

Pendoにデータを送信するようにインテグレーションが設定されているため、PendoのインストールスニペットをSegmentに貼り付ける必要はありません。

Segmentのスニペットを使用する場合、Pendoエージェントが挿入され、Segmentのイベントが Segment.comに送信されると同時に、エージェントからPendoにメタデータが渡されます。その結果、Pendoの［データマッピング（Data Mappings）］ページにリスト表示されるメタデータと値には、 エージェント（Agent）とsegment.ioの両方のグループタイプが付与されます。

WebhookでSegmentをインテグレーションすると、Segment.comからPendoにデータが渡され、［データマッピング（Data Mappings）］ページのメタデータの［グループタイプ（Group Type）］ に反映されます。つまり、メタデータと値はsegment.ioとしてのみグループ化されます。

インテグレーションの設定

Pendoは、特定（identify）、グループ（group）、および追跡（track）に関するスペックをサポートしています。使用したいスペックに応じた設定を行ってください。

セグメントの設定でPendoのAPIキーを追加する必要があります。PendoのAPIキーを見つける方法は、以下のとおりです。

1. ［設定（Settings）］>［サブスクリプション設定（Subscription Settings）］に移動します。
2. ［アプリケーション（Applications）］タブを開きます。
3. ［アプリケーション］リストから該当するアプリを見つけて開きます。デフォルトで［アプリの詳細（App Details）］タブが開きます。
4. ［APIキー（API Key）］行で文字列を見つけます。以下がAPIキーです。

APIキーは［インストール設定（Install Settings）］タブからも見つけることができます。インストールスクリプトの一番下に表示される文字列がAPIキーです。

特定とグループ化

［セグメント宛先（Segment Destinations）］ページで［Pendo］を選択し、Pendo APIキーを入力します。

セグメント宛先の設定が完了すると、Analytics.jsのAPIキーを使って、セグメントが自動的にPendoを初期化します。これにより、追加の手法を呼び出さずに、すべてのページイベントとクリックイベントをプルすることができます。

追跡とサーバー側データ

Pendoの追跡手法は、サーバー側のデータに対応しています。サーバー側のデータを追跡やその他のスペックで使用する場合は、セグメント内にPendoとWebhookの両方の宛先を追加します。

まず、宛先を作成します。セグメントで［宛先（My destinations）］に移動し、次の操作を行います。

1. ［+ 宛先を追加（+ Add destination）］を選択します。するとカタログが開きます。
2. ［Webhook（アクション）（Webhooks (Actions)）］を見つけ、新しい宛先として選択します。
3. 右上の［Webhook（アクション）を構成（Configure Webhooks (Actions)）］を選択します。
4. データソースを選択します。
5. ［次へ（Next）］を選択します。
6. 宛先用の名前を作成します。
7. ［宛先を作成（Create Destination）］を選択します。

次に、マッピングを構成します。セグメントで［宛先（My destinations）］に移動し、次の操作を行います。

1. ［マッピング（Mappings）］タブを開き、［+ 新しいマッピング（+ New Mapping）］を選択します。
2. ［アクション（Actions）］で［送信（Send）］を選択します。これにより、構成ページに移動します。
3. ［マッピングして送信するイベントを選択（Select events to map and send）］で、ドロップダウンメニューを使って［イベントタイプ（Event Type）］、［is］、［トラック（Track）］を選択します。
4. ［テストイベントを追加（Add test event）］で、［サンプルイベントを読み込む（Load Sample Event）］を選択します。
5. ［マッピングを選択（Select Mappings）］の下に以下のいずれかのURLを入力し、YOUR_PENDO_API_KEYの部分を実際のPendo APIキーに置き換えます。
   • US：https://data.pendo.io/data/segmentio/YOUR_PENDO_API_KEY
   • EU：https://data.eu.pendo.io/data/segmentio/YOUR_PENDO_API_KEY
6. ［テストイベントを送信（Send test event）］で［テストマッピング（Test Mapping）］を選択します。
7. 空白の回答と一緒に成功メッセージが表示されたら、［保存（Save）］選択します。

最後に、Webhookをオンにします。セグメントで［宛先］に移動し、次の操作を行います。

1. ［マッピング］タブを開きます。
2. ［ステータス（Status）］列で［有効化済み（Enabled）］を選択します。
3. ［設定］タブを開きます。
4. ［宛先を有効化（Enable Destination）］をオンにします。
5. ［変更を保存（Save changes）］を選択して設定を完了します。

特定（Identify）

特定スペックでは、ユーザーを行動に結びつけて、その人の特徴を記録できます。ユーザーを特定すると、セグメントはそのユーザーの情報をuserId（Pendoの訪問者ID）とともにPendoに渡します。ユーザーの特徴は、Pendoで訪問者メタデータにマッピングされます。

注：PendoがアカウントIDをユーザーに関連付けるためには、特徴の下にgroupIdを追加する必要があります。groupIdを含めない場合、Pendoで空のアカウントが作成されます。また、ここでgroupIdを追加しても、アカウントのメタデータは作成されません。アカウントのメタデータの関連付けについては、次のセクションを参照してください。

詳しくは セグメントの特定（Identify）スペック をご覧ください。

グループ（Group）

グループスペックでは、個々のユーザーをユーザーの「グループ」と関連付けることができます。Pendoは「グループ」とアカウントを関連付けます。グループを呼び出すと、セグメントはgroupIdを、アカウントIDとしてPendoに送信します。グループの特徴は、Pendoでアカウントメタデータにマッピングされます。そのため、Pendoアカウントデータを使用する場合は、グループコール（フィールドgroupID と 特徴）が必要です。

詳しくはセグメントのグループスペックをご覧ください。

追跡（Track）

追跡スペックでは、ユーザーが行ったアクションを、そのアクションを表すプロパティとともに記録できます。追跡を呼び出すと、Pendoのトラックイベントとして送信されます。

セグメントインテグレーションでトラックイベントを使用するには、セグメント内でPendoとWebhookの両方の宛先を追加します。

Pendoのトラックイベントの詳細については、トラックイベントのヘルプ記事 をご覧ください。

モバイル

セグメントインテグレーションは、元々ウェブエージェントを想定して設計されています。しかし、セグメントから送られてくるモバイルイベントをトラックイベントとしてサーバー側のWebhookで受け取ることができます。現在、セグメントの「スクリーン（Screen）」呼び出しには対応していません。

セグメントのソースとしてのPendo

この記事では、Pendoをセグメントの宛先として設定する方法をすべて説明しています。Pendoをセグメントのソースとして設定する方法の詳細については、Webhookの記事を参照してください。