В Google Менеджере рекламы есть SOAP API, который позволяет создавать отчеты и управлять объектами размещения рекламы, такими как LineItems.
Клиентские библиотеки доступны на нескольких языках. Как и AdX Seller API, Ad Manager API использует OAuth2 для аутентификации.
Чтобы узнать, как отправить первый запрос к API, ознакомьтесь с руководством по началу работы.
Отчеты в Ad Manager API
ReportService в Ad Manager API позволяет создавать и скачивать отчеты двумя способами:
- Создание запроса в интерфейсе и его выполнение на основе идентификатора.
- Создание специального запроса ReportQuery.
В обоих случаях рабочий процесс API состоит из четырех этапов:
- Вызовите метод runReportJob.
- Запросите статус отчета с помощью метода getReportJobStatus.
- Получите URL готового отчета с помощью метода getReportDownloadUrlWithOptions.
- Скачайте отчет по возвращенному URL.
Подробную информацию вы найдете в руководстве по отчетам.
Часовые пояса в отчетах
В отличие от Ad Exchange Seller REST API, в Ad Manager API по умолчанию используется часовой пояс вашей сети. Чтобы изменить это, задайте поле TimeZoneType.
Сопоставление параметров и показателей AdX и Менеджера рекламы
Все поддерживаемые показатели и параметры Ad Exchange Seller REST API теперь доступны в Ad Manager reporting API. Некоторые названия изменились, а некоторые были упразднены. Подробная информация приведена в таблицах ниже.
Показатели/столбцы
В таблице ниже показано, как показатели AdX соотносятся со столбцами Менеджера рекламы.
| Показатель AdX | Столбец Менеджера рекламы | Название инструмента запросов Менеджера рекламы |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | Выполненные показы с использованием Active View |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | Выполненные отслеживаемые показы Active View |
| ACTIVE_VIEW_MEASURABLE_RATIO | (устарело) | (устарело) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | Выполненные показы Active View в видимой области экрана |
| ACTIVE_VIEW_VIEWABLE_RATIO | (поддержка прекращена) | (устарело) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | Среднее время показа в видимой области (сек.) |
| AD_IMPRESSIONS | AD_EXCHANGE_IMPRESSIONS | Показы объявлений |
| AD_IMPRESSIONS_RPM | AD_EXCHANGE_AD_ECPM | Эффективная цена за тысячу показов объявления |
| AD_REQUESTS | AD_EXCHANGE_AD_REQUESTS | Запросы объявлений. |
| AD_REQUESTS_COVERAGE | AD_EXCHANGE_COVERAGE | Покрытие |
| AD_REQUESTS_CTR | AD_EXCHANGE_AD_REQUEST_CTR | CTR запросов объявлений |
| AD_REQUESTS_RPM | AD_EXCHANGE_AD_REQUEST_ECPM | Доход на тысячу запросов объявлений |
| КЛИКИ | AD_EXCHANGE_CLICKS | Клики |
| COST_PER_CLICK | AD_EXCHANGE_CPC | Цена за клик |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | Запросы объявлений по сделкам |
| DEALS_BID_RESPONSES | AD_EXCHANGE_DEALS_BID_RESPONSES | Ответы на запросы ставок в рамках сделок |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | Коэффициент соответствия по сделкам |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | Сопоставленные запросы по сделкам |
| ДОХОДЫ | AD_EXCHANGE_ESTIMATED_REVENUE | Расчетный доход |
| INDIVIDUAL_AD_IMPRESSIONS | (устарело) | (устарело) |
| INDIVIDUAL_AD_IMPRESSIONS_CTR | AD_EXCHANGE_AD_CTR | CTR объявления |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (новая рекомендация) AD_EXCHANGE_AD_ECPM | (новая рекомендация) Эффективная цена за тысячу показов объявления |
| LIFT_RATE | AD_EXCHANGE_LIFT | По возрастанию |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | Сопоставленные запросы |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_CTR | CTR |
| MATCHED_AD_REQUESTS_RPM | AD_EXCHANGE_MATCHED_ECPM | Эффективная цена за тысячу выполненных показов |
| VIDEO_AD_ABANDONMENT_RATIO | AD_EXCHANGE_VIDEO_ABANDONMENT_RATE | Коэффициент прерывания видео |
| VIDEO_AD_DROPOFF_RATIO | AD_EXCHANGE_VIDEO_DROPOFF_RATE | Показатель прерывания видео |
| VIDEO_AD_QUARTILE_ONE | AD_EXCHANGE_VIDEO_QUARTILE_1 | Квартиль 1 (видео) |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | Квартиль 3 (видео) |
| VIDEO_AD_SKIPPABLE_SKIP_RATIO | AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE | Коэффициент пропусков TrueView |
| VIDEO_AD_SKIPPABLE_VIEWS | AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS | Просмотры TrueView |
| VIDEO_AD_SKIPPABLE_VTR | AD_EXCHANGE_VIDEO_TRUEVIEW_VTR | TrueView: VTR |
Размеры
В этой таблице сопоставлены параметры AdX и параметры Менеджера рекламы.
| Параметр AdX | Параметр Менеджера рекламы | Название инструмента запросов Менеджера рекламы |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | Веб-ресурс |
| AD_LOCATION | AD_EXCHANGE_AD_LOCATION | Места размещения объявлений |
| AD_TAG_NAME | AD_EXCHANGE_TAG_NAME | Теги |
| AD_UNIT_SIZE_CODE | AD_EXCHANGE_INVENTORY_SIZE_CODE | (Not available) |
| AD_UNIT_SIZE_NAME | AD_EXCHANGE_INVENTORY_SIZE | Размеры инвентаря |
| ADVERTISER_DOMAIN | AD_EXCHANGE_ADVERTISER_DOMAIN | Домены рекламодателя |
| ADVERTISER_NAME | AD_EXCHANGE_ADVERTISER_NAME | Рекламодатели |
| ADVERTISER_VERTICAL | AD_EXCHANGE_ADVERTISER_VERTICAL | Тематики сайтов рекламодателей |
| AGENCY_NAME | AD_EXCHANGE_AGENCY | Агентства |
| BID_TYPE_CODE | AD_EXCHANGE_BID_TYPE_CODE | (Not available) |
| BRAND_NAME | AD_EXCHANGE_BRAND_NAME | Бренды |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (Not available) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | Типы брендинга |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (Not available) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | Сети покупателей |
| COUNTRY_CODE | AD_EXCHANGE_COUNTRY_CODE | (Not available) |
| COUNTRY_NAME | AD_EXCHANGE_COUNTRY_NAME | Страны |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | Размеры объявлений |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (Not available) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (Not available) |
| CUSTOM_CHANNEL_NAME | AD_EXCHANGE_CHANNEL_NAME | Каналы |
| ДАТА | AD_EXCHANGE_DATE | дней |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | Идентификаторы сделок |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | Названия сделок |
| DFP_AD_UNIT_ID | AD_EXCHANGE_DFP_AD_UNIT_ID | (Not available) |
| DFP_AD_UNITS | AD_EXCHANGE_DFP_AD_UNIT | Рекламные блоки DFP |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | Источники запросов |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | сайты; |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | Платформы DSP |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | Типы расширяемых объявлений |
| INVENTORY_OWNERSHIP | AD_EXCHANGE_INVENTORY_OWNERSHIP | Право собственности на инвентарь |
| INVENTORY_PARTNER_NAME | AD_EXCHANGE_NETWORK_PARTNER_NAME | Названия компаний-партнеров |
| MOBILE_APP_NAME | AD_EXCHANGE_MOBILE_APP_NAME | Названия приложений |
| MOBILE_CARRIER_NAME | AD_EXCHANGE_MOBILE_CARRIER_NAME | Названия операторов связи |
| MOBILE_DEVICE_NAME | AD_EXCHANGE_MOBILE_DEVICE_NAME | Устройства |
| MOBILE_INVENTORY_TYPE | AD_EXCHANGE_MOBILE_INVENTORY_TYPE | Типы инвентаря |
| MOBILE_OS_VERSION | AD_EXCHANGE_OPERATING_SYSTEM | Операционные системы |
| MOBILE_USER_BANDWIDTH | AD_EXCHANGE_USER_BANDWIDTH_NAME | Пропускная способность |
| МЕСЯЦ | AD_EXCHANGE_MONTH | Месяцы |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | Категории устройств |
| PRODUCT_CODE | AD_EXCHANGE_PRODUCT_CODE | (Not available) |
| PRODUCT_NAME | AD_EXCHANGE_PRODUCT_NAME | Товары |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (Not available) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | Типы таргетинга |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (Not available) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | Типы транзакций |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (Not available) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | URL |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (Not available) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | Продолжительность видеообъявлений |
| VIDEO_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | Типы видеообъявлений |
| НЕДЕЛЯ | AD_EXCHANGE_WEEK | Недели |
| WINNING_BID_RULE_ID | AD_EXCHANGE_PRICING_RULE_ID | (Not available) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | Правила ценообразования |