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 | Правила ценообразования |