Google Ad Manager предлагает API-интерфейс SOAP для создания отчетов и управления объектами трафика, такими как LineItems . Клиентские библиотеки доступны на нескольких языках. Как и API продавца AdX, API Менеджера рекламы использует для аутентификации OAuth2.
Чтобы начать работу с первым запросом API, см. раздел «Начало работы» .
Отчеты в API Менеджера рекламы
Служба ReportService API Менеджера рекламы предлагает два способа запуска и загрузки отчетов:
- Создание запроса в пользовательском интерфейсе и его запуск на основе его идентификатора.
- Создание специального ReportQuery .
В любом случае рабочий процесс API состоит из четырех этапов:
- Вызовите runReportJob .
- Опросите статус отчета с помощью getReportJobStatus .
- Получите URL-адрес завершенного отчета, используя getReportDownloadUrlWithOptions .
- Загрузите отчет по возвращенному URL-адресу.
Более подробную информацию можно найти в руководстве по составлению отчетов .
Отчеты о часовых поясах
В отличие от REST API Ad Exchange Seller, в отчетах API Менеджера рекламы по умолчанию используется часовой пояс вашей сети. Чтобы изменить это, установите поле TimeZoneType .
Сопоставление показателей и параметров AdX с Менеджером рекламы
Все поддерживаемые показатели и параметры REST API Ad Exchange Seller теперь присутствуют в API отчетов Менеджера рекламы. Некоторые имена были изменены, а некоторые устарели. Подробности смотрите в таблицах ниже.
Метрики/столбцы
В этой таблице показатели AdX сопоставлены со столбцами Менеджера рекламы .
| Метрика Ad Exchange | Столбец Менеджера рекламы | Название инструмента запросов Менеджера рекламы |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | Показы с активным просмотром |
| 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_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 |
Размеры
В этой таблице параметры AdX сопоставлены с параметрами Менеджера рекламы .
| Параметр Ad Exchange | Параметр Менеджера рекламы | Название инструмента запросов Менеджера рекламы |
|---|---|---|
| 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 | (Нет в наличии) |
| AD_UNIT_SIZE_NAME | AD_EXCHANGE_INVENTORY_SIZE | Размеры инвентаря |
| ADVERTISER_DOMAIN | AD_EXCHANGE_ADVERTISER_DOMAIN | Домены рекламодателей |
| РЕКЛАМОДАТЕЛЬ_ИМЯ | AD_EXCHANGE_ADVERTISER_NAME | Рекламодатели |
| РЕКЛАМОДАТЕЛЬ_ВЕРТИКАЛ | AD_EXCHANGE_ADVERTISER_VERTICAL | Вертикали рекламодателей |
| АГЕНТСТВО_ИМЯ | AD_EXCHANGE_AGENCY | Агентства |
| БИД_ТИП_КОД | AD_EXCHANGE_BID_TYPE_CODE | (Нет в наличии) |
| ИМЯ БРЕНДА | AD_EXCHANGE_BRAND_NAME | Бренды |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (Нет в наличии) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | Типы брендинга |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (Нет в наличии) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | Сети покупателей |
| КОД СТРАНЫ | AD_EXCHANGE_COUNTRY_CODE | (Нет в наличии) |
| ИМЯ СТРАНЫ | AD_EXCHANGE_COUNTRY_NAME | Страны |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | Размеры объявлений |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (Нет в наличии) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (Нет в наличии) |
| 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 | (Нет в наличии) |
| DFP_AD_UNITS | AD_EXCHANGE_DFP_AD_UNIT | Рекламные блоки DFP |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | Источники запроса |
| ДОМЕННОЕ ИМЯ | AD_EXCHANGE_SITE_NAME | Места |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | DSP |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | Расширяемые типы |
| ИНВЕНТОРАЦИЯ_ВЛАДЕНИЕ | AD_EXCHANGE_INVENTORY_OWNERSHIP | Право собственности на инвентарь |
| INVENTORY_PARTNER_NAME | AD_EXCHANGE_NETWORK_PARTNER_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 | Типы инвентаря |
| МОБИЛЬНАЯ_ОС_ВЕРСИЯ | AD_EXCHANGE_OPERATING_SYSTEM | Операционные системы |
| MOBILE_USER_BANDWIDTH | AD_EXCHANGE_USER_BANDWIDTH_NAME | Пропускная способность |
| МЕСЯЦ | AD_EXCHANGE_MONTH | Месяцы |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | Категории устройств |
| КОД ПРОДУКТА | AD_EXCHANGE_PRODUCT_CODE | (Нет в наличии) |
| НАИМЕНОВАНИЕ ТОВАРА | AD_EXCHANGE_PRODUCT_NAME | Продукты |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (Нет в наличии) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | Типы таргетинга |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (Нет в наличии) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | Типы транзакций |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (Нет в наличии) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | URL-адреса |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (Нет в наличии) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | Продолжительность видеорекламы |
| ВИДЕО_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | Типы видеообъявлений |
| НЕДЕЛЯ | AD_EXCHANGE_WEEK | Недели |
| WINNING_BID_RULE_ID | AD_EXCHANGE_PRICING_RULE_ID | (Нет в наличии) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | Правила ценообразования |