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

Unity Ads Advertising Statistics API

最終更新 2026/10/05
ヒント

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

概要​

インターフェースの概要​

インターフェース名タイプ粒度アトリビューションコスト収益表示クリックコンバージョン
Advertising Statistics APIAPI集約指標✅✅✅✅

Unity Adsの広告配信データをAdvertising Statistics APIを通じてThinking Analytics（以下、AEシステム）にコールバックするプランです。このプランでは次のことに対応しています：

  • Unity Adsのコスト、クリック、表示などの基本レポート指標をAEシステムにコールバックします

統合の流れ​

  1. Unity Dashboardの管理画面にログインし、データを統合するプロジェクトの「Organization ID」と「API Key」を取得します
  2. AE管理画面にログインし、サードパーティ統合モジュールでUnity統合プランを追加して、関連する設定を完了します
  3. AEシステムがデータを正常に受信しているかを確認し、レポートを作成します

1. 認証情報の取得​

1.1 Organization IDの取得​

Unity Dashboardの管理画面に移動し、左側のサイドバーで「Growth」ページの「Settings」ページを選択して、「Organization」テーブルで「Organization ID」を見つけてコピーし、保存します（Organization Core IDではないことに注意してください）。

1.2 API Keyの取得​

再び左側のサイドバーで「Growth」ページの「API Management」タブを選択し、「Stats API Access」テーブルで「API Key」を見つけてコピーし、保存します。

2. プランの設定​

Unityの管理画面から認証情報を取得したら、AEシステムにログインし、「サードパーティ統合」モジュールで新しいプランの設定を完了できます。下図はUnity Ads Advertising Statistics APIの設定画面です。この章の内容に従ってプランを作成してください：

2.1 認証情報の設定​

「認証情報」の下にある「認証情報設定」ボタンをクリックし、ポップアップに前の手順で取得した情報を入力します：

2.2 定期取得​

「定期取得」モジュールで、AEシステムがUnity Ads Advertising Statistics APIのデータを定期的に取得する方針を設定できます。毎日の特定の時刻に一定期間のデータを取得するよう選択できます。取得したデータもデータ量に計上されるため、定期取得で長すぎる期間のデータを取得しないことをお勧めします

2.3 格納設定​

データをイベントとして書き込むかどうかを制御できます。オフにすると、データはイベントテーブルに書き込まれなくなるため、この設定はオフにしないでください。

2.4 統合構成​

最後に、統合構成モジュールでデータ取得の詳細設定を制御できます。データの時間集計粒度、取得する指標フィールドとディメンション、格納後のイベント名などが含まれます。

統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：

モジュール名前意味
sink_eventevent_name格納後のイベント名。カスタマイズ可能で、文字列型です。
source

time_granularity

データ取得の時間粒度。以下から選択できます：

  • 日：day
  • 時間：hour
metrics対応するインターフェースの指標フィールド。リスト型で、カスタマイズ可能
group_byデータ内のグループ化ディメンション。リスト型。カスタマイズ可能
transferdouble_columnsデータ内の指標。リスト型です。ここに含まれるフィールドはデータ受信時に数値型で格納され、その他のフィールドは文字列（または時間）として格納されます。変更はお勧めしません
  • グループ化ディメンション

以下は、Unity Advertising Statistics APIが対応しているグループ化ディメンションです。調整する場合は、必要なグループ化ディメンションのディメンション名をsource.group_byに記述してください

ディメンション名説明格納フィールド名デフォルトで取得するか

campaignSet

Campaign Setでグループ化campaign_set_idはい
campaign_set_nameはい
campaignCampaignでグループ化campaign_idはい
campaign_nameはい
creativePackCreative Packでグループ化creative_pack_idはい
creative_pack_nameはい
targetターゲットゲームでグループ化target idはい
target store idはい
target nameはい
adType広告タイプ別にグループ化ad_typeはい
sourceAppIdソースゲームでグループ化source_app_idはい
storeアプリストアでグループ化storeはい
country国（地域）別にグループ化countryはい
platformプラットフォームでグループ化platformはい
osVersionOSバージョンでグループ化os_versionはい
skadConversionValueSKAdNetworkコンバージョン値でグループ化skad_conversion_value
  • 指標フィールド

Unity Ads Advertising Statistics APIは、グループ化ディメンションのほかに、次の指標フィールドも提供しています。調整する場合は、必要な指標名をsource.metricsに記述してください。

指標名格納フィールド名フィールドの説明デフォルトで取得するか
timestamptimestampイベント時間はい
startsstarts広告の露出回数はい
viewsviews広告の完全視聴回数はい
clicksclicks広告クリック数はい
installsinstalls広告を見てインストールした回数はい
spendspend費用はい
skadInstallsskad_installsSKAdNetworkインストール
skadCpiskad_cpiSKAdNetwork CPI

skadConversion

skad_conversionSKAdNetworkコンバージョン

2.5 イベントの格納ルール​

  • データ内のtimestampフィールド、つまりデータ集約の時間フィールドを、集約データの#event_timeとして設定します
  • 名前を変更していない場合、データのイベント名は -- unity_ads_api_data です
  • その他のフィールドはすべて格納されます

2.6 標準化フィールド​

Unity Ads Advertising Statistics APIのデータ内の一部のフィールドは、AEシステムによって標準化処理されます：

フィールド標準化フィールド意味
campaign_namete_ads_object.campaign_name広告キャンペーン名
campaign_idte_ads_object.campaign_id広告キャンペーンID
creative_pack_namete_ads_object.ad_group_name広告グループ名
creative_pack_idte_ads_object.ad_group_id広告グループID
countryte_ads_object.country国・地域コード
platformte_ads_object.platformプラットフォーム（Android、iOSなど）
startste_ads_object.impressions露出数
clickste_ads_object.clicksクリック数
installste_ads_object.installsコンバージョン数（インストール）
spendte_ads_object.costユーザー獲得コスト
このページは役に立ちましたか？
このページの内容