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

サードパーティ統合

最終更新 2026/08/31

サードパーティ統合モジュールは、一連のサードパーティ広告プラットフォームとの統合機能を提供しており、これらのプラットフォームの広告配信および広告マネタイズのデータをAEシステムに同期できます。本記事では、サードパーティ統合モジュールの各ページの主な機能と、サードパーティ統合モジュールの基本概念を中心に紹介します。各プラットフォームの具体的な統合方法については、本ページの子ページを参照してください。

1. サードパーティ統合のホーム​

サードパーティ統合のホームには、現在統合済みの統合プランとその基本情報が表示されます。統合プランの名前、統合するプラットフォームとインターフェースの情報、現在の統合ステータス、プランの作成者、最終修正時間などが含まれます。

なお、新しいバージョンではサードパーティ統合の設定数に上限が追加されており、各プロジェクトに同時に存在できるサードパーティ統合の設定数はこの上限を超えることができません。上限に達した場合は、不要なプランを削除して設定数を解放できます。

右上の「統合プラン作成」をクリックするとプラン選択ページに移動し、現在対応しているデータインターフェースを選択して統合できます。また、カード内の編集ボタンをクリックしてプラン編集ページに移動し、統合プランの設定を変更することもできます：

2. プラン選択ページ​

プラン選択ページには、現在対応しているすべての統合方式の基本情報が表示されます。必要な統合方式を選び、カードをクリックすると、その統合方式の編集ページに移動します。

プラン選択ページには検索機能もあり、プラットフォーム名で、データを統合したいプラットフォームを検索できます。

3. 設定ページ​

サードパーティ統合のホームで編集ボタンをクリックするか、プラン選択ページで統合方式のカードをクリックすると、サードパーティ統合の設定ページに移動します。上図はAdjustリアルタイムコールバックプランの設定ページです。プラットフォームごとにデータロジックが異なるため、設定ページもプラットフォームによって異なります。

設定ページには選択したプランの基本情報が表示され、そのプランが対応しているデータタイプを確認できます。また、「ドキュメント」リンクをクリックして、そのプランの統合プランドキュメントにアクセスすることもできます。

さらに、設定ページではデータ統合のルールを調整できます。上図のように、サードパーティデータの格納時に使用するユーザー識別フィールド、イベントを格納するかどうか、ユーザープロパティを格納するかどうかを変更できます。さらに詳細な調整を行いたい場合は、「統合構成」欄でJSONを調整して、データ取得の具体的な設定を制御できます。各プラットフォームの設定方法については、該当するプラットフォームのインターフェースの統合プランドキュメントを参照してください。

4. データ処理ロジック​

AEシステムは現在、40種類以上のサードパーティプラットフォームのデータ統合プランに対応しており、プランごとに提供されるデータの構造や意味はそれぞれ異なります。本章では主に、サードパーティプラットフォームのデータインターフェースの分類とデータタイプ、およびプラットフォーム間の差異を解消するためにAEシステムが提供する標準化サービスについて紹介します。

4.1 インターフェースの分類​

サードパーティプラットフォームがデータを提供する機能をデータインターフェースと呼びます。データインターフェースは、データ粒度と統合タイプの2つの観点から分類できます。

データ粒度

  • ユーザーレベル：各データは1人のユーザーの1回の露出、クリック、またはインストール行動であり、AEシステムはこれらのデータをAEのイベントまたはユーザーデータに直接変換します
  • 集約指標：各データには分析ディメンションと各種指標が含まれ、ユーザー情報は含まれません。AEシステムはこれらのデータを、イベントとして1人の仮想ユーザーに記録します

広告の露出を例に、2つのデータ粒度の違いを説明します：

  • ユーザーレベルの広告露出データには、ユーザーの情報と広告の情報が記録されており、各データが1回の露出を表します。露出データの総データ量（つまりイベント数）が露出数になります
  • 集約指標の場合はデータが1件または数件しかなく、広告露出数は各データ内の1つの指標フィールドにすぎません。そのデータには広告露出数のほかに、通常は広告クリック数、コンバージョン数、コストなどの他の指標や、広告キャンペーン、広告グループなどの広告ディメンションフィールドも含まれます。各データは最も細かい分析ディメンションでの指標を表します。たとえば、ある広告キャンペーンのある広告のクリック数、露出率、総コストなどです

一般に、ユーザーレベルのデータは他のイベントと同様に各分析モデルで使用できます。一方、集約指標データは実際のユーザーが行った行動ではないため、イベント分析モデル、リテンション分析モデル（主にROIの計算に使用）、およびSQL IDEでのみ使用できます。

統合タイプ

  • コールバック：コールバックとは、サードパーティプラットフォームが自身のローデータを比較的リアルタイムにAEシステムへ送り返すことを指し、データは継続的に流入します。現在、AEシステムが対応しているコールバックタイプの統合プランは、データ粒度がすべてユーザーレベルです。Push APIと呼ばれることもあります
  • API：APIとは、サードパーティプラットフォームが提供するデータ取得インターフェースを指します。AEシステムは設定に基づいてサードパーティプラットフォームにデータ取得リクエストを送信し、データは取得リクエストが成功した場合にのみ送られてきます。現在、AEシステムが対応しているAPIタイプの統合プランは、データ粒度の大部分が集約指標で、一部はユーザーレベルです。Pull APIと呼ばれることもあります

統合タイプはデータのリアルタイム性に影響します。たとえば、コールバックデータはほぼリアルタイムですが、APIデータには一定の遅延があります。また、統合タイプによって設定方法も異なります。コールバックデータの主な設定はサードパーティプラットフォーム側で行い、AEシステムではコールバックアドレスをコピーするだけです。APIデータの場合は、取得用のToken、時間範囲、取得頻度、指標、ディメンションなどの情報をAEシステムで設定する必要があります。

4.2 データタイプ​

プラットフォームによってデータに違いはありますが、広告配信とマネタイズにとって最も重要なデータは次の6種類に分類できます。サードパーティ統合のホームでは、各プラットフォームが対応しているデータタイプを確認できます：

データタイプ意味
アトリビューションアトリビューション後のユーザーの広告ソース情報。アトリビューションデータはユーザーレベルのみで、ユーザーのインストールイベントやユーザープロパティでアトリビューション状況を確認できます
コストユーザー獲得にかかったコスト。集約指標の場合も、各ユーザーのユーザーレベルのコストの場合もあります
収益マネタイズ広告で得られた収益。集約指標の場合も、各マネタイズ広告で得られたユーザーレベルの収益の場合もあります
露出ユーザー獲得広告またはマネタイズ広告の露出状況。集約指標の場合も、各広告の表示データの場合もあります
クリックユーザー獲得広告またはマネタイズ広告のクリック状況。集約指標の場合も、各広告のクリックデータの場合もあります
コンバージョン非オーガニックユーザーがゲーム/アプリ内でコンバージョン行動を行った状況。ほとんどのプラットフォームでは、コンバージョン行動はユーザーのインストールを指します。集約指標の場合も、各ユーザーのコンバージョン行動イベントの場合もあります

4.3 標準化フィールド​

マーケティング担当者が異なるプラットフォームの広告データをまとめて分析しやすいように、AEシステムはフィールドの標準化機能を提供しています。AEシステムはあらかじめ設定されたロジックに従って、受信したデータの主要フィールドをオブジェクトフィールドte_ads_objectに書き込み、プラットフォームをまたいで主要フィールドを統一します。AEシステムが統合に対応しているほとんどのプラットフォームでは、フィールドの標準化機能が自動的に提供されます。

標準化フィールド意味
te_ads_object.ad_account_id広告アカウントID
te_ads_object.campaign_name広告キャンペーン名
te_ads_object.campaign_id広告キャンペーンID
te_ads_object.ad_group_name広告グループ名、マネタイズ広告のUnit名
te_ads_object.ad_group_id広告グループID、マネタイズ広告のUnit ID
te_ads_object.ad_name広告名
te_ads_object.ad_id広告ID
te_ads_object.placement広告の配置
te_ads_object.media_sourceメディアチャンネルまたはマネタイズチャンネル
te_ads_object.app_idアプリID
te_ads_object.app_nameアプリ名
te_ads_object.platformプラットフォーム（Android、iOSなど）
te_ads_object.country国・地域コード
te_ads_object.currencyコストまたは収益の通貨
te_ads_object.impressions露出数
te_ads_object.clicksクリック数
te_ads_object.installsインストール数
te_ads_object.costユーザー獲得コスト
te_ads_object.revenueマネタイズ収益
te_ads_object.agency代理店/代理チャンネル
te_ads_object.conversionsコンバージョン数

5. 旧プランの移行について​

バージョン4.2より前は、AEシステムが対応しているサードパーティ統合プランのほとんどはThinkingAIの担当者が設定しており、これらの設定を旧プランと呼びます。バージョン4.2のリリース後、旧プランの新しい設定のコピーが自動的に作成され、「サードパーティ統合」モジュールで確認できます。コールバックタイプのプランについては、すべての移行作業を直接完了します。APIタイプのプランについては、一部の設定パラメータのみを移行するため、プラン自体はまだ使用できず、ステータスは「プラン移行」と表示されます。

データの正常な格納に影響を与えないよう、次の方法を採用しています：

  • 4.2へのアップグレード後、APIタイプのプランは引き続き旧プランでデータを取得し、「サードパーティ統合」モジュールで「プラン移行」ステータスのプランは実際には実行されません。コールバックタイプのプランは「サードパーティ統合」モジュールの新しいプランをそのまま使用し、ステータスは「統合済」、つまり正常に統合されている状態です
  • 特に必要がなければ、既存のプランについては引き続き旧プランを使用することをお勧めします
  • 「プラン移行」ステータスの新しいプランを稼働させる必要がある場合は、ThinkingAIの担当者に連絡して操作を依頼してください
このページは役に立ちましたか？
このページの内容