セグメント

Segmentを使用すると、グロース、プロダクト、マーケティングの各スタックにわたってデータを管理したり、サービスとの連携をしたりできます。SegmentのAPIとライブラリを通じてイベントとユーザーを追跡することで、最小限の実装で製品データをすべての分析およびマーケティングプラットフォームに送信できます。Segmentは、iOS、Android、JavaScript、Node.js、PHPなど、ほとんどのプラットフォームをサポートしています。

このガイドは、SegmentのAmplitude（アクション）ドキュメントを補完するものです。 これには、連携がAmplitudeのデータに与える影響についての詳細と、連携を設定するための手順が記載されています。

連携を設定する

Amplitudeにデータを送信するには、以下のことができます：

• AmplitudeのSDKをインストールし、クライアント側にバンドルされている統合を使用してデータを直接Amplitudeに送信します。
• Segmentの送信先を設定し、それをSegmentのソースと接続します。

セグメントの宛先を設定する

Amplitude APIキーを使用して以下の手順に従ってください。

Segment が Amplitude にデータを送信できるようにするには、Segment の Amplitude 送信先が Segment ソースのいずれかに接続されていることを確認してください：

• Segmentワークスペースで、Connections -> Sources をクリックします。
• Amplitudeの送信先のステータスが有効に設定されていることを確認して、SegmentがAmplitudeにデータを送信できるようにします。

Segmentソースにデータを送信し、Amplitudeでイベントを検証します。

クライアント側のバンドル連携

Segmentのライブラリに加えて、AmplitudeのSDKをインストールすることもできます。 この場合、Segmentのライブラリはデータ収集をAmplitudeのSDKに委任し、SDKはその後、そのデータをAmplitudeのサーバーに送信します。

クライアント側のバンドルアプローチには長所と短所があります。 利点の1つは、AmplitudeのネイティブSDKを追加することで、セッション追跡機能とユーザープロパティの自動追跡が追加されることです。

• Amplitudeは、Amplitudeダッシュボードでそのユーザーのストリームを表示するときに、同じユーザーセッション中に記録されたイベントをグループ化します。 これにより、セッション時間の計算も可能になります。
• SDKは、デバイスの種類、オペレーティングシステム、ユーザーエージェントなど、いくつかのユーザープロパティを自動的に記録します。AmplitudeのSDKによって自動的に追跡されるユーザープロパティのリストについては、ユーザープロパティ定義を参照してください。
• セッションイベントの追跡を有効にすると、SDK がユーザーのモバイルセッションの開始と終了をマークする Start Session および End Session イベントを自動的に送信できるようになります。
• AmplitudeのSDKをインストールすると、それらと直接やり取りできます。 詳細については、iOS SDK および Android SDK のドキュメントを参照してください。

SDKを増やすとアプリケーションのサイズが増えることに注意してください (それぞれ 200 kB 未満です)。アプリで複数のライブラリをすでに使用している場合は、この問題を考慮する必要がある場合があります。これらのSDKはオプションです。Segmentのライブラリのみを使用することで、Amplitudeでもほぼ同じ分析を実行できます。

セッション追跡なしの場合：

• イベントのセッションIDは-1であるため、同じセッション中にユーザーがトリガーしたイベントは、Amplitudeでそのユーザーのタイムラインを表示するときに一緒にグループ化されません。
• Amplitudeではセッション時間の計算は使用できないため、ユーザーセッションチャートにはデータが表示されません。
• Amplitudeのパスファインダーおよびパスファインダーユーザーチャートでは、セッション内のイベントとセッション外イベントを同時に表示することはできません。
• セッションベースのファネル分析を効果的に実行することはできません。

AmplitudeのSDKがない場合、デバイスタイプやオペレーティングシステムなどのユーザープロパティを手動でマッピングして追跡する必要があります（Segmentのドキュメントに記載されています）。

Segment Sourceを設定する

Segmentにデータを送信するためにSegment Sourceを設定します。

JavaScript（クライアント側）

SegmentのAnalytics.jsクイックスタートガイドに従って、スニペットをウェブサイトに貼り付けます。スニペットにSegmentの書き込みキーを入れることを忘れないでください。

これで、track と identify を使用してユーザーを追跡する準備が整いました。また、Analytics.jsはAmplitudeのJavaScript SDKをお客様のウェブサイトに自動的にインストールするため、JavaScript SDKに直接アクセスできます。

実装を変更することなく、Segment Amplitude連携パネルの詳細設定でJavaScript連携の設定を構成できます。

• バッチイベント(デフォルトはfalse):trueの場合、イベントを30個のバッチ単位または30秒ごとに送信できます。これら 2 つのしきい値は、［Event Upload Threshold］ および ［Event Upload Period Millis］ の値を変更することで調整できます。
• Track All Pages to Amplitude、Track Categorized Pages to Amplitude、および Tracking Named Pages to Amplitude（デフォルトは false）：true の場合、pageを呼び出すと Viewed ___ Pageイベントが生成されます。これら3つのオプションのうち、一度に2つ以上を選択した場合、1回のpage呼び出しで複数のイベントが生成されます。
• Amplitudeへのリファラーの追跡（デフォルトではfalse）：trueの場合、Amplitudeはユーザーのリファラー、最初のリファラー、およびリファラードメインをユーザープロパティとしてキャプチャします。
• UTMプロパティを追跡（デフォルトはfalse）：trueの場合、AmplitudeはURLパラメータまたはCookieからUTMプロパティをユーザープロパティとして取得します。

iOS（クライアント側）

SegmentのiOSクイックスタートガイドに従ってください。CocoaPodsを使用してアナリティクスポッドをインストールし、SEGAnalytics.hヘッダーファイルをインポートし、iOSアプリでSegmentのライブラリを初期化します。

これで、呼び出しを開始したり、アプリ内のユーザーを追跡したりtrackできるようになりましたidentify。また、AmplitudeのiOS SDKをSegmentのライブラリと一緒にインストールすることで、より多くのトラッキング機能を追加することもできます。 AmplitudeのSDKを追加することの長所と短所は、クライアント側のバンドル連携に反映されています。Amplitude SDKを追加することを選択した場合、以下の手順に従ってください。

1. 2つ目のポッド「Segment-Amplitude」を CocoaPods にインストールします: pod 'Segment-Amplitude'。

2. Objective-Cを使用している場合は、Segment SDKを初期化したファイルにこの2番目のヘッダーを追加してください:#import <Segment-Amplitude/SEGAmplitudeIntegrationFactory.h>。

3. Swiftを使用していてuse_frameworks!設定済みの場合は、Segment SDKを初期化したファイルにこの2番目のヘッダーを追加してください:#import <Segment\_Amplitude/SEGAmplitudeIntegrationFactory.h>。

4. AmplitudeのSDKをSegmentのSDKに登録してください（SegmentのSDKを初期化する前にこれを行ってください）:

   obj-c

   コピー

   [configuration use:[SEGAmplitudeIntegrationFactory instance]];
   [SEGAnalytics setupWithConfiguration:configuration];
   

コード例については、Segment iOSデモコードを参照してください。

Android（クライアント側）

Segment の Android クイックスタートガイドに従ってください。 Gradleを使用してSegmentのライブラリをインストールし、Androidアプリでアナリティクスクライアントを初期化します。また、Android マニフェストファイル内のアプリのアクセス許可を更新する必要がある場合もあります。

これで、呼び出しを開始したり、アプリ内のユーザーを追跡したりtrackできるようになりましたidentify。また、AmplitudeのAndroid SDKをSegmentのライブラリと一緒にインストールすることで、より多くのトラッキング機能を追加することもできます。 AmplitudeのSDKを追加することの長所と短所は、クライアント側のバンドル連携に反映されています。Amplitude SDKを追加することを選択した場合、以下の手順に従ってください。

1. build.gradleファイルに以下を追加します： compile 'com.segment.analytics.android.integrations:amplitude:+'。

2. Segment SDKを初期化するファイルに、以下を追加します：import com.segment.analytics.android.integrations.amplitude.AmplitudeIntegration;。

3. Amplitudeの連携をSegmentのSDKに登録してください。アナリティクスオブジェクトを構築する際には、.build() の前に .use(AmplitudeIntegration.FACTORY) を追加してください。これは次のようになります：

   java

   コピー

   Analytics analytics = new Analytics.Builder(this,"KEY").use
   (AmplitudeIntegration.FACTORY).build();
   Analytics.setSingletonInstance(analytics);
   

コード例については、Androidのデモコードを参照してください。

サーバーサイドおよびその他のライブラリ

Segmentのドキュメントに記載されている適切な指示に従ってください。

SegmentとAmplitude SDKの機能間のマッピング

SegmentとAmplitudeは、同じ概念を表すのにわずかに異なる用語を使用しています。次の表は、この2つの間のマッピングを示しています。

詳細については、セグメントのドキュメントを参照してください。

セグメントにコホートをエクスポート

Amplitude Activationを使用すると、行動オーディエンスを広告ネットワーク、マーケティング自動化ツール、パーソナライゼーションエンジンに自動的に送信できるため、キャンペーンやプロダクト体験をより適切にカスタマイズできます。

詳細については、「セグメントにコホートを送信する」を参照してください。

その他のヘルプ

Segmentサポート（friends@segment.com）またはAmplitude サポートまでお問い合わせください。