Adjust SDKとSegment SDKを連携させるには、以下のいずれかの方法に従ってください。
-
独立したSDKソリューション - Adjust SDKはSegment SDKと独立して動作します。このソリューションを使用すると、ディープリンクなどの追加のAdjust SDK機能の実装が簡単になります。
AdjustおよびSegmentの各ダッシュボードでこの連携を設定する方法については、Segmentと独自した連携を設定をご覧ください。
-
ラップされたSDKソリューション - Segment SDKがAdjust SDKをラップし、アプリ内で最小限の作業で両方を接続することができます。これにより、Segment SDKでAdjust SDKを利用可能な状態にし、AdjustとSegmentがそれぞれのシステムでイベントを計測するようにします。このソリューションはSDKイベントを使用するため、SKAdNetworkの最適化に有効に機能します。
AdjustおよびSegmentの各ダッシュボードでこの連携を設定する方法については、SegmentとのSDK間連携を設定をご覧ください。
両方のソリューションを使用して、Segmentダッシュボードでイベントを定義する必要があります。
これらのソリューションではパートナーパラメーターはサポートされていません。カスタムパラメーターを使用してネットワークにイベントを送信する必要がある場合は(例:動的リターゲティングをサポート)、これらのイベントをSegment SDKとAdjust SDKの両方で設定します。これらのイベントを、SegmentダッシュボードでAdjust destinationにリンクしないでください。
独立したSDKソリューションの設定
1. Segment SDKを設定する
Segment SDKで、APIコールイベントの計測を定義します。各イベントは単一のユーザーアクションを記録します。Segment SDKは、クラウドモード(Cloud Mode)でAdjust SDKに対応するイベント計測コールを作成します。
-
Segment iOS SDKを実装します。
track
ペイロードでは、.context.device.id
または.context.device.type
をパスしないでください。Segment SDKは、これらのアトリビュートを自動的にデバイスから受け取ります。これらのアトリビュートを手動でパスすると、実装に問題が発生する可能性があります。 -
アプリで計測したい各イベントに対して
track
コールを作成します。- オプション:カスタムキー値のペアを
properties
オブジェクトにパスできます。Segment SDKは、これらのプロパティをコールバックパラメーターとしてAdjust SDKのイベント計測コールにパスします。Adjustのパートナーパラメーターはサポートされません。
- オプション:カスタムキー値のペアを
2. Adjust SDKの設定
- Adjust Android SDKをアプリに実装します。
- 以下のパラメーターをセッションパートナーパラメーターとしてAdjust SDKにパスします。これらのパラメーターをインストールまたはセッション開始時に使用できるようにするには、SDKの起動開始を遅延させる必要があります。
anonymous_id
- AdjustがSegmentにコールバックを送信するために必要です。Segment SDKからanonymous_id
の値を取得できます。- オプション:
user_id
- これはお客様のシステムから取得できるようにするために定義する値です。
ラップされたSDKソリューション
Adjust SDKを直接アプリに実装しないでください。すでにAdjust SDKを直接実装した場合、アプリから削除してください。
Segment SDKがAdjust SDKを初期化します。次にAdjustは、インストールおよび/またはセッションを自動的に記録します。アプリはその後、Segment SDKでtrack
コールを作成します。これにより、デバイスモード(Device Mode)でAdjust SDKに対応するイベント計測コールを作成します。Segmentは デバイスモード(Device Mode) を使用しているときでも、イベントを クラウドモード(Cloud Mode) で送信することがあります。これは既知の問題です。これにより、Adjustは多くの場合に同じイベントトークンで、Adjust SDKとサーバー間連携からイベントを受け取ることになります。
- Segment iOS SDKを実装します。
- Segment SDKにAdjustの実装を追加します。
- 追加のiOSフレームワークをアプリに追加します。
- アプリで計測したい各イベントに対して
track
コールを作成します。- オプション:カスタムキー値のペアを
properties
オブジェクトにパスできます。Segment SDKは、これらのプロパティをコールバックパラメーターとしてAdjust SDKのイベント計測コールにパスします。Adjustのパートナーパラメーターはサポートされません。
- オプション:カスタムキー値のペアを
ディープリンクなど、Segment SDKでサポートされていないAdjust SDKの追加機能を実装したい場合は、Segmentのドキュメントをご覧ください。