ドキュメント

​
​

Development

User Acquisition

Monetization

産業

Grow

Unity Ads Android SDK

Unity Ads iOS SDK

LevelPlay SDK

Unity Dashboard を開く

Grow

Monetization
​
​
Ad Quality
  • 概要
  • 用語集
  • 追加設定
  • Ad Quality のベストプラクティス
  • Ad Quality Raw Data API
  • Unity Ad Quality プラグイン
  • Analysis
  • クリエイティブ
  • ユーザージャーニー
  • 広告のレポート
  • ルールと通知
  • ユーザー体験パターン
  • サポートされている広告ソース
  • SDK 変更履歴
  • Ad Quality SDK のテスト
  1. ゲームの成長
  3. Ad Quality

広告品質 Raw データ API

BI プラットプラットフォーム分析用の Ad 品質 Raw データ API を使用して、Android アプリケーションからインプレッションレベルの広告品質指標　 (収益、クリック率、広告ソース、クリエイティブ ID、UX パターンなど) を抽出します。
読み終わるまでの所要時間 12 分
最終更新 7日前
広告品質 Raw データ API を使用すると、広告品質からインプレッションレベルのデータを取得して、内部 BI プラットフォームで使用できます。
注
Raw データ API へのアクセスについては、アカウント マネージャに接触してください。

API の使用方法

  • Ad 品質 Rawデータのプルは、以下の手順を実行して実行されます。
  1. レポートをダウンロードするための URL リンクを返す API リクエストを作成する
  2. 指定されたリンクをクリックしてレポートをダウンロードします。
  • 各API呼び出しは個々のアプリケーションと 1つの日付に対して行う必要がある
  • 各日付のデータは保存され、14日間使用できます。
    • 例: 1月1日のデータは1月14日まで利用できます_
  • 指定した日付のデータは、以下の日の08：00 AM UTCからのみ使用可能です。この時間以降、API のみを呼び出しようにしてください。
    • 例: 1 月 1 日のデータは 1 月 2 日の 08：00 AM UTC 以降でのみ使用可能です。
  • データは利用可能になってから 2 日間更新が続けられます。その後、それらは変更されません。
    • 例: 1 月 1 日のデータは 1 月 2 日と 1 月 3 日に更新されます。1 月 3 日以降、データは変更されません_
  • Date & アプリケーション キー (日付とアプリキー) はレポート (ファイル) ごとに一意のであるため、レポートに含まれません。

レポート URL の API リクエスト

有効な API ヒットは、要求されたファイルへのリンクを返します。
注
ファイルは 1 時間だけダウンロードできます。

認証タイプ

Bearer API 認証

メソッド

GET

必須パラメーター:

名前

型

説明

date文字列YYYY-MM-DD (UTC タイムゾーン)
appKey文字列キーットフォーム上に表示されます)

リクエスト例 URL

request GET 'https://ad-quality.soomla.com/api/rawdata/v1?appKey=c0492d05&date=2022-07-12'``` ### Response Example URL##response-example-url```js{   "urls": [       "https://ad-quality-raw-data-api.s3.amazonaws.com/production/daily_dumps/2022-07-06/4/appkey%3Dc0492d05/20220707_070020_00066_jht7e_bucket-00000.gz?AWSAccessKeyId=ASIAZF2UTGTCQF2VSIVE&Expires=1657212469&Signature=u%2F2qOWmVw3iC2v21nqRYnOE443s%3D&x-amz-security-token=FwoGZXIvYXdzELv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDJtzCMfRJtv%2B7dCGjyLkAQX4BODoGx%2F92huTOXt86j31N1mrr2UvKuD9Qi5w1Kzu0B%2FfBrXlk4in64Z53Iy%2BOR1A5cGxvu25LObGXreMeCfdLz1S5p4WOM1ldmKgkWxYMvU01obpj3dvUXob4G1Gz13Uf5Go9B7THZlVV6g8Mhduk7zpIqYRmwYDCq4U2WBeN%2BKiJOT6Rf2SRDvpDXQJDW1bl%2FV4UfYFJUz8s%2B1HIVxmeVmrIzJVevD35Wjh4dGHuD0OTRSEL7NsTjzqtTZs7mUIWjqV2aJh8l8Rz%2BwG3d%2FGtgblKJ%2Fi3wE5X0xJjkQNJgm6WCiW1pqWBjIyuheodw%2FxNLedYFcSY7wuJa6iKhxdZQwumUZgp1TS0j2kfu8eSPe6D0jvsGhlpk4zYms%3D"   ],   "expiration":1}

フィールド定義

このテーブルには、Ad 品質 Rawデータをプルした後にレポートに表示されるフィールドが表示されます。それぞれについて、説明と含まれるものの例を見ることができます。 
上記の手順を使用してプルした URL を選択してレポートをダウンロードします。
文字列。
文字列。
文字列。
文字列。
文字列。
文字列。
広告主名
文字列。

フィールド

説明

例

event_timestamp
Bigint
1657500000000
user_id
1834b456-b9ea-4811-a121-9afc165c1eb0
ad_unit
Interstitial
ad_source
広告を配信するネットワーク名
Google AdMob
dsp
存在する場合の dsp 名
TheTradeDesk
instance_name
ネットワーク インスタンス名
DefaultRewarded
country
ISO 3166-1 アルファ 2 に基づく 2 文字の国コード
US
us_state
発生したインプレッションの状態コード
OR
device_model
SM-A127M
os_version
18.3.1
sdk_version
5.17.0
app_version
2.8.9
advertiser
Project Makeover
advertiser_id
com.bgg.jump
advertiser_type
ゲーム内に表示される広告主のタイプを表すフィールド。iOS ストア ID、Android パッケージ名、ブランドなどが含まれます。
package_name
click
1 はクリックが発生したことを示し、0 はクリックがなかったことを示す整数
1
click_type
文字列。この文字列に関連する UX パターンを確認しましたか。 Ad Quality の用語集 (qClick、近接_click、自動_click、早期_click、急遽_click、その他)
auto_click,proximity_click
click_ts
Bigint、クライアントのタイムスタンプ (UTC)
1657450000000
video_completed
動画クリエイティブの種類に関連しており、1 は動画が完了したことを示し、0 は動画が完了しなかったことを示す整数です。
1
video_completed_ts
Bigint
1657450000000
revenue
ユーザーによって発生した収益 (ドル)。
0.5
category
アプリストアや Google Play から取得した広告主のアプリのカテゴリ
Casual
content_rating
米国の Apple/Google のアプリストアでの年齢区分
{"US":"Everyone"}
creative_type主なクリエイティブの種類: プレイアブル/動画/画像
playable
creative_id
文字列、広告品質クリエイティブ ID
6c3d78bfe7c74d805c01b13b44e6e1ecff16544c
appstore_url
(現在のフィールド名は 
url
)		String
https://www.ubereats.com/?utm_campaign=CM2176745-display-doubleclick_42_-99_CR-National_e_all_bra_cpm_es_Eater%7CCR%7CEatsDemandIIYTBumper-L2R0ED22-PO481364&utm_medium=display-programmatic&utm_source=dbm
video_urls
文字列の配列
https://www.youtube.com/watch?v=rdahaLbmxOw
end_card_urls文字列の配列
https://v.ssacdn.com/demand-creatives/assets/videos/m29ateosecjmkxt2xamf.mp4
icon_urls
String
https://lh3.googleusercontent.com/y3iFaRQsuLPIiWnCX_Yg7j2IGWiKtnFFbsQPBwRWxIFszsV_xnZYE5VT7d1udxRqQSCPxn_cyw=w256-h256
image_urls
文字列の配列
https://i.ytimg.com/vi/Pv8H5ceSeF0/hqdefault.jpg
imp_num
ユーザーのシーケンスのインプレッション番号。バナー広告やネイティブ広告の場合、この値は 
-1
となります
3
ad_closed
整数値、
1
は広告が閉じられたイベントを受信したことを示し、
0
は広告が閉じられていないことを示します
0
ad_closed_ts
Bigint
1657450000000
developer
文字列。インプレッションを取得した広告主の開発者。
Supersonic
ad_source_sdk_version
String
5.17.0
Copyright © 2026 Unity Technologies
法規事項プライバシーポリシークッキーDocumentation Terms of Use私の個人情報を販売または共有しないプライバシーに関する選択 (クッキー設定)

"Unity" の名称、Unity のロゴ、およびその他の Unity の商標は、米国およびその他の国における Unity Technologies またはその関係会社の商標または登録商標です (詳しくはこちら)。その他の名称またはブランドは該当する所有者の商標です。

一部のページは利便性向上のため機械翻訳を使用しており、内容に不正確な表現が含まれる場合があります。内容に齟齬または不一致が生じた場合は、英語版を正本とします。

  • このページ

    • API の使用方法

    • レポート URL の API リクエスト

      • 認証タイプ

      • メソッド

      • 必須パラメーター:

      • リクエスト例 URL

    • フィールド定義

このページの問題を報告する