Передача данных в Ad Exchange: руководство для продавцов

Функция передачи данных предоставляет отчеты по транзакциям пользователя в Ad Exchange на уровне событий. Сведения в отчетах по передаче данных относятся к периоду до фильтрации недействительных кликов.

Google Cloud Storage

Отчеты по передаче данных отправляются с помощью Google Cloud Storage. Сведения в отчетах указываются по тихоокеанскому времени. Для доступа к отчетам не требуется аккаунт Google Cloud Storage. Достаточно выбрать пользователей Ad Exchange, которые должны получать статистику.
Скачивать отчеты можно в браузере, выполнив вход в наш сервис на странице sandbox.google.com/storage, или при помощи следующих инструментов:

Подробнее о входе в Google Cloud Storage...

Google Storage Manager не позволяет создавать отчеты по передаче данных: в нем лишь представлены принадлежащие вам сегменты.

Оповещения

Когда создается очередной файл отчета по передаче данных, пользователям, имеющим доступ к Google Cloud Storage, поступает по электронной почте сообщение со следующими сведениями:

  • названия файлов отчетов;
  • сегмент Google Cloud Storage, в котором содержатся файлы;
  • ссылки, по которым можно скачать отчеты с помощью браузера.

Анализ отчетов по передаче данных

Все отчеты по передаче данных предоставляются в формате CSV. Существуют два типа таких отчетов:

  • Число показов и кликов
    Сведения о показах, выполненных на вашем ресурсе, и связанных с ними кликах. Этот отчет отправляется в виде нескольких файлов каждый час.
  • Атрибуты рекламного места
    Сведения об атрибутах рекламного места. Для наследуемых атрибутов предлагаются настройки на уровне ресурса и дополнительные настройки для каждого рекламного места (объединив их, можно получить полный список атрибутов для определенного рекламного места). Этот отчет отправляется в отдельном файле один раз в день.

Каждая строка в файле отчета по передаче данных относится к одной транзакции в Ad Exchange. Чтобы получить дополнительные сведения о любой транзакции, разверните представленные ниже разделы.

Поля, помеченные как необязательные, могут отсутствовать. В таком случае в отчете они будут пустыми. В отчетах используются два варианта логических значений: true и false. Значения типа integer/float указываются в десятичном представлении.
Число показов и кликов
Пример:
TOEw6QAElpQK2l8H8LRh9g,2016-05-17 05:08:57,true,Some Buyer Network, www.examplesite.com,54321.anonymous.google,http://www.examplesite.com/examplepath?%2Cxxx&nodebug=1,false,true,true,,docvertical::258,Sports,4,123456789, 0.00140351999645645,0.649999,false,false,1,0,0,Some DSP,Some Advertiser
Поле Описание Тип Обязательное?
query_id Уникальный идентификатор запроса объявления. string Да
datetime Дата и время получения запроса (по тихоокеанскому времени). string Да
is_anonymous Указывает, был ли показ анонимным. boolean Нет
buyer Имя покупателя, победившего на аукционе. В случае с пакетами видео будет представлен список победивших рекламодателей, перечисленных через знак плюса (+). string Нет
DEPRECATED_sitename Следует использовать поле referer_url. string Нет
anonymous_id Анонимный идентификатор. Используется в случае, если значение is_anonymous=true. string Нет
referer_url URL данного запроса объявления. string Нет
allow_data_collection_for_interest_targeting Указывает, разрешен ли для данного показа сбор данных для таргетинга по интересам. boolean Нет
allow_user_list_targeting Указывает, разрешен ли для данного показа таргетинг по списку пользователей. boolean Нет
allow_user_interest_targeting Указывает, разрешен ли для данного показа таргетинг по интересам пользователей. boolean Нет
matched_geo_list Список географических кодов, перечисленных через знак плюса (+), в соответствии с ISO 3166-1 и ISO 3166-2. string Нет
matched_verticals_list Категории издателей, указанные в формате docvertical::xxx, где xxx – цифровые коды. В качестве разделителя используется знак плюса (+). string Нет
channels Названия каналов отслеживания, перечисленные через знак плюса (+). string Нет
ad_type Следует интерпретировать как битовый массив.
ad_type и 0x1 указывают, относится ли показ к текстовому объявлению.

ad_type и 0x2 указывают, относится ли показ к статическому или динамическому графическому объявлению.

ad_type и 0x4 указывают, относится ли показ к объявлению другого типа.
int32 Нет
client_ip УСТАРЕВШИЕ ПОЛЯ
IP-адрес, с которого был получен данный запрос. Для обеспечения конфиденциальности клиента последний октет заменяется нулем.
string Нет
adslot_code Идентификатор тега Ad Exchange. string Нет
seller_impression_revenue_usd Доход издателя от данного показа (в долларах США). double Нет
seller_reserve_price_usd Резервированная цена за тысячу показов (в долларах США). double Нет
was_userlist_targeted Указывает, применялся ли для показа таргетинг по списку пользователей. boolean Нет
was_match_on_keyword Указывает, было ли совпадение с ключевым словом. boolean Нет
num_clicks Указывает, был ли засчитан клик. Относится к типу boolean, то есть может принимать только два значения: 0 или 1. int32 Да
transaction_type Тип транзакции (0 = открытый аукцион, 1 = приоритетная сделка, 2 = частный аукцион, 3 = гарантированная алгоритмическая продажа, 4 = право первого выбора). int32 Нет
deal_ids Идентификаторы сделок с выигранными показами, перечисленные через знак плюса (+). string Нет
buyer_network_names Названия сетей платформ покупателя, перечисленные через знак плюса (+). string Нет
advertiser Имена рекламодателей, победивших на аукционе, перечисленные через знак плюса (+). string Нет
Атрибуты рекламного места
Пример
ca-pub-123456789,property_wide,26+110+9+12+1+55+5+11+6+57+17+8+113+60+2+65+7+69+70+4+18+13+3+14+92+94+19+96,,firstblockedurl.com+secondblockedurl.com+thirdblockedurl.com

ca-pub-123456789,987654321,,10,
Поле Описание Тип Требуется
property_code Код ресурса Ad Exchange. string Да
adslot_code Идентификатор тега Ad Exchange.

Значение site_wide означает, что использовалась настройка на уровне аккаунта или ресурса Ad Exchange.
string Да
allowed_vendor_types

Цифровые коды поставщиков, перечисленные через знак плюса (+). Это поле не относится к сделкам с переопределением правил блокировки.

Дополнительные сведения представлены в протоколе назначения ставок в реальном времени.

string Нет
allowed_video_formats Форматы видеофайлов, перечисленные через знак плюса (+). Дополнительные сведения представлены в содержании протокола назначения ставок в реальном времени. string Нет
blocked_urls Блокируемые URL, перечисленные через знак плюса (+). string Нет
Эта информация оказалась полезной?
Как можно улучшить эту статью?