メインコンテンツまでスキップ

Adjustデータ統合ソリューション

最終更新 2026/10/05

最終更新日:2023-03-24

1. 統合プランの紹介​

ヒント

サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください

概要​

本記事では、AdjustのデータをAgentic Engine(以下、AEシステム)にコールバックする方法を説明します。本プランは次に対応しています:

  • リアルタイムコールバック機能でローデータを送信する場合は、AEシステムのユーザー識別ルールを読み、AEが#distinct_idと#account_idによってユーザーを識別する仕組みを理解しておいてください。
  • Report Serviceで集計結果を取得する場合は、AEシステムのデータルールを読み、AEのデータ構造を理解しておいてください。また、データの取得に必要な情報を担当のカスタマーサクセスマネージャーにお渡しいただくことをお勧めします。形式はデータ統合設定情報テンプレートを参考にしてください。

流れ​

  • リアルタイムコールバックプランを使用する場合は、次の流れでデータを統合してください:
  1. AdjustクライアントSDKとAEクライアントSDKを統合し、Adjust SDKでAEのユーザー識別IDを設定し、AE SDKでAdjust IDおよびAndroid ID / IDFA / Web UUIDを設定します(Adjust SDKでカスタムの登録/キャラクター作成イベントを送信することをお勧めします)
  2. Adjustの管理画面で、グローバルコールバック(Global callback)または単一イベントコールバック(Single event callback)を設定します
  3. ThinkingAIの担当者が、ユーザーデータの遡及関連付けを含むデータ取得の開発作業を行います
  4. AE管理画面でダッシュボードやレポートを作成し、データ検証を完了します
  • Report Serviceで集計データをコールバックする場合は、次の流れで進めます:
  1. Adjust管理画面でAdjust User Token(API Token)とAdjust App Tokenを取得し、これらの情報をThinkingAIの担当者に提供します
  2. 取得するデータのディメンション、指標タイプ、時間範囲、時間粒度を決めます
  3. ThinkingAIの担当者がデータ取得の開発作業を行います
  4. AE管理画面でダッシュボードやレポートを作成し、データ検証を完了します

2. リアルタイムコールバックプラン​

インターフェース名APIタイプ製品化データ粒度アトリビューションデータコストデータ収益データインプレッションクリックコンバージョン
リアルタイムコールバックプッシュ型はいユーザーレベルはいはいはい

Adjustは、一連のイベントのリアルタイムコールバック機能を提供しています。Adjust管理画面でコールバックするデータタイプを選択し、AEシステムのコールバックリンクをコールバックURLに設定すると、ユーザーレベルの詳細データをコールバックできます。

2.1 クライアントSDKの設定​

2.1.1 ユーザーIDの設定​

方法1(自動関連付け):

ヒント

統合しているAE SDKのバージョンが2.8.0~2.8.1の場合は、このプランをそのまま使用できます

統合しているAE SDKのバージョンが2.8.2以上の場合は、サードパーティデータプラグインもインストールする必要があります

詳しくはAndroid SDKのサードパーティデータとiOS SDKのサードパーティデータを参照してください

// AE SDKを初期化
ThinkingAnalyticsSDK instance = ThinkingAnalyticsSDK.sharedInstance(this, TA_APP_ID, TA_SERVER_URL);
// Adjust IDの関連付けを有効化
instance.enableThirdPartySharing(TDThirdPartyShareType.TD_ADJUST);

// Adjust SDKを初期化
// ...

// 登録またはキャラクター作成後、loginを呼び出してアカウントIDを設定したら、再度データを同期する必要があります(任意)
instance.login("account_id");
instance.enableThirdPartySharing(TDThirdPartyShareType.TD_ADJUST);

この方法の仕組みは、内部でAdjust SDKのaddSessionCallbackParameter()メソッドを自動的に呼び出し、AEプロジェクトのゲストIDとアカウントIDを渡すというものです。

方法2:

この方法では、Adjust SDKのaddSessionCallbackParameter()メソッドを手動で呼び出して、AEプロジェクトのゲストIDとアカウントIDを設定します。

// AEのゲストIDを取得(AEの#distinct_idに対応)
String distinctId = ThinkingAnalyticsAPI.GetDistinctId();
// お客様のアカウントID(またはキャラクターID)。AEの#account_idに対応
String accountId = "{your_account_id}";

Adjust.addSessionCallbackParameter("ta_distinct_id", distinctId);
Adjust.addSessionCallbackParameter("ta_account_id", accountId);

// Adjust SDKを初期化
// ...
ヒント

AEのユーザーIDを正常に取得できるよう、Adjust SDKでaddCallbackParameterを使用してAEのアカウントIDとゲストIDを再度送信しないでください

2.1.2 登録またはキャラクター作成イベントの設定(任意)​

ユーザーの紐付け関係が想定どおりになるよう、AE SDKで設定したアカウントIDのタイプに応じて、カスタムイベントを1つ設定してください:

  • アカウントIDがユーザーのアカウントIDの場合:ユーザーがアカウントを作成したときにAdjust SDKで送信します
  • アカウントIDがキャラクターID(ゲーム業界)の場合:ユーザーがキャラクターを作成したときにAdjust SDKで送信できます

2.1.3 Web側の設定方法​

Web側とモバイル側は違いが大きいため、Adjust Web SDKで次のコードによりweb_uuidを取得し、AE SDKで送信してユーザープロパティとして設定する必要があります:

const webUUID = Adjust.getWebUUID();

次に、後でコールバックリンクを設定する際に、{web_uuid}プレースホルダーを使用してコールバックし、AEプロジェクトのユーザーデータと関連付けられるようにします。

2.2 コールバックリンクの設定​

クライアントSDKの設定が完了したら、次にAdjust管理画面でリアルタイムコールバックインターフェースを設定します。これにより、Adjustのユーザー粒度の詳細データを受け取れるようになります。

2.2.1 コールバック方法の選択​

Adjustでは、グローバルコールバックを設定することも、単一イベントコールバックを設定することもできます。広告収入(Ad revenue)イベントはグローバルコールバックに対応していないため、コールバックするイベントごとに個別に設定することをお勧めします。

以下は、Adjustがコールバックに対応しているイベントと、統合をお勧めするイベントです:

イベント表示名イベント名統合推奨
表示impressions
クリックclicks
インストールinstallはい
広告収入(広告収入パッケージ)ad revenue (with Ad Revenue package)はい
広告支出ad spend
会話sessions
アプリイベントapp events必要に応じて統合
再アトリビューションreattributions
アンインストールuninstalls
再インストールreinstalls
再アトリビューションによる再インストールreattribution reinstalls
アトリビューションの更新updated attributions
削除済みユーザー (GDPR)erased users (GDPR)
SANクリックSAN clicks
SAN表示SAN impressions
SKAdNetworkインストールSKAdNetwork installs
SKAdNetworkイベントSKAdNetwork events
サブスクリプションsubscriptions
ATTステータスの更新 (iOS)ATT status updates (iOS)
拒否されたインストールrejected installs
拒否された再アトリビューションrejected reattributions

2.2.2 コールバックリンクの設定​

コールバックが必要なすべてのイベントを記録してデータ統合設定情報テンプレートに明記し、テンプレートをThinkingAIの担当者に送信することをお勧めします。ThinkingAIの担当者から、各イベントに対応するコールバックリンクが送られます。コールバックアドレスを下図の赤枠の位置に順に設定してください。

2.2.3 コールバックプレースホルダーの設定​

コールバックプレースホルダーは、コールバックリンクの中でコールバックするパラメータを指定するための式で、通常は{}で囲みます。たとえば{campaign_name}プレースホルダーは、コールバックデータにcampaign_nameの値が含まれることを意味します。コールバックデータによって対応しているプレースホルダーは異なります。詳しくはAdjustプレースホルダーの説明ドキュメントを参照してください。追加が必要な場合は、上記のドキュメントから追加するプロパティを探し、データ統合設定情報テンプレートに明記してください。

2.3 データの格納ルール​

デフォルトでは、取得したデータをイベントとしてAEプロジェクトに書き込みます。コールバックデータ1件につき、イベントデータを1件書き込みます:

  • データ内のta_distinct_idとta_account_idをAEプロジェクトのユーザー識別IDとして使用します
  • データ内のcreated_at_milliフィールドをイベントの#event_timeとして使用します。created_at_milliが存在しない場合は、created_atの値を#event_timeとして使用します
  • データのイベント名は、Adjustのイベント名にプレフィックスadjust_を付けたものです(例:impressionイベントは格納後にadjust_impressionになります)
  • コールバックリンクで設定したその他のフィールドはすべて格納されます

デフォルトでは、データ内のta_distinct_idとta_account_idを取得できない場合、そのデータは無効なデータとみなされ、そのまま破棄されます。これらのデータを保持したい場合は、ThinkingAIの担当者に連絡して設定してください。これらのデータはイベントテーブルに記録され、ゲストIDは固定値 -- "without_id"になります。また、これらのデータはユーザープロパティとして格納されません

impression、click、Ad spendのコールバックデータには、AEプロジェクトのユーザー識別IDが含まれていません。このようなデータを統合したい場合、AEシステムはこれらのデータを自動的に1人の「仮想ユーザー」に紐付けます。

さらに、これらのイベントにユーザーを識別できるフィールド(adjust_idとAndroid ID/IDFA、またはweb_uuidなど)があり、ユーザープロパティにも対応するフィールドがある場合は、ThinkingAIの担当者がデータ遡及の方法で、これらのイベントを定期的にAEユーザーに関連付けることができます

データタイプ説明AEに格納後のイベント名イベントの仮想ユーザー
impression露出adjust_impressionadjust_impression_vu
clickクリックadjust_clickadjust_click_vu
cost_updateコストadjust_cost_updateadjust_cost_update_vu

3. Report Service API​

Adjustのユーザーレベルのデータ(リアルタイムコールバックインターフェース)にはセルフアトリビューションネットワーク(Google、Facebookなど)のコストデータが含まれないため、Report Serviceでプラットフォーム全体の集計コストデータを取得できます。

詳しいドキュメントは次を参照してください:https://help.adjust.com/zh/article/reports-endpoint

インターフェースの基本情報

インターフェース名APIタイプ製品化データ粒度アトリビューションデータコストデータ収益データインプレッションクリックコンバージョン
Report Service APIプル型いいえ集計データはいはいはいはいはい

3.1 統合前の準備​

次のパラメータを取得し、ThinkingAIの担当者に送信してください:

  • Adjust User Token(ユーザーのAPI Token)
    • Adjust管理画面でAPI Tokenを取得できます。管理画面の左上のメニューをクリックして「アカウント情報」を選択し(管理者ユーザーの場合は「マイアカウント」を選択し、「あなたのデータ」タブで「ユーザー詳細」を見つけて、下部の歯車ボタンをクリックします)、次に「API識別子」をクリックすると、API Tokenを取得できます
  • Adjust App Token
    • Adjust管理画面で、統合するアプリのApp Tokenを取得できます

3.2 データの取得​

3.2.1 分析ディメンション​

以下は、Report Serviceが対応している分析ディメンションです。時間粒度(1つのみ選択可能)とグループ化ディメンション(複数選択可能)が含まれます

  • 時間粒度
ディメンションデータタイプ説明例デフォルトかどうか

hour

日付ISO形式の日付値:YYYY-MM-DDTHH:MM:SS

2021-05-11T17:00:45

day日付日付値の形式:YYYY-MM-DD2021-05-11はい
  • グループ化ディメンション
ディメンションデータタイプ説明例デフォルトかどうか

os_name

文字列

OS

値:android、Bada、blackberry、iOS、Linux、Mac OS、server、symbian、unknown、WebOS、Windows、windows-phoneはい

device_type

文字列デバイスタイプ値:bot、console、iPod、Mac、PC、phone、server、simulator、tablet、TV、unknownはい
app文字列アプリ名-はい
app_token文字列AdjustでのアプリID-はい
store_id文字列ストアのアプリIDcom.random.appはい
store_type文字列アプリのインストール元ストアgoogle_playはい

app_network

文字列アプリ識別子

形式:<store_type>:<store_id>

例:google_play:com.random.app

はい
currency文字列通貨Euroはい
currency_code文字列3文字のISO 4217通貨コードEURはい

network

文字列広告チャネルの名前値:Organic, AppLovin, Facebook Installs, Instagram Installs
campaign文字列キャンペーン名とIDを含む-はい
campaign_network文字列チャネルのキャンペーン名-はい
campaign_id_network文字列チャネルのキャンペーンID-はい
adgroup文字列広告グループ名とIDを含む-はい
adgroup_network文字列チャネルの広告グループ名-はい
adgroup_id_network文字列チャネルの広告グループID-はい
source_network文字列チャネルに基づく任意の値。通常はadgroup_networkと同じ-はい
source_id_network文字列source_appの値-はい
creative文字列クリエイティブ名とIDを含む-はい
creative_network文字列チャネルのクリエイティブ名-はい
creative_id_network文字列チャネルのクリエイティブID-はい
country文字列国/地域名United States of Americaはい
country_code文字列2文字のISO 3166国/地域コード

US

はい
region文字列ビジネス地域APACはい
partner_name文字列Adjustシステムでのパートナー名AppLovinはい
partner_id文字列Adjustシステムでのパートナー ID34はい

3.2.2 対象指標​

Report Serviceは非常に多くの指標に対応しているため、本節では一部のよく使われる指標のみを示します。詳細な指標リストはAdjust公式ドキュメントで確認できます。取得する指標をカスタマイズする必要がある場合は、データ統合設定情報テンプレートに明記してください

  • コンバージョン指標
フィールド定義数式フィールド名デフォルトかどうか
平均DAUs選択した期間の平均デイリーアクティブユーザー数(D0 DAU + D1 DAU + DAY N DAU) / 選択した期間の日数dausはい
平均MAUs選択した期間の平均MAU(M0 MAU + M1 MAU + MONTH N MAU) / 選択した期間の月数mausはい
平均WAUs選択した期間の平均WAU(W0 WAU + W1 WAU + WEEK N WAU) / 選択した期間の週数wausはい

基本Sessions数

ユーザーのsessions数(インストールと再アトリビューションを除く)-base_sessionsはい
クリック数トラッキングされたクリック数-clicksはい
クリック数 (チャネル)チャネルAPIから報告されたクリック数-network_clicksはい
クリックコンバージョン率 (CCR)インストール数とクリック数の比率インストール数 / クリック数click_conversion_rateはい
クリック率(CTR)クリックと露出の割合クリック数 / 露出数ctrはい
アトリビューション解除アトリビューション解除が発生した回数-deattributionsはい
GDPRの忘れられる権利を行使したユーザー数EU GDPRの忘れられる権利を行使したユーザー数。Adjustはこれらのユーザーの個人データを永久に削除します-gdpr_forgetsはい
露出数トラッキングされた広告露出数-impressionsはい
露出数 (チャネル)チャネルAPIから報告された広告露出数-network_impressionsはい
インストール露出比インストール数と露出数の割合インストール数 / 露出数impression_conversion_rateはい
インストール数トラッキングされた、アプリをインストールしたユーザー数-installsはい
インストール数 (チャネル)チャネルAPIから報告されたインストール数

-

network_installsはい
インストール差異数インストール数と、チャネルAPIから報告されたインストール数の差インストール数 - インストール数 (チャネル)network_installs_diffはい
1000回表示あたりのインストール数 (IPM)広告表示1000回あたりに発生したインストール数1000 * 表示コンバージョン比installs_per_mileはい
トラッキング制限デバイスのインストール数トラッキング制限 (LAT) を有効にしたデバイスのインストール数-limit_ad_tracking_installsはい
トラッキング制限デバイスのインストール割合トラッキング制限デバイスのインストール数とインストール数の比率トラッキング制限デバイスのインストール数 / インストール数limit_ad_tracking_install_rateはい
トラッキング制限デバイスの再アトリビューション数トラッキング制限 (LAT) を有効にしたデバイスの再アトリビューション数-limit_ad_tracking_reattributionsはい
トラッキング制限デバイスの再アトリビューション割合トラッキング制限デバイスの再アトリビューション数と再アトリビューション数の比率トラッキング制限デバイスの再アトリビューション数 / 再アトリビューション数limit_ad_tracking_reattribution_rateはい
非オーガニックインストール数オーガニックとしてアトリビューションされなかったユーザーのインストール数-non_organic_installsはい
オーガニックインストール数オーガニックとしてアトリビューションされたユーザーのインストール数-organic_installsはい
再アトリビューション数再アトリビューションされたユーザー数-reattributionsはい
再アトリビューションによる再インストール数再アトリビューションされたユーザーの再インストール数-reattribution_reinstalls
再インストール数

再インストールの回数

Uninstall and Reinstall Growth Solutionの購入が必要

-

reinstalls

(未購入の場合はリクエストエラー)

総Sessions数総Sessions数(インストールと再アトリビューションを含む)base_sessions + installs + reattributionssessionsはい
  • コスト指標
フィールド定義数式フィールド名デフォルトかどうか
広告支出広告の総支出(取得パラメータによって決定)クリック支出 + 露出支出 + インストール支出costはい
広告支出(アトリビューション)Adjustがトラッキングした広告支出クリック支出 + 露出支出 + インストール支出adjust_costはい

広告支出(チャネル)

チャネルAPIから報告された広告支出クリック支出 + 露出支出 + インストール支出network_costはい
広告支出の差異広告支出(アトリビューション)と広告支出(チャネル)の差広告支出(アトリビューション)- 広告支出(チャネル)network_cost_diffはい
クリックコスト広告クリックにかかったコスト支出-click_costはい
有料クリック数広告支出が発生した広告クリック数-paid_clicksはい
eCPI (全インストール)全インストールの平均有効支出広告支出 / インストールecpi_allはい
eCPI (チャネル)チャネルAPIから報告されたインストールの平均有効支出チャネルAPIから報告された広告支出 / チャネルAPIから報告されたインストール数

network_ecpi

はい
eCPI (有料インストール)

有料インストールの平均有効支出

チャネルAPIから報告された広告支出 / 有料インストール数ecpiはい
eCPM (アトリビューション)アトリビューションデータから報告されたeCPMデータ(広告支出 / 有料露出数) * 1000ecpmはい
eCPM (チャネル)チャネルAPIから報告されたeCPMデータ(チャネル支出 / チャネル有料露出) * 1000network_ecpmはい
eCPCクリックあたりの平均有効支出広告支出 / 有料クリック数ecpcはい
露出コスト露出にかかったコスト支出-impression_costはい
有料露出数広告支出が発生した有料露出数-paid_impressionsはい
インストールコストインストールにかかったコスト支出-install_costはい
有料インストール数広告支出が発生した有料インストール数-paid_installsはい
  • 収益指標
フィールド定義数式フィールド名デフォルトかどうか
広告露出数広告の総露出数-ad_impressionsはい
広告収入広告の総収入-ad_revenueはい
コホート累計広告収入

選択した期間内にインストールしたユーザーの現在までの広告収入

例:選択した期間が1/1~1/31で、今日が5/1の場合、1/1~1/31にインストールしたユーザーの5/1までの広告収入を計算します

-

cohort_ad_revenue

はい
1000回表示あたりの広告収入広告表示1000回あたりの平均収入(広告収益 / 広告露出) * 1000ad_rpmはい
アプリ内課金収入アプリ内課金収入-revenueはい
コホート累計アプリ内課金収入

選択した期間内にインストールしたユーザーの現在までのアプリ内課金収入

例:選択した期間が1/1~1/31で、今日が5/1の場合、1/1~1/31にインストールしたユーザーの5/1までのアプリ内課金収入を計算します

-

cohort_revenue

はい
総収入広告収入とアプリ内課金収入を含む総収入広告収入 + アプリ内課金収入all_revenueはい
コホート累計総収入

選択した期間内にインストールしたユーザーの現在までの総収入

例:選択した期間が1/1~1/31で、今日が5/1の場合、1/1~1/31にインストールしたユーザーの5/1までの総収入を計算します

コホート累計アプリ内課金収入 + コホート累計広告収入cohort_all_revenueはい
ARPU (全体)すべての収入を含むアクティブユーザーあたりの平均収益総収入 / 総DAUarpdauはい
ARPU(広告のみ)広告収入のみを含むアクティブユーザーあたりの平均収益広告収入 / 総DAUarpdau_adはい
ARPU (アプリ内課金のみ)アプリ内課金収入のみを含むアクティブユーザーあたりの平均収益アプリ内課金収入 / 総DAUarpdau_iapはい
粗利益総収入から総コストを差し引いたもの総収入 - 総コストgross_profitはい
コホート粗利益選択した期間にインストールしたユーザーの粗利益コホートの総収入 - コストcohort_gross_profitはい
コホートROI選択した期間にインストールしたユーザーの粗利益をコストで割ったものコホートの粗利益 / コストreturn_on_investmentはい
アプリ内課金数トラッキングされたアプリ内課金イベント数-revenue_eventsはい
収入コスト比 (RCR)選択した期間にインストールしたユーザーの収入とコストの比率コホートの総収入 / 総コストrevenue_to_costはい
ROAS (総収入)総収入で計算したROAS(広告収入 + アプリ内課金収益) / コストroasはい
ROAS (広告収入)広告収入のみで計算したROAS広告収入 / コストroas_adはい
ROAS (アプリ内課金収入)アプリ内課金収入のみで計算したROASアプリ内課金収益 / コストroas_iapはい

3.2.3 インターフェースのパラメータ​

  • 時間:

    • 日単位でデータを取得できます
    • タイムゾーンはカスタマイズできます

3.2.4 格納ルール​

  • Report Serviceは集計データであるため、固定値をユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐づいていると考えることができます
  • データ内のdayまたはhourフィールド、つまりデータの日付を、集計データの#event_timeとして設定します
  • Report Serviceのデータのイベント名は -- adjust_report_service_ad_spend です
  • その他の指標、ディメンションのフィールドはすべて格納されます

3.3 データ統合設定情報テンプレート​

以上のドキュメントを読んだら、次の情報テンプレートに記入し、ThinkingAIの担当カスタマーサクセスマネージャーに送信することをお勧めします。この情報テンプレートに基づいて、Adjust Report Serviceのデータ取得を行います:

データインターフェース:Adjust Report Service
---------
会社名:XXX
AEプロジェクト環境:(SAAS/プライベートデプロイ)
AEプロジェクト名:XXX
AEプロジェクトAPP ID: XXX
データ受信URL push_url: XXX
---------
Adjust User Token (API Token): XXX
Adjust App Token: XXX
---------
API設定
履歴データの取得時間範囲:yyyy/mm/dd - yyyy/mm/dd
直近X日分のデータを定期取得(Adjustでは事後にデータが補正されるため、直近数日分のデータを定期的に取得し、補正後のデータを取得できるようにすることをお勧めします)
時間粒度:(日/時間)
グループ化ディメンション:xxx,xxx
集約指標:xxx,xxx

4. 連携テストと統合後のデータ利用​

  1. 連携テスト

「データ管理」 ->「ユーザープロパティ管理」ページで、関連するアトリビューションデータを確認できます:

Adjustのコールバックフィールド説明AEに格納後のユーザープロパティ名データタイプ
network_nameチャネル#adjust_network_nameテキスト
campaign_name広告キャンペーン#adjust_campaign_nameテキスト
adgroup_name広告グループ#adjust_adgroup_nameテキスト
creative_name広告クリエイティブ#adjust_creative_nameテキスト

イベントテーブルへの格納を有効にしている場合は、「データ管理」 ->「イベント管理」ページで関連するイベントデータを確認できます。イベント名はAdjustで定義したイベント名と同じです。impression, click, cost_update, ad_revenueイベントのマッピング表は次のとおりです:

activity_kindの値説明AEに格納後のイベント名
impression露出adjust_impression
clickクリックadjust_click
cost_updateコストadjust_cost_update
ad_revenue収益adjust_ad_revenue

5. FAQ​

AdjustのFAQの項目を参照してください

6. Facebook(Meta)のチャネル名が空になる問題​

Adjustのアトリビューションチャネル名がUnattributedと表示されるの記事を参照してください

このページは役に立ちましたか?