Segmentと独立したSDK連携を設定

SegmentはAdjustのアナリティクスパートナーです。この連携設定により、Adjust SDKとSegment SDKはそれぞれ独立して動作するようになります。このソリューションを使用すると、ディープリンクをはじめとするAdjust SDKの追加機能を簡単に実装することができます。

計測の仕組み

Adjust SDKとSegment SDKが独立して動作するときにユーザーアクティビティが記録される仕組みは、以下の通りです。

  1. アプリがAdjust SDKを直接初期化します。
  2. Adjust SDKは自動的にインストール、セッション、リアトリビューションを記録します。
  3. Segment SDKはイベントを記録し、Segmentサーバーはそれらをサーバー間イベントとしてAdjustサーバーにクラウドモードで送信します。
  4. AdjustサーバーはインストールコールバックをSegmentサーバーに送信します。Segmentは、インストールコールバックをInstall Attributedと呼ばれるtrackイベントとして記録します。

連携の設定

独立したAdjust SDKソリューションをSegmentで設定するには、以下の手順に従ってください。

1. Adjust SDKとSegment SDKを設定する

Adjust SDKとSegment SDKを設定する方法の手順については、プラットフォームの開発者ガイドに従ってください。

📖 iOS / Android

2. AdjustでSegmentを有効化する

AdjustでSegmentを設定するには、次の手順に従ってください。

WRITE KEYを確認する方法は、Segmentのドキュメントをご覧ください。

Segmentはインストールアクティビティのコールバックを受信するようになります。

3. SegmentにAdjust destinationを作成し、Adjustのアプリトークンを追加する

SegmentダッシュボードにAdjustをdestinationとして追加するには、以下の手順に従ってください。

  1. Destinations > Add Destination​ を選択します。
  2. Adjustを検索します。
  3. Adjust​ をソースのdestinationとして追加します。

AdjustアプリトークンをSegmentのAdjust destinationに追加するには、以下の手順に従ってください。

  1. Destination​ を選択して、Adjust destinationを選択します。
  2. アプリトークン(App Token)​ を選択し、AppViewから取得したアプリトークンを入力します。
  3. 保存(SAVE)​ を選択します。

Adjustでのアプリ設定に基づいて、Adjust destinationをソースに関連付ける方法については、以下の表を参照してください。

使用されるセグメントSDKAdjustアプリの設定SegmentダッシュボードでのAdjust destination
Segment Android SDKおよびSegment iOS SDKマルチプラットフォームアプリ(iOSアプリとAndroidアプリで同じアプリトークン)
  1. Adjust destinationをiOSソースおよびAndroidソースにそれぞれ追加します。
  2. 同じAdjustトークンを使用して、両方のdestination先を設定します。
Segment Android SDKまたはSegment iOS SDK異なるアプリトークンを使用するiOSアプリまたはAndroidアプリ
  1. 適用できる場合は、Adjust destinationを各ソースに追加します。
  2. 各destinationにそれぞれのAdjustトークンを設定します。
Segment React Native SDKマルチプラットフォームアプリ(iOSアプリとAndroidアプリで同じアプリトークン)
  1. Adjust destinationをReact Nativeソースに追加します。
  2. アプリトークンを使用してdestinationを設定します。
Segment React Native SDK異なるアプリトークンを使用するiOSアプリおよびAndroidアプリ
  1. iOS向けおよびAndroid向けのdestinationをそれぞれReact Nativeソースに追加します。
  2. 各destinationにそれぞれのAdjustトークンを設定します。

4. Adjustでイベントトークンを作成

Segmentダッシュボードでイベントを確認し、Adjustにリンクするイベントを決定します。

AdjustにリンクしたいSegmentのtrackコール全てに、対応するAdjustイベントトークンを作成してイベントトークンをコピーします。

警告:

このソリューションはパートナーパラメーターをサポートしていません。ただし、特定の値をAdjust SDKにパスするには、セッションパートナーパラメーターが必要です。プラットフォームの開発者向けドキュメントをご覧ください。


📖 iOS / Android


カスタムパラメーターを使用してネットワークにイベントを送信する必要がある場合は(例:動的リターゲティングをサポート)、これらのイベントをSegment SDKとAdjust SDKで別々に設定します。これらのイベントを、SegmentダッシュボードでAdjust destinationにリンクしないでください。

5. AdjustイベントトークンをSegmentに入力します

  1. Segmentダッシュボードで、 Destinations​ を選択し、Adjust destinationを選択します。
  2. Map Your Events to Custom Adjust Event Tokens​ を選択して、Adjustダッシュボードでコピーしたイベントトークンを入力します。
    Segmentの全てのtrackイベント名は、Adjustイベントトークンと1:1の関係を持っている必要があります。異なる名前のSegmentのtrackコールを、同じAdjustイベントトークンにリンクしないでください。
  3. 保存(SAVE)​ を選択します。

6. Segmentで追加の設定を行います

  1. Segmentダッシュボードで、 Destinations​ を選択し、Adjust destinationを選択します。

  2. Track Attribution Data​ の設定を ON​ にします。

  3. Send Event Creation Time​ の設定を見つけ、適切なオプションを選択します。

    • ON​ - Segmentはサーバー間イベントでcreated_at_unix時刻をパスします。ただし、Segmentではイベントがcreated_at_unixに従って発生順に送信されることが保証されないため、Adjustサーバーはおそらく一部のイベントを拒否します。
    • OFF​ - Segmentはサーバー間イベントでcreated_atパラメーターをパスしません。Adjustサーバーは発生順の理由でイベントを拒否しません。その代わり、received_atタイムスタンプに等しいcreated_atタイムスタンプを内部で設定します。つまり、created_atタイムスタンプは、デバイスがSegment SDKでイベントを実際にトリガーした時刻を示していない場合があることを意味します。
  4. 画面の上部にあるのはAdjustの設定です。スイッチを ON​ にしてdestinationを有効化します。

本番用(production)で実装をローンチする準備ができたら、 Send to Production Environment on Adjust​ 設定を ON​ にします。

A screenshot from the Segment dashboard of how to configure your Adjust settings.

Segmentに転送されるパラメーター

SegmentへのAdjustのコールバックで送信されるパラメーターのリストは以下の通りです。

プレースホルダー情報
[anonymous_id]Segmentのanonymous_id
{adgroup_name}リンクから取得したアドグループ名
{campaign_name}リンクから取得したキャンペーン名
{creative_name}リンクから取得したクリエイティブ名
{network_name}リンクから取得したネットワーク名
{tracker_name}現在のリンク名