# Adjust Report Service API
WARNING
プラットフォームのデータ統合によって生成されたデータは、クラスターのデータ消費量にカウントすることに注意してください。
# 概要
| API名 | 統合タイプ | データ粒度 | アトリビューション | コスト | 収益 | 露出 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| Report Service API | API | 集計 | ✅ | ✅ | ✅ | ✅ | ✅ |
AdjustのReport Service (opens new window) API (opens new window)は、コスト、収益、露出回数、クリック数、コンバージョンなど多くのデータを含む集計された指標データを提供します。
# 統合手順
Adjust Report Service APIのデータアクセス手順は以下の通りです：
- Adjustバックエンドで、Adjust API識別コードとアプリ識別コードを取得します。
- TEバックエンドにログインし、サードパーティ統合モジュールに移動して、Apple Search Ads統合ソリューションを追加し、関連する設定を完了します。
- TEシステムがデータを正常に受信し、レポート構築が完了したかどうかを確認します。
# Adjust APIの識別コードとアプリ識別コードを取得する
# 1.1 Adjust APIの識別コードを取得
Report Service API を取得する前に、まず Adjust API のトークンを取得する必要があります。このトークンは、Adjust Suite のバックエンドの「アカウント設定」-「マイプロファイル」から入手できます。クラシックコントロールパネルでは、「マイアカウント」-「データ」タブの「ユーザー詳細」セクションで、「歯車ボタン」をクリックして入手します。
以下はAdjust Suite のインターフェースで、API 識別コードは画像内の API トークン：
# 1.2 アプリ識別コードを取得
次に、Adjustのアプリ識別コードを取得する必要があります。これにより、データの取得元がどのAdjustプロジェクトかを決定できます。
Adjustのバックエンドに移動し、アプリを検索してアプリオプションの挿入記号（^）をクリックします。左側のプロジェクトカードにはアプリ識別コード（App Token）が表示されます。また、「すべての設定」をクリックし、「アプリ詳細情報を表示」もクリックすることで、アプリ識別コードを取得できます。
# プラン構成
AdjustのAPI識別コードとアプリ識別コードを取得した後、TEシステムにログインし、「サードパーティ統合」モジュールで新しいプランの構成をできます。以下はAdjust Report Service APIの構成画面です。
# 2.1 認証情報設定
「認証情報設定」ボタンをクリックし、ポップアップ内にAPI識別コードとアプリ識別コードを入力してください。
# 2.2 定期取得
「定期取得」モジュールで、TEシステムがAdjust Report Service APIデータを定期的に取得するルールを設定できます。特定の時間帯ごとに毎日または毎時にデータを取得することができます。取得したデータもデータ量に含まれるため、長時間のデータの定期的な取得は避けることをお勧めします。
# 2.3 取得タイムゾーン
データの取得時にタイムゾーンを設定することもできます。
# 2.4 格納設定
データがイベントの形式で書き込まれるかどうかを制御することができます。イベントデータの保存をオンにすることをお勧めします。 
# 2.5 統合構成
最後に、データの取得の詳細設定を統合構成モジュールで制御することができます。これには、データの時間集約粒度、取得するフィールドやディメンション、およびイベント名などが含まれます。
統合設定の内容はJSON形式であり、以下の内容に従ってカスタム設定を行うことができます：
| モジュール | 名称 | 意味 |
|---|---|---|
| sink_event | event_name | 格納後のイベント名、カスタムできる |
| source | metrics | データ内の指標、リストタイプで、カスタムできる |
| group_by | データのグループ化ディメンション、リストタイプでカスタムできる |
必要に応じて、統合構成を変更することができます。
# 2.5.1 対応指標
source.metricsには、統合設定で対応指標が含まれています。Report Serviceがサポートしている指標は非常に豊富です。詳細な指標のリストについては、Adjust公式ウェブサイトのドキュメント (opens new window)を参照してください。
# 2.5.2 グループディメンション
Report Serviceでサポートされているグループ化の次元は以下の通りです。これは、統合設定のsource.groupbyに対応しています。時間の粒度（1つのみ選択可能）とグループ化の次元（複数選択可能）が含まれます。メトリックを変更する場合は、source.groupbyに必要な指標のフィールド名を入力してください。
- 時間粒度
| 粒度 | データタイプ | 説明 | 例 | デフォルト使用 |
|---|---|---|---|---|
| hour | 時間 | ISO形式の日付値：YYYY-MM-DDTHH:MM:SS | 2021-05-11T17:00:45 | |
| day | 時間 | 日付の形式：YYYY-MM-DD | 2021-05-11 | Yes |
| 粒度 | データタイプ | 説明 | 例 | デフォルト使用 |
|---|---|---|---|---|
| os_name | 文字列 | OS | 値：android、Bada、blackberry、iOS、Linux、Mac OS、server、symbian、unknown、WebOS、Windows、windows-phone | Yes |
| device_type | 文字列 | デバイスタイプ | 値：bot、console、iPod、Mac、PC、phone、server、simulator、tablet、TV、unknown | Yes |
| app | 文字列 | アプリ名 | - | Yes |
| app_token | 文字列 | Adjust の中のアプリID | - | Yes |
| store_id | 文字列 | ストアID | com.random.app | Yes |
| store_type | 文字列 | インストールストア | google_play | Yes |
| app_network | 文字列 | アプリ識別 |
格式： | Yes |
| currency | 文字列 | 通貨 | Euro | Yes |
| currency_code | 文字列 | 3文字のISO 4217通貨コード | EUR | Yes |
| network | 文字列 | 広告チャネル名 | 値：Organic, AppLovin, Facebook Installs, Instagram Installs | |
| campaign | 文字列 | キャンペーン名とID | - | Yes |
| campaign_network | 文字列 | チャネルのキャンペーン名 | - | Yes |
| campaign_id_network | 文字列 | チャネルのキャンペーンID | - | Yes |
| adgroup | 文字列 | 広告グループ名とID | - | Yes |
| adgroup_network | 文字列 | チャンネルの広告グループ名 | - | Yes |
| adgroup_id_network | 文字列 | チャネルの広告グループID | - | Yes |
| source_network | 文字列 | チャネルに基づいた選択可能な値は、通常adgroup_networkと同じ | - | Yes |
| source_id_network | 文字列 | source_app 値 | - | Yes |
| creative | 文字列 | 素材名とID | - | Yes |
| creative_network | 文字列 | チャネル素材名 | - | Yes |
| creative_id_network | 文字列 | チャネル素材ID | - | Yes |
| country | 文字列 | 国・地域名 | United States of America | Yes |
| country_code | 文字列 | 2文字のISO 3166国家/地域コード | US | Yes |
| region | 文字列 | リージョン | APAC | Yes |
| partner_name | 文字列 | Adjust パートナー名の調整 | AppLovin | Yes |
| partner_id | 文字列 | Adjust パートナーIDの調整 | 34 | Yes |
# 2.5.3 格納規則
以下はReport Service APIの標準化フィールドです：
| 元フィールド | 標準化フィールド | 意味 |
|---|---|---|
| campaign_network | te_ads_object.campaign_name | 広告キャンペーン名 |
| campaign_id_network | te_ads_object.campaign_id | 広告キャンペーンID |
| adgroup_network | te_ads_object.ad_group_name | 広告グループ名、マネタイズ広告のUnit名 |
| adgroup_id_network | te_ads_object.ad_group_id | 広告グループID、マネタイズ広告のUnit ID |
| creative_network | te_ads_object.ad_name | 広告名 |
| creative_id_network | te_ads_object.ad_id | 広告 ID |
| partner_name | te_ads_object.media_source | メディアチャネルまたは収益化チャネル |
| store_id | te_ads_object.app_id | アプリ ID |
| app | te_ads_object.app_name | アプリ名 |
| os_name | te_ads_object.platform | OS名、Android、iOS など |
| country_code | te_ads_object.country | 国家・地域コード |
| currency_code | te_ads_object.currency | コストまたは利益の通貨 |
| impressions | te_ads_object.impressions | 露出量 |
| clicks | te_ads_object.clicks | クリック量 |
| installs | te_ads_object.installs | コンバージョン量（インストール） |
| cost | te_ads_object.cost | コスト |
| revenue | te_ads_object.revenue | 収益 |
# 後続利用
# 3.1 データ格納チェック
「データ管理」ページで、イベント adjust_report_service_ad_spend がデータベースに保存されているかを確認できます。
# 3.2 一回のデータを取得
前の一定期間のデータ、例えば過去のデータや取得に失敗したデータを追加する場合は、保存後に再度プロジェクトページに入り、右上の単回収集ボタンをクリックして時間範囲を指定してデータを取得できます。ただし注意が必要です。もし取得するデータの期間が以前と重複する場合（例：2023年8月1日のデータを取得したが、その日付のデータは既に以前に取得済み）、最新の一回収集結果が以前のデータを上書きします。