HTML Metrics API

/playableMetrics エンドポイントは、HTML広告のパフォーマンスに関する包括的な分析データを提供します。 このAPIを使用すると、インプレッション、ユーザーインタラクション、チャレンジ達成率、エラー追跡などのアセットレベルのメトリクスをクエリできます。

HTML Metrics API

リクエスト形式

レポートのリクエストは、以下の宛先にHTTP GET リクエストを送信して行います：https://r.applovin.com/playableMetrics

必須パラメータ

パラメータ目的
api_keyお客様のレポートキー（Report Key）
レポートキーは、AppLovinダッシュボードの右上にあるアカウントをクリックし、Keys を選択することで確認できます。
columnsレポートに含めるカラムのカンマ区切りリスト
指定可能なカラムは以下を参照してください。例：day,html_name,impressions
start1レポートの開始日
«YYYY-MM-DD» 形式の日付を指定します。例：2012-10-05
end1レポートの終了日
«YYYY-MM-DD» 形式の日付を指定します。例：2012-10-05

1このAPIのリクエスト可能期間は45日間です。日付パラメータが過去45日以内であることを確認してください。

任意パラメータ

パラメータ目的
formatレポートのフォーマット
json または csv を指定できます。デフォルト：json
day_columnメトリクスはデフォルトでコホート化されます。リアルタイムのメトリクスを取得したい場合は、これを event_day に設定してください。
limit返す行数の上限。例：500（結果をページネーションするには limit と offset を使用します）
offset行の取得を開始するオフセット位置。例：100（結果をページネーションするには limit と offset を使用します）

利用可能なカラム

全般

カラム名内容
asset_idHTMLアセットの一意の識別子
average_durationHTMLインプレッションのトリム平均時間（秒単位）
countryインプレッションが発生した国または地域。
指定可能な値：
  • US: 米国
  • G1: トップティア国（GB、CA、AU、DE、FR、JP、KR）
  • G2: ミドルティア国（CN、TW、CH、NO、SE、FI、HK、SG、IE、NZ、AT、BE、DK、IT、LU、NL、ES）
  • ROW: その他の地域（Rest of World）
day«YYYY-MM-DD» 形式のレポート日付。例：2012-10-05
device_modelHTMLが表示されたデバイスのモデル。メーカーごとに上位100モデルが含まれます。指定可能な値の例：apple_promax13、samsung_sma035f、tecno_tecnokh7
html_nameHTMLアセットの名前
impressions総インプレッション数
original_urlアップロードされたHTMLファイルへのURL
os_versionオペレーティングシステムのメジャーバージョン。指定可能な値：14、15、16
platformHTMLが表示されたプラットフォーム。指定可能な値：ANDROID、IOS
spend総消費額
total_interactionsすべてのタッチアクションを含む、HTMLに対するユーザーインタラクションの総数
unique_interactionsすべてのタッチアクションを含む、HTMLに対するユーザーインタラクションの総数（インプレッションごとに重複排除）
unique_interactions_rateunique_interactions の impressions に対する割合
unique_redirectsユーザーをアプリストアにリダイレクトしたHTML内のクリック総数（1インプレッションにつき1回カウント）
unique_redirects_rateunique_redirects の impressions に対する割合

HTMLステータス

カラム名内容
html_loadingHTMLの読み込みが開始された総回数
html_loadedHTMLが正常に読み込まれた総回数
html_displayedHTMLが正常に表示された総回数
html_completedHTMLが完全に完了した総回数
html_completion_ratehtml_completed の impressions に対する割合

チャレンジメトリクス

カラム名内容
challenge_startedHTML内のチャレンジが開始された総回数
challenge_failedユーザーがHTML内のチャレンジに失敗した総回数
challenge_failed_ratechallenge_failed の impressions に対する割合
challenge_retryユーザーがHTML内のチャレンジを再試行した総回数
challenge_retry_ratechallenge_retry の impressions に対する割合
challenge_solvedユーザーがHTML内のチャレンジをクリアした総回数
challenge_solved_ratechallenge_solved の impressions に対する割合
challenge_pass_25ユーザーがHTML内のチャレンジの25%を通過した総回数
challenge_pass_25_ratechallenge_pass_25 の impressions に対する割合
challenge_pass_50ユーザーがHTML内のチャレンジの50%を通過した総回数
challenge_pass_50_ratechallenge_pass_50 の impressions に対する割合
challenge_pass_75ユーザーがHTML内のチャレンジの75%を通過した総回数
challenge_pass_75_ratechallenge_pass_75 の impressions に対する割合

リダイレクトメトリクス

カラム名内容
cta_clickedCTAボタンがクリックされた総回数
cta_click_ratecta_clicked の impressions に対する割合
endcard_shownHTMLフェーズの後にエンドカードが表示された総回数
redirect_countHTMLページ上でのリダイレクトの総回数
redirect_rateredirect_count の impressions に対する割合

ヘルスメトリクス

カラム名内容
black_view_errorHTMLページで発生したブラックビューエラーの総数
black_view_error_rateblack_view_error の impressions に対する割合
rendering_errorHTMLページで発生したレンダリングエラーの総数
rendering_error_raterendering_error の impressions に対する割合
runtime_errorHTMLページで発生したランタイムエラーの総数
runtime_error_rateruntime_error の impressions に対する割合

カラムのフィルタリング

任意のカラムでレポートをフィルタリングできます。 フィルタリングを行うと、指定したフィルターのいずれかに完全一致するデータが検索されます。

カラムでフィルタリングするには、次のURLパラメータを追加します：filter_«columnname»=«onefilter,anotherfilter,thirdfilter»

例えば、Androidプラットフォームのデータのみを表示したい場合は、次のURLパラメータを設定します：filter_platform=ANDROID

すべてのカラムの一覧については、上記の表を参照してください。

カラムのソート

レポートのソートは、フィルタリングと同様の方法で行います。

例えば、レポートを campaign でソートするには、次のURLパラメータを追加します：sort_campaign=ASC

指定可能な値は、昇順の場合は ASC、降順の場合は DESC です。 すべてのソートは辞書順（lexicographical sort）で行われます。

タイムゾーン

レポートAPIのすべてのデータはUTC（協定世界時）基準です。

リクエスト例

https://r.applovin.com/playableMetrics?api_key=«your-report-key»&start=2025-10-27&end=2025-10-27&columns=day,asset_id,html_name,impressions,unique_interactions&format=json&limit=100&sort_impressions=desc
Asset Reporting API
クリエイティブセットにクリエイティブを追加できない
© 2026 AppLovin. All rights reserved.
ポリシーセンター利用規約パブリッシャーポリシーデマンドパートナーポリシープラットフォームによる規制プライバシーYour Privacy ChoicesCPRACookieの設定
search