# サードパーティ統合

サードパーティ統合では広告プラットフォームの統合機能を提供し、これらのプラットフォームの広告配信と広告収益データを TE システムと同期できます。本文では、サードパーティ統合の各ページの主要機能と基本的な概念に重点を置き、各プラットフォームの具体的な接続方法については、このページのサブページをご参照ください。

# サードパーティ統合ページ

三方集成のホームページには、現在接続されている統合ソリューションとその基本情報が表示されます。これには、統合ソリューションの名前、統合プラットフォームとインタフェース情報、現在の統合状態、ソリューション作成者および最後の変更日時などが含まれます。

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

WARNING

統合設定数の上限は、クラスタープランによって決まります。上限を調整する必要がある場合は、TEスタッフに連絡してください。

右上の「プランを作成」をクリックすると、プラン選択ページに移動できます。現在サポートされているデータインターフェースから接続することができます。また、カード内の編集ボタンをクリックして、統合プランの設定の編集ページに移動することもできます。

# 統合プラン選択

統合プラン選択ページには、現在サポートされているすべての統合方法の基本情報が表示されます。必要なサードパーティ統合を選択し、その統合方法の編集ページに移動できます。

また、統合プラン選択ページでは検索機能も提供されており、データ接続が必要なプラットフォームを名称で検索することができます。

# 統合プラン構成

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

構成ページでは、選択したプランの基本情報が表示されます。このページから、そのプランがサポートするデータタイプについて確認することができます。また、「統合ガイド」リンクをクリックして、そのプランの統合ソリューションドキュメントにアクセスすることもできます。

また、データ統合のルールを設定ページで調整することもできます。上図に示されているように、サードパーティのデータが格納する際に選択されたユーザ識別フィールド、イベントの格納可否、およびユーザプロパティの格納可否を変更することができます。さらなるカスタマイズを行いたい場合は、「統合設定」欄でJSONを調整して、データ取得の具体的な設定を制御することができます。各プラットフォームごとの設定方法については、対応するプラットフォームインターフェースの統合ガイドを参照してください。

# データ処理ロジック

TEシステムは約40社のサードパーティプラットフォームのデータ統合をサポートしており、これらのプラットフォームが提供するデータ構造や意味は異なります。この章では、サードパーティプラットフォームのデータインタフェース分類、データタイプ、およびTEシステムがどのような標準化サービスを提供しているかについて説明します。これにより、プラットフォーム間の違いを解消できます。

# 4.1 インターフェース分類

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

データ粒度

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

広告露出を通じ、2つのデータ粒度の違いを理解することができます。

ユーザーレベルの広告露出データは、ユーザー情報と広告情報が記録されており、各データは1回の露出を表します。露出データの総量（またはイベント数）が露出量です。
集計指標には1レコードまたは何レコードのデータしかありません。「広告露出量」は各データの1つの指標フィールドにすぎません。そのデータには「広告クリック数」「コンバージョン数」「コスト」などの他の指標が含まれることが通常です。また、「広告計画」「広告グループ」などの広告のフィールドも含まれます。各データは最も詳細な分析対象を表し、例えばある広告計画内で特定の広告に関するクリック数、露出率、総コストなどを示します。

一般的に、ユーザーレベルのデータは他のイベントと同様に、各分析モデルで使用できます。一方、集計指標データは実際のユーザー行動ではないため、イベントモデルやリテンションモデル（主にROIを計算するため）およびSQLクエリでしか使用できません。

統合タイプ

コールバック：コールバックは、サードプラットフォームが元のデータをリアルタイムでTEシステムに返送し、データが継続インポートすることを意味します。現在、TEシステムでサポートされているすべてのコールバックタイプ統合ソリューションは、ユーザーレベルのデータ粒度です。場合によってはPush APIとも呼ばれます。
API：APIはサードパーティプラットフォームが提供するデータ取得インターフェースを指します。TEシステムは構成に基づきサードパーティプラットフォームにデータ取得のリクエストを送信し、リクエストが承認された後にのみデータが渡されます。現在、TEシステムでサポートされているAPIタイプの多くは集計指標であり、一部はユーザーレベルです。場合によってはPull APIとも呼ばれます。

統合タイプはデータのリアルタイム性に影響を与えます。例えば、コールバックされるデータは基本的にリアルタイムですが、API データにはある程度の遅延が発生することが見込めます。また、統合タイプの設定方法も異なります。コールバックされるデータの主要な設定はサードパーティーのプラットフォームで行われ、TE システム側ではコールバック先のアドレスをコピーするだけで完了します。一方で API データでは、トークンや時間範囲、取得頻度および指標・ディメンション情報などを TE システムで設定する必要があります。

# 4.2 データ種類

異なるプラットフォームのデータには差異があると考えられますが、広告配信と収益化にとって最も重要なデータは以下の6種類に分類できます。サードパーティ統合ページでは、各プラットフォームがサポートするデータタイプを確認できます。

データ種類	意味
アトリビューションデータ	ユーザーに帰属された広告ソース情報はユーザーレベルであることしかありません。インストールイベントとユーザープロパティでソース状況を確認できます。
コストデータ	トラフィック購入にかかるコストは、集約指標である場合もありますし、各ユーザーのユーザーレベルコストである場合もあります。
収益データ	収益は広告によって得られ、集計指標である場合もありますし、各実現広告がユーザーレベルの収益を得た場合もあります。
露出データ	トラフィック獲得広告または収益化広告の露出状況は、集計指標である可能性がありますが、各広告の露出データでもあり得ます。
クリックデータ	トラフィック獲得広告または収益化広告のクリック状況は、集約指標である可能性がありますが、各広告のクリックデータでもあり得ます。
コンバージョンデータ	自然トラフィックではないユーザーがゲーム/アプリ内で転換行動を起こす場合、ほとんどのプラットフォームでは、転換行動はユーザーのインストールを指します。これは集約指標か、各ユーザーの転換行動イベントかもしれません。

# 4.3 標準化フィールド

マーケティング担当者が異なるプラットフォームの広告データを統合分析するために、TEシステムはフィールド標準化機能を提供しています。 TEシステムは、事前に設定されたロジックに従って、受信したデータのコアフィールドをte_ads_objectオブジェクトフィールドに書き込み、クロスプラットフォームでコアフィールドを統一する機能を実現します。 TEシステムは接続されたほとんどのプラットフォームで自動的にフィールド標準化能力を提供できます。

標準化フィールド	意味
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	収益