Method: accounts.mediationReport.generate

指定されたレポート仕様に基づいて AdMob メディエーション レポートを生成します。サーバーサイド ストリーミング RPC の結果を返します。結果は一連のレスポンスで返されます。

HTTP リクエスト

POST https://admob.googleapis.com/v1beta/{parent=accounts/*}/mediationReport:generate

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

レポートを生成するアカウントのリソース名。例: accounts/pub-9876543210987654

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "reportSpec": {
    object (MediationReportSpec)
  }
}
フィールド
reportSpec

object (MediationReportSpec)

ネットワーク レポートの仕様。

レスポンスの本文

AdMob メディエーション レポートのストリーミング レスポンス。最初のレスポンスにはレポート ヘッダー、次に行レスポンスのストリーム、最後にレスポンス メッセージとしてフッターが含まれます。

次に例を示します。

[{
  "header": {
    "dateRange": {
      "startDate": {"year": 2018, "month": 9, "day": 1},
      "endDate": {"year": 2018, "month": 9, "day": 1}
    },
    "localizationSettings": {
      "currencyCode": "USD",
      "languageCode": "en-US"
    }
  }
},
{
  "row": {
    "dimensionValues": {
      "DATE": {"value": "20180918"},
      "APP": {
        "value": "ca-app-pub-8123415297019784~1001342552",
         "displayLabel": "My app name!"
      }
    },
    "metricValues": {
      "ESTIMATED_EARNINGS": {"decimal_value": "1324746"}
    }
  }
},
{
  "footer": {"matchingRowCount": 1}
}]

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{

  // Union field payload can be only one of the following:
  "header": {
    object (ReportHeader)
  },
  "row": {
    object (ReportRow)
  },
  "footer": {
    object (ReportFooter)
  }
  // End of list of possible types for union field payload.
}
フィールド
共用体フィールド payload。各ストリーム レスポンス メッセージには、1 種類のペイロードが含まれます。payload は次のいずれかになります。
header

object (ReportHeader)

レポートの期間や地域設定など、レポートの内容を説明するレポート生成設定。
row

object (ReportRow)

実際のレポートデータ。
footer

object (ReportFooter)

データに関する警告など、生成されたレポートに関する追加情報。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/admob.readonly
  • https://www.googleapis.com/auth/admob.report

詳細については、OAuth 2.0 Overview をご覧ください。

MediationReportSpec

AdMob メディエーション レポートを生成するための仕様。たとえば、「US」と「CN」の国について、広告ソースとアプリで分類された実際の eCPM を取得するための仕様は、次の例のようになります。

{
  "dateRange": {
    "startDate": {"year": 2021, "month": 9, "day": 1},
    "endDate": {"year": 2021, "month": 9, "day": 30}
  },
  "dimensions": ["AD_SOURCE", "APP", "COUNTRY"],
  "metrics": ["OBSERVED_ECPM"],
  "dimensionFilters": [
    {
      "dimension": "COUNTRY",
      "matchesAny": {"values": [{"value": "US", "value": "CN"}]}
    }
  ],
  "sortConditions": [
    {"dimension":"APP", order: "ASCENDING"}
  ],
  "localizationSettings": {
    "currencyCode": "USD",
    "languageCode": "en-US"
  }
}

分かりやすくするため、上記の仕様を次の擬似 SQL のように扱うとよいでしょう。

SELECT AD_SOURCE, APP, COUNTRY, OBSERVED_ECPM
FROM MEDIATION_REPORT
WHERE DATE >= '2021-09-01' AND DATE <= '2021-09-30'
    AND COUNTRY IN ('US', 'CN')
GROUP BY AD_SOURCE, APP, COUNTRY
ORDER BY APP ASC;
JSON 表現 
{
  "dateRange": {
    object (DateRange)
  },
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "dimensionFilters": [
    {
      object (DimensionFilter)
    }
  ],
  "sortConditions": [
    {
      object (SortCondition)
    }
  ],
  "localizationSettings": {
    object (LocalizationSettings)
  },
  "maxReportRows": integer,
  "timeZone": string
}
フィールド
dateRange

object (DateRange)

レポートが生成される期間。
dimensions[]

enum (Dimension)

レポートのディメンションのリスト。これらのディメンションの値の組み合わせにより、レポートの行が決まります。ディメンションが指定されていない場合、レポートはアカウント全体に対してリクエストされた指標の単一行を返します。
metrics[]

enum (Metric)

レポートの指標のリスト。少なくとも 1 つの指標を選択する必要があります。
dimensionFilters[]

object (DimensionFilter)

ディメンション値に基づいてどのレポート行を一致させるかを示します。
sortConditions[]

object (SortCondition)

レポート行の並べ替えについて説明します。リスト内の条件の順序により、優先順位が決まります。条件が前にあるほど、優先順位が高くなります。並べ替え条件が指定されていない場合、行の順序は未定義となります。
localizationSettings

object (LocalizationSettings)

レポートの地域設定。
maxReportRows

integer

取得するレポートデータの最大行数。未設定の場合、API は 100,000 を上限としてできるだけ多くの行を返します。許容値は 1 ～ 100,000（1 と 100,000 を含む）です。100,000 より大きい値はエラーを返します。
timeZone

string

レポートのタイムゾーン。「America/Los_Angeles」などの IANA TZ 名の値を受け入れます。タイムゾーンが定義されていない場合は、アカウントのデフォルトが有効になります。アカウント取得アクションでデフォルト値を確認します。

警告: 現時点では、「America/Los_Angeles」のみがサポートされています。

ディメンション

メディエーション レポートのディメンション。ディメンションとは、定量的な測定（指標）を分類したり絞り込んだりするためのデータ属性（広告が配信された広告フォーマットやプラットフォームなど）です。

列挙型
DIMENSION_UNSPECIFIED 設定されていないフィールドのデフォルト値です。使用しないでください。
DATE YYYYMMDD 形式の日付（例: 20210701）。リクエストでは、指定できる時間ディメンションは 1 つまでです。
MONTH YYYYMM 形式の月（たとえば、「202107」）。リクエストでは、指定できる時間ディメンションは 1 つまでです。
WEEK YYYYMMDD 形式の週の最初の日付（たとえば、「20210701」）。リクエストでは、指定できる時間ディメンションは 1 つまでです。
AD_SOURCE 広告ソースの一意の ID（例: 「5450213213286189855」と「AdMob ネットワーク」をラベル値として使用）。
AD_SOURCE_INSTANCE 広告ソース インスタンスの一意の ID（たとえば、「ca-app-pub-1234:asi:5678」や「AdMob (default)」をラベル値として使用）。
AD_UNIT 広告ユニットの一意の ID（たとえば、「ca-app-pub-1234/8790」）。AD_UNIT ディメンションが指定されている場合、APP は自動的に含まれます。
APP モバイルアプリの一意の ID（たとえば、「ca-app-pub-1234~1234」）。
MEDIATION_GROUP メディエーション グループの一意の ID（たとえば、「ca-app-pub-1234:mg:1234」や、ラベル値としての「AdMob（デフォルト）」）。
COUNTRY 広告表示またはクリックが発生した地域の CLDR 国コード（たとえば、「US」や「FR」）。これは地理ディメンションです。
FORMAT 広告ユニットの形式（「バナー」、「ネイティブ」など）。広告配信ディメンション。
PLATFORM アプリのモバイル OS プラットフォーム（たとえば、「Android」や「iOS」）。
MOBILE_OS_VERSION モバイル オペレーティング システムのバージョン（「iOS 13.5.1」など）。
GMA_SDK_VERSION GMA SDK のバージョン（例: 「iOS 7.62.0」）。
APP_VERSION_NAME Android の場合、アプリのバージョン名は PackageInfo の versionName で確認できます。iOS の場合、アプリのバージョン名は CFBundleShortVersionString で確認できます。
SERVING_RESTRICTION 広告配信の制限モード（「パーソナライズされていない広告」など）。

指標

メディエーション レポートの指標。指標は、パブリッシャーのビジネスのパフォーマンスを示す定量的な測定値です。これらは個々の広告イベントから集計され、レポート ディメンションごとにグループ化されます。指標の値は整数または小数（丸めなし）になります。

列挙型
METRIC_UNSPECIFIED 設定されていないフィールドのデフォルト値です。使用しないでください。
AD_REQUESTS リクエストの数。値は整数です。
CLICKS ユーザーが広告をクリックした回数。値は整数です。
ESTIMATED_EARNINGS

AdMob パブリッシャーの見積もり収益額。収益指標の通貨単位（USD、EUR など）は、通貨の地域設定によって決まります。金額はマイクロ単位です。たとえば、$6.50 は 6500000 として表されます。

メディエーション グループや広告ソースのインスタンス単位の見積もり収益額は、2019 年 10 月 20 日まで遡って確認できます。2019 年 10 月 20 日より前の日付の第三者広告ネットワークの見積もり収益額は 0 円になります。
IMPRESSIONS ユーザーに広告が表示された合計回数。値は整数です。
IMPRESSION_CTR インプレッション数に対するクリック数の割合。値は倍精度（概算）の 10 進数値です。
MATCHED_REQUESTS リクエストへのレスポンスとして広告が返される回数。値は整数です。
MATCH_RATE 広告リクエストの合計数に対する一致した広告リクエスト数の割合。値は倍精度（概算）の 10 進数値です。
OBSERVED_ECPM

第三者広告ネットワークの推定平均 eCPM。収益指標の通貨単位（USD、EUR など）は、通貨の地域設定によって決まります。金額はマイクロ単位です。たとえば、$2.30 は 2300000 として表されます。

メディエーション グループや広告ソースのインスタンス単位の推定平均 eCPM は、2019 年 10 月 20 日まで遡って確認できます。2019 年 10 月 20 日より前の日付の第三者広告ネットワークの推定平均 eCPM は 0 になります。

DimensionFilter

ディメンション値に基づいてどのレポート行を一致させるかを示します。

JSON 表現 
{
  "dimension": enum (Dimension),

  // Union field operator can be only one of the following:
  "matchesAny": {
    object (StringList)
  }
  // End of list of possible types for union field operator.
}
フィールド
dimension

enum (Dimension)

指定したディメンションにフィルタ条件を適用します。
共用体フィールド operator。適用するフィルタ演算子。operator は次のいずれかになります。
matchesAny

object (StringList)

指定されたディメンションの値がこの条件で指定された値のいずれかにある場合、行に一致します。

SortCondition

ディメンションまたは指標に適用される並べ替え方向。

JSON 表現 
{
  "order": enum (SortOrder),

  // Union field sort_on can be only one of the following:
  "dimension": enum (Dimension),
  "metric": enum (Metric)
  // End of list of possible types for union field sort_on.
}
フィールド
order

enum (SortOrder)

ディメンションまたは指標の並べ替え順序。
共用体フィールド sort_on。並べ替える値を識別します。sort_on は次のいずれかになります。
dimension

enum (Dimension)

指定したディメンションで並べ替えます。
metric

enum (Metric)

指定した指標で並べ替えます。