Method: accounts.mediationReport.generate

Создает отчет агрегатора AdMob на основе предоставленной спецификации отчета. Возвращает результат потокового RPC на стороне сервера. Результат возвращается в виде последовательности ответов.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
parent

string

Имя ресурса учетной записи, для которой создается отчет. Пример: account/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 Union Field. Каждое ответное сообщение потока содержит один тип полезной нагрузки. 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 .

Спецификация MediationReportSpec

Спецификация для создания отчета медиации AdMob. Например, спецификация для получения наблюдаемого ECPM с разбивкой по источнику рекламы и приложению для стран «США» и «CN» может выглядеть следующим образом:

{
  "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 )

Список метрик отчета. В отчете должна быть указана хотя бы одна метрика.

dimensionFilters[]

object ( DimensionFilter )

Описывает, какие строки отчета следует сопоставлять на основе значений их измерений.

sortConditions[]

object ( SortCondition )

Описывает сортировку строк отчета. Порядок условия в списке определяет его приоритет; чем раньше возникло условие, тем выше его приоритет. Если условия сортировки не указаны, порядок строк не определен.

localizationSettings

object ( LocalizationSettings )

Настройки локализации отчета.

maxReportRows

integer

Максимальное количество возвращаемых строк данных отчета. Если значение не задано, API возвращает максимально возможное количество строк, до 100 000. Допустимые значения: 1–100 000 включительно. Значения больше 100000 возвращают ошибку.

timeZone

string

Часовой пояс отчета. Принимает значения имени IANA TZ, например «America/Los_Angeles». Если часовой пояс не определен, вступает в силу значение по умолчанию для учетной записи. Проверьте значение по умолчанию с помощью действия получения учетной записи.

Предупреждение: «Америка/Лос-Анджелес» — единственное поддерживаемое значение на данный момент.

Измерение

Размеры отчета о посредничестве. Измерения – это атрибуты данных, позволяющие разбить или уточнить количественные измерения (показатели) по определенным атрибутам, таким как формат объявления или платформа, на которой было просмотрено объявление.

Перечисления
DIMENSION_UNSPECIFIED Значение по умолчанию для неустановленного поля. Не используйте.
DATE Дата в формате ГГГГММДД (например, «20210701»). В запросах можно указать не более одного измерения времени.
MONTH Месяц в формате ГГГГММ (например, «202107»). В запросах можно указать не более одного измерения времени.
WEEK Дата первого дня недели в формате ГГГГММДД (например, «20210701»). В запросах можно указать не более одного измерения времени.
AD_SOURCE Уникальный идентификатор источника объявлений (например, "5450213213286189855" и "Сеть AdMob" в качестве значения метки).
AD_SOURCE_INSTANCE Уникальный идентификатор экземпляра источника объявления (например, "ca-app-pub-1234:asi:5678" и "AdMob (default)" в качестве значения метки).
AD_UNIT Уникальный идентификатор рекламного блока (например, ca-app-pub-1234/8790). Если указано измерение AD_UNIT, то APP включается автоматически.
APP Уникальный идентификатор мобильного приложения (например, «ca-app-pub-1234~1234»).
MEDIATION_GROUP Уникальный идентификатор группы медиации (например, "ca-app-pub-1234:mg:1234" и "AdMob (по умолчанию)" в качестве значения метки).
COUNTRY Код страны CLDR места, где происходят просмотры/клики объявлений (например, «США» или «FR»). Это географическое измерение.
FORMAT Формат рекламного блока (например, «Баннер», «Нативный»), параметр показа рекламы.
PLATFORM Платформа мобильной ОС приложения (например, «Android» или «iOS»).
MOBILE_OS_VERSION Версия мобильной операционной системы, например «iOS 13.5.1».
GMA_SDK_VERSION Версия GMA SDK, например «iOS 7.62.0».
APP_VERSION_NAME Для Android имя версии приложения можно найти в поле versionName в PackageInfo. Для iOS имя версии приложения можно найти в CFBundleShortVersionString.
SERVING_RESTRICTION Режим ограничения показа рекламы (например, «Неперсонализированная реклама»).

Метрика

Метрики отчета о медиации. Метрики — это количественные измерения, показывающие, как работает издательский бизнес. Они объединяются из отдельных рекламных событий и группируются по параметрам отчета. Значение метрики может быть целым или десятичным (без округления).

Перечисления
METRIC_UNSPECIFIED Значение по умолчанию для неустановленного поля. Не используйте.
AD_REQUESTS Количество запросов. Значение является целым числом.
CLICKS Сколько раз пользователь нажимает на объявление. Значение является целым числом.
ESTIMATED_EARNINGS

Ориентировочный доход издателя AdMob. Валютная единица (доллар США, евро или другая) показателей дохода определяется настройкой локализации валюты. Сумма указана в микронах. Например, 6,50 доллара США будут представлены как 6500000.

Ориентировочный доход на группу медиации и на уровень экземпляра источника объявлений поддерживается начиная с 20 октября 2019 г. Ориентировочный доход сторонних поставщиков будет равен 0 для дат, предшествующих 20 октября 2019 г.

IMPRESSIONS Общее количество объявлений, показанных пользователям. Значение является целым числом.
IMPRESSION_CTR Соотношение кликов и показов. Значение представляет собой десятичное значение двойной точности (приблизительное).
MATCHED_REQUESTS Сколько раз объявления возвращаются в ответ на запрос. Значение является целым числом.
MATCH_RATE Отношение совпадающих запросов объявлений к общему количеству запросов объявлений. Значение представляет собой десятичное значение двойной точности (приблизительное).
OBSERVED_ECPM

Расчетная средняя эффективная цена за тысячу показов сторонней рекламной сети. Валютная единица (доллар США, евро или другая) показателей дохода определяется настройкой локализации валюты. Сумма указана в микронах. Например, 2,30 доллара США будут представлены как 2300000.

Расчетная средняя эффективная цена за тысячу показов для группы медиации и уровня экземпляра источника объявлений поддерживается начиная с 20 октября 2019 года. Расчетная средняя эффективная цена за тысячу показов сторонних поставщиков будет равна 0 для дат до 20 октября 2019 года.

Фильтр размеров

Описывает, какие строки отчета следует сопоставлять на основе значений их измерений.

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 )

Соответствует строке, если ее значение для указанного измерения находится в одном из значений, указанных в этом условии.

Условие сортировки

Направление сортировки, применяемое к измерению или показателю.

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 )

Сортировка по указанному показателю.