# サードパーティ統合

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

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

サードパーティ統合ページには、現在サポートされている一部のサードパーティプラットフォームが表示されております。以下のプラットフォーム名をクリックして、プラットフォームの統合ソリューションを確認できます：

現状TEでは、約30のサードパーティプラットフォームのデータ統合をサポートしています。詳細については、TEスタッフへお問い合わせください。

統合または設定変更ボタンをクリックし統合設定ページへ遷移後、詳細確認ボタンをクリックすると該当プラットフォームのデータ統合状況やエラーの詳細を確認できます。

# 設定画面

サードパーティ統合ページで「統合」または「設定変更」ボタンをクリックすると、サードパーティ統合設定ページに遷移します。上記図はAppsFlyer設定ページを示していますが、各プラットフォームのデータロジックが異なるため、各プラットフォームの設定ページも異なります。主な設定可能なパラメーターは以下の通りです：

統合スイッチ：統合プランが実行されるか否かを制御しOFFにすると、TEシステムはそのプラットフォームからデータを取得・受信しなくなります。
ユーザー識別と関連付け：ユーザーレベルのデータのみが表示され、受信したサードパーティデータのどのフィールドがTEシステムのユーザー識別フィールドかを決定します。この設定に基づいて、TEシステムはサードパーティデータをTEユーザーのイベントまたはユーザーデータに変換します。
イベントテーブルの格納設定：受信したサードパーティデータをイベントテーブルに格納するか否かを制御します。常時ONに設定することを推奨します。
ユーザープロパティの格納設定：ユーザーレベルのデータのみが表示され、受信したサードパーティデータのうち、どのフィールドをTEユーザーのユーザーテーブルに格納する必要があるかを決定します。ONを推奨します。
定期取得：APIを使用する統合タイプのプラットフォームのみが表示されます。ONにすると、TEシステムは指定された時間に指定された期間のデータを取得します。ONを強く推奨します。
データソース：データ送信アドレスを設定したコールバックタイプのインテグレーションプラットフォームでのみ表示されます。通常データソースの内容をコピーし、サードパーティのプラットフォームにログインしてコールバックへ設定変更する必要があります。
インテグレーションプラン：APIタイプのインテグレーションプラットフォームでのみ表示されます。データを正しく取得するには、プランを作成後、必要な項目（Tokenなどの取得）を入力する必要があります。

画面左下の「元の既定値をリセット」ボタンをクリックすると、上記のパラメータがデフォルト状態にリセットされます。

また、設定画面右上にあるドキュメントをクリックすると該当プラットフォームに関する資料も閲覧できます。Pull APIタイプの統合の場合、一回取得を選択することもできます。一回取得とは、すぐにデータ取得タスクを実行することを意味し、取得する時間範囲またはどの統合プランを取得する必要があるかを指定できます。

# データ詳細ページ

統合ページの詳細ボタンをクリックするか、編集ページで詳細タブをクリックすると、データの詳細ページへ遷移します。詳細ページには、直近で完了した最大1000件のデータが表示されます。特定のデータをクリックすると、変換前と変換後の詳細を確認することができます。万が一、データの変換が失敗した場合は、変換詳細で失敗の原因を確認できます。現状選択しているデータをコピーまたはエクスポートすることも可能です。また、画面右上のダウンロードボタンをクリックしてすべての詳細データを一括ダウンロードできます。

# データ処理ロジック

TEシステムは、約30社のサードパーティプラットフォームのデータ統合をサポートしており、これらのプラットフォームが提供するデータ構造や意味は異なります。この章では、サードパーティプラットフォームのデータインタフェース分類、データタイプ、および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	収益