На данный момент доступно создание потока по выгрузке расходов из системы Яндекс Директ в Google BigQuery.
Из-за особенностей API Яндекс отдает расходы двумя отчетами:
- Статистика. В этом отчете передается вся информация о расходах
- Контент. В этом отчете передаются url объявления
Для получения и объединения двух этих отчетов необходимо использовать определенный набор данных, подробнее в первом шаге настроек потока.
Первоначально необходимо зайти в систему Garpun Feeds https://feeds.garpun.com/ под своим логином и паролем и нажать кнопку "+Поток данных".
Алгоритм создания потока из системы Я.Директ в BQ:
1) Источник данных > Приемник данных
В открывшемся меню выбираем:
- Источник данных - Yandex Direct,
- Приемник данных - Google BQ
Набор данных "Загрузка расходов в BQ". Преимущество этого набора данных в том, что в результирующую таблицу будут добавлены поля utm_cource, utm_medium, utm_campaign, utm_term и utm_content, содержащие соответствующие метки. Это поможет более детально анализировать трафик и расходы.
2) Настройка источника данных
- Выбираем необходимое подключение, либо добавляем новое
- Указываем логин рекламного аккаунта, с которого собирается статистика. По нажатию на кнопку "+ Добавить" можно добавлять логины, однако просим учесть, что каждый новый логин будет тарифицироваться как отдельный поток, т.к. для каждого логина нужно отправлять отдельный запрос в Яндекс.
Необязательные настройки:
Передавать показы и клики без расхода
Необходим если нужно выкачивать всю статистику. По умолчанию система игнорирует ситуации когда по объявлениям нет расходов, даже если есть показы и клики. Но в некоторых случаях это может приводить к потере данных, именно для таких случаев была сделана данная настройка.
Полный пересбор каждую неделю
Настройка устанавливает полный пересбор раз в неделю. Полезно для кампаний где происходят частые изменения. Так же полезно в случаях использования объемных кампаний с большими расходами. Яндекс обладает своей внутренней системой защиты. Алгоритм проверяет различные условия и убирает из расходов ботов и "скликивание". Это происходит в течении 30 дней после формирования отчета в самом Яндексе, поэтому рекомендуется проверять статистику каждый месяц, так как значения в Яндексе спустя 30 дней могут оказаться меньше, чем значения полученные в первый день
Не транслитерировать название кампании
В API Яндекс.Директ не были реализованы методы получения контента объявлений для кампаний, созданных через мастер-кампаний. Для того, чтоб избежать not-set в статистике, берется название кампании из статистики и к этому названию применяется алгоритм транслитерации.
Алгоритм транслитерации запускается по умолчанию, вне зависимости латиницией или кириллицей записано название кампании. Для того, чтоб избежать "некрасивых" названий, реализована опция отключения транслитерации, но обязательно нужно убедиться, что все названия не требуется переводить в формат, который принимает Аналитика, т.е. названия кампаний на латинице.
Метки по умолчанию
Метки так же используются, если по каким-либо причинам мы не получаем эти метки из API Директа. Их необходимо проставить, чтобы система могла использовать их когда нужно привязать расходы без меток. Если говорить кратко, то все расходы, по которым мы не получили метки из Директа будут промечены указанными значениями. По умолчанию используется utm_source=yandex, utm_medium=cpc
Кастомные метки
Для некоторых типов кампаний (смартбаннеры, динамические объявления и т.д.) нельзя скачать метки из API Yandex Direct, поэтому, для распределения расходов по кампаниям, нужно вручную задать метки. Это так же касается объявлений мастера кампаний.
По всем этим кампаниям мы не получаем контент объявлений. Без контента, не имея ссылок из объявления, система не может разбить данные по меткам. Чтобы избежать потери данных, алгоритм берет название кампании из Яндекса, транслитерирует его, использует полученное имя как метку и передает данные в Аналитику.
Чтобы избежать транслитерации нужно использовать кастомные метки, либо отключить алгоритм транслитерации при помощи соответствующей опции.
3) Настройка приемника данных
- Выбираем подключение Google BQ, либо добавляем подключение через кнопку "+Добавить"
- Указываем Project ID в BigQuery
- Указываем dataset. Не обязательно создавать Dataset вручную в самом BigQuery, можно ввести название вручную - Dataset будет создан автоматически при запуске потока.
- В качестве способа записи данных в таблицу оставляем обновление
4) Общие настройки
- В графе “Название потока” ввести название либо оставить сгенерированное автоматически
- В графе “Период сбора при автоматическом запуске” можно выбрать за какой период поток будет пересобирать статистику. По умолчанию - 30 дней.
- В графе “Расписание” - выбрать например 7:00 утра, в это время поток будет запускаться ежедневно
- Нажать "Готово"
В качестве итоговой таблицы мы получаем таблицу со следующей схемой:
Итоговая схема
| Название | Описание |
| ad_format | Формат показа объявления: IMAGE — графический. TEXT — текстовый. VIDEO — видео. SMART_MULTIPLE — смарт-баннер. SMART_SINGLE — смарт-объявление. ADAPTIVE_IMAGE — адаптивный графический. SMART_TILE — смарт-плитка.
|
| ad_group_id | Идентификатор группы объявлений. Не отображается в отчете по кампаниям, созданным в Мастере кампаний. |
| ad_group_name | Название группы объявлений. Не отображается в отчете по кампаниям, созданным в Мастере кампаний. |
| ad_id | Идентификатор объявления. Не отображается в отчете по кампаниям, созданным в Мастере кампаний. |
| ad_network_type | Тип площадки, где показано объявление: SEARCH — на поиске; AD_NETWORK — в сетях.
|
| age | Возрастная группа пользователя: одно из значений AGE_0_17, AGE_18_24, AGE_25_34, AGE_35_44, AGE_45, AGE_45_54, AGE_55 или UNKNOWN. |
| avg_click_position | Средняя позиция, на которой произошел клик по объявлению. При расчете учитываются только клики на первой странице результатов поиска Яндекса. Наивысшая позиция имеет номер 1. |
| avg_effective_bid | Средняя ставка за клик с учетом всех корректировок. Данные доступны только для кампаний с оплатой за клик. |
| avg_impression_position | Средняя позиция показа объявления. При расчете учитываются только показы на первой странице результатов поиска Яндекса. Наивысшая позиция имеет номер 1. |
| campaign_id | Идентификатор кампании. |
| campaign_name | Название кампании. |
| campaign_url_path | URL-адрес, указанный в настройках рекламной кампании. |
| campaign_type | Тип кампании: TEXT_CAMPAIGN MOBILE_APP_CAMPAIGN DYNAMIC_TEXT_CAMPAIGN SMART_CAMPAIGN MCBANNER_CAMPAIGN CPM_BANNER_CAMPAIGN CPM_DEALS_CAMPAIGN CPM_FRONTPAGE_CAMPAIGN CPM_PRICE UNIFIED_CAMPAIGN
|
| clicks | Количество кликов. |
| cost | Стоимость кликов. |
| criteria | Название или текст условия показа: Для показа по ключевой фразе или синониму — фраза с идентификатором. Для показа по автотаргетингу — значение «---autotargeting». Для показа по дополнительной релевантной фразе: пустое значение, если тип отчета — CUSTOM_REPORT; текст дополнительной релевантной фразы, если тип отчета — SEARCH_QUERY_PERFORMANCE_REPORT.
Для показа по условию нацеливания на аудиторию — название условия ретаргетинга и подбора аудитории или название интереса к категории мобильных приложений. Для показа динамического объявления — название условия нацеливания для динамических объявлений или название фильтра. Для показа смарт-баннера — название фильтра.
Неявно происходит группировка по CriteriaId. |
| criteria_id | Идентификатор условия показа: Для показа по ключевой фразе или синониму — идентификатор фразы. Для показа по автотаргетингу — идентификатор автотаргетинга. Для показа по дополнительной релевантной фразе — прочерк. Для показа по условию нацеливания на аудиторию — идентификатор условия нацеливания на аудиторию. Для показа динамического объявления — идентификатор условия нацеливания для динамических объявлений или идентификатор фильтра. Для показа смарт-баннера — идентификатор фильтра.
Не отображается в отчете по кампаниям, созданным в Мастере кампаний. |
| criteria_type | Тип условия показа, заданного рекламодателем: KEYWORD — ключевая фраза. AUTOTARGETING — автотаргетинг. AUDIENCE_TARGET — условие нацеливания на аудиторию. DYNAMIC_TEXT_AD_TARGET — условие нацеливания для динамических объявлений или фильтр для динамических объявлений. SMART_BANNER_FILTER — фильтр для смарт-баннеров.
|
| date | Дата, за которую приведена статистика, в формате YYYY-MM-DD. |
| device | Тип устройства, на котором было показано объявление: DESKTOP, MOBILE или TABLET. |
| gender | Пол пользователя: GENDER_MALE, GENDER_FEMALE или UNKNOWN. |
| impressions | Количество показов |
| location_of_presence_id | Идентификатор региона местонахождения пользователя |
| location_of_presence_name | Название региона местонахождения пользователя |
| match_type | Тип соответствия ключевой фразе: RELATED_KEYWORD — показ по дополнительной релевантной фразе. SYNONYM — показ по семантическому соответствию ключевой фразы. KEYWORD — показ по ключевой фразе. NONE — в остальных случаях.
|
| mobile_platform | Тип операционной системы: ANDROID, IOS, OTHER или UNKNOWN. |
| placement | Название площадки показов. |
| rl_adjustment_id | Идентификатор условия ретаргетинга и подбора аудитории, в соответствии с которым применена корректировка ставок для целевой аудитории. |
| slot | Блок показа объявления: ALONE — эксклюзивное размещение; PREMIUMBLOCK — спецразмещение; SUGGEST — реклама в саджесте; PRODUCT_GALLERY — товарная галерея; OTHER — другие блоки.
|
| targeting_category | Категория таргетинга: EXACT — целевые запросы. Рекламное объявление точно отвечает на запросы пользователя; ALTERNATIVE — альтернативные запросы. Пользователь ищет продукт, который можно заменить рекламируемым. При этом объявление также может удовлетворить запрос; COMPETITOR — запросы с упоминанием конкурентов. Поиск рекламируемого продукта у конкурентов; BROADER — широкие запросы. Запросы с интересом к продукту, примером которого является рекламное предложение; ACCESSORY — сопутствующие запросы. Запросы по продуктам, которые могут быть интересны вместе с рекламируемым товаром или услугой.
|
| targeting_location_id | Идентификатор региона таргетинга. В случае использования расширенного геотаргетинга может отличаться от региона местонахождения пользователя, см. раздел Регионы показа помощи Директа. |
| targeting_location_name | Название региона таргетинга. |
| yandex_client_login | Логин главного представителя клиента. |
| source | utm_source из url |
| medium | utm_medium из url |
| campaign | utm_campaign из url |
| term | utm_term из url |
| content | utm_content из url |