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)に関するスペックをサポートしています。使用したいスペックに応じた設定を行ってください。

注: Segmentの設定でPendo APIキーを追加する必要があります。Pendo APIキーを確認するには、Pendoアプリケーションにサインインし、[設定(Settings)]>[サブスクリプション設定(Subscription Settings)]と進み、該当するアプリのアイコンにカーソルを合わせ、[アプリの詳細を見る(View App Details)]> [インストール設定(Install Settings)]を選択します。APIキーは[アプリの詳細(App Details)] タブのテーブルにあります。

特定とグループ化

[Segmentの送信先(Segment Destinations)]ページで[Pendo]を選択し、Pendo APIキーを入力します。

追跡とサーバー側データ

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

[Segmentの送信先(Segment Destinations)]ページで検索し、新しい送信先として[Webhook]を、ソースとして[Javascript]を選択します。次のWebhook URLを使用し、設定を終了します。

US:https://data.pendo.io/data/segmentio/YOUR_PENDO_API_KEY

EU:https://data.eu.pendo.io/data/segmentio/YOUR_PENDO_API_KEY

YOUR_PENDO_API_KEYを実際のPendo APIキーに置き換えてください。

Webhookの設定では、ヘッダーは不要です。URLの追加が完了したら、変更を保存します。

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

特定(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の両方の宛先を追加します。

[Segmentの送信先(Segment Destinations)]ページで検索し、新しい宛先として[Webhook]を、ソースとして[Javascript]を選択します。次のWebhook URLを使用し、設定を終了します。

US:https://data.pendo.io/data/segmentio/YOUR_PENDO_API_KEY

EU:https://data.eu.pendo.io/data/segmentio/YOUR_PENDO_API_KEY

YOUR_PENDO_API_KEYを実際のPendo APIキーに置き換えてください。

Webhookの設定では、ヘッダーは不要です。URLの追加が完了したら、変更を保存します。Pendoのトラックイベントの詳細については、トラックイベントのヘルプ記事 をご覧ください。

モバイル

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

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

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