AdMob API では、次のレポートを生成できます。
- ネットワーク レポート
- ネットワーク レポートには AdMob のパフォーマンスに関するデータが表示され、AdMob 管理画面のネットワーク レポートと同じデータが生成されます。
- メディエーション レポート
- メディエーション レポートには第三者のパフォーマンスが含まれます。メディエーション レポートについてよく知らない場合は、ヘルプセンターの記事をご覧ください。
ディメンション
レポートでは、ディメンションはグループ化のために使用されます。ディメンションが指定されていない場合は、アカウント全体に対してリクエストされた指標が 1 行で返されます。レポートにはさまざまなディメンションがあります。詳しくは、ネットワーク レポートとメディエーション レポートのディメンションをご覧ください。
例:
| レポートタイプ | ディメンション | 説明 |
|---|---|---|
| メディエーション レポート | AD_SOURCE | 広告ソースの一意の ID（例: 「5450213213286189855」、ラベル値として「AdMob Network」）。 |
| ネットワーク レポート | AD_TYPE | 広告のタイプ（「テキスト」、「画像」など）。 |
指標
指標は、そのデータで実施できるさまざまな測定を表します。レポートがリクエストされると、選択したディメンションに応じて指標が計算されます。レポートには少なくとも 1 つの指標を含める必要があります。各レポートにはさまざまな指標があります。詳しくは、ネットワーク レポートとメディエーション レポートの指標をご覧ください。
例:
| レポートタイプ | 指標 | 説明 |
|---|---|---|
| メディエーション レポート | OBSERVED_ECPM | 第三者広告ネットワークの推定平均 eCPM。 |
| ネットワーク レポート | SHOW_RATE | 返された広告に対して表示された広告の割合（インプレッション数 ÷ 一致したリクエスト数）。値は倍精度（近似）10 進値です。 |
フィルタ
フィルタを使用すると、フィルタするディメンションとフィルタ式を指定することで、レポートに含める行を制限できます。
たとえば、以下のフィルタをメディエーション レポートに適用すると、Meta Audience Network のパフォーマンスを表示できます。メディエーション レポートで確認できる広告ソースのリストをご確認ください。
| ディメンション フィルタ | フィルタ式 | 説明 |
|---|---|---|
| AD_SOURCE | matchAny = {10568273599589928883} | 広告ソースに基づいてレポートの行をフィルタします。 |
レポートの制限を減らす
レポートの行数の上限は 100,000 です。100,000 行を超えるレポートがリクエストされると、レポートは切り捨てられ、最初の 100,000 行が返されます。レスポンスの形式について詳しくは、レポート レスポンスの本文をご覧ください。
すべての行が届くようにするには、レポートのサイズを次のように小さくします。
- リクエストの期間を短くする。
- 調整因子として機能する次元の数を減らします。ディメンションを追加すると行数は増えますが、レポートに新しい指標を追加すると新しい列が生成されます。