Узнайте, как работает сквозная аналитика OWOX BI — запишитесь на демо

Настройка потока Google BigQuery → Яндекс.Аудитории

Обратите внимание:Поток находится в статусе открытой бета-версии и доступен бесплатно для всех тарифных планов OWOX BI. Особенности работы потока могут измениться к финальной версии. Мы будем рады любой обратной связи о работе и стабильности потока — пишите нам на bi@owox.com.

Как работает этот поток

Поток Google BigQuery → Яндекс.Аудитории автоматически загружает в Яндекс.Аудитории из вашего проекта BigQuery данные сегмента аудитории, объединенные с помощью SQL-запроса.

Данные загружаются напрямую и автоматически обновляются раз в сутки. Вам не нужно собирать их в .csv-таблицу и загружать ее вручную через интерфейс Яндекс.Аудиторий.

Что нужно для настройки потока

Прежде, чем настраивать поток, убедитесь, что у вас есть:

1. Данные, которые вы хотите объединить в сегмент аудитории, собранные в одном проекте Google BigQuery. При этом они могут находится в разных таблицах и наборах данных.

Это могут быть данные одного из четырех типов:

  • ID мобильных устройств
  • Данные из СRM
  • МАС-адреса
  • Client ID Яндекс.Метрики

2. SQL-запрос для объединения этих данных. Его нужно будет добавить в настройки потока после создания потока. Результатом запроса должен быть перечень значений через запятую, на основе которых будет сформирован сегмент. Формат значений зависит от типа данных сегмента:

Тип данных сегмента Формат значения в SQL-запросе

ID мобильных устройств

Android (GAID)
Буквенно-числовая строка в нижнем регистре, разделитель — дефис:
aaaaaaaa-bbbb-cccc-1111-222222222200

iOS (IDFA)
Буквенно-числовая строка в верхнем регистре, разделитель — дефис:
AAAAAAAAA-BBBB-CCCC-1111-222222220000

Данные из СRM

Список полей с такими значениями:

Номер телефона.
Числовая строка, содержащая номер мобильного телефона с указанием кода страны. Нельзя использовать пробелы и дополнительные символы:
79995551111

Адрес электронной почты.
Строка латиницей, включающая символ @ и имя домена. Нельзя использовать прописные буквы:
mail@yandex.ru

Client ID в CRM.
Численно-буквенная строка без пробелов и дополнительных символов.

МАС-адреса

Строка в hex-формате. MAC-адрес может быть захеширован или не захеширован. Регистр незахешированного MAC-адреса не важен. Регистр MAC-адреса до хеширования на стороне клиента также не важен.

Строка не должна содержать символы . , : -.

Незахешированный MAC-адрес:
AE123456D0A1
Захешированный MAC-адрес: C5C32C30C07ABBB7580A0925D995FEE4

Client ID Яндекс.Метрики

Список Client ID Яндекс.Метрики

 

Перед настройкой потока обязательно проверьте, правильно ли составлен запрос — для этого выполните его в BigQuery.

Обратите внимание:Сегмент Яндекс.Аудитории должен содержать не менее 1000 записей. Если результат выполнения SQL-запроса будет содержать меньше 1000 записей, то OWOX BI не сможет загрузить этот сегмент в Яндекс.Аудитории.

3. Если вы хотите построить сегмент на основе Client ID Яндекс.Метрики, вам нужно будет указать ID счетчика Яндекс.Метрики со своего сайта. Читайте в справке Яндекса, где найти ID счетчика.

Обратите внимание:Если ваш проект OWOX BI подписан на план Reports&Attribution или Enterprise, то команда OWOX BI поможет вам построить сегменты для загрузки в Яндекс.Аудитории. Для этого напишите нам на bi@owox.com или в чат поддержки.

Как настроить поток

1. На главной странице OWOX BI нажмите Создать поток:Create_pipeline_blank_ru.png

2.Выберите источник — Google BigQuery:Create_pipeline_step_1_GBQ_ru.png

3. Выберите, куда хотите загрузить данные — Яндекс.Аудитории:Create_pipeline_BQ-YA_2_ru.png

4. Укажите аккаунт для доступа к Google BigQuery. Убедитесь, что у этого аккаунта есть доступ к проекту с нужными вам данными:Create_pipeline_BQ-YA_3_ru.png

5. Выберите проект Google BigQuerу (Google Cloud Platform), в котором хранятся данные для формирования сегмента:Create_pipeline_BQ-YA_4_ru.png

6. Предоставьте доступ к аккаунту Яндекс.Аудиторий, в который хотите загружать сегмент:Create_pipeline_BQ-YA_5_ru.png

7. Укажите название сегмента. Обратите внимание, что именно так сегмент будет называться в Яндекс.Аудиториях и Яндекс.Директе:Create_pipeline_BQ-YA_6_ru.png

Здесь же укажите Тип данных, на основе которых будет сформирован сегмент для Яндекс.Аудиторий:

mceclip0.png

  • Client ID Яндекс.Метрики
  • Идентификаторы устройств (IDFA, GAID)
  • CRM-данные
  • MAC-адреса

Если вы собираете Client ID Яндекс.Метрики в таблицы с данными о поведении пользователей, то мы рекомендуем выбрать здесь Client ID Яндекс.Метрики.

Если вы выбрали Client ID Яндекс.Метрики в качестве типа данных, то вам нужно указать ID счетчика в Яндекс.Метрике:Create_pipeline_BQ-YA_8_ru.png

Где искать ID счетчика — читайте в справке Яндекса.

8. Если данные, которые вы собираетесь загружать — захешированы, включите опцию Хешированные данные:Create_pipeline_BQ-YA_8-1_ru__1_.png

Обратите внимание:Вы не сможете изменить эту настройку после создания потока. Перед созданием потока убедитесь, что все данные, которые вы хотите выгружать из Google BigQuery, — захешированы в MD5. Подробнее о требованиях к данным — в документации Яндекса.

9. Нажмите Далее. Вы попадете на страницу созданного потока. Поток будет в статусе Заблокирован.

10. Чтобы разблокировать поток, перейдите на вкладку Запрос и в поле ввода вставьте SQL-запрос, который сформирует сегмент из данных в BigQuery:Create_pipeline_BQ-YA_9_ru.png

Результатом запроса должен быть перечень идентификаторов типа, который вы указали в пункте Тип данных при настройке потока.

Прежде, чем вставлять запрос на странице потока, выполните его в BigQuery, чтобы убедиться, что запрос составлен корректно.

Обратите внимание:Сегмент Яндекс.Аудитории должен содержать не менее 1000 записей. Если результатом выполнения SQL-запроса будет содержать меньше 1000 записей, то OWOX BI не сможет загрузить этот сегмент в Яндекс.Аудитории.

11. После того, как вы указали SQL-запрос, нажмите кнопку Активировать рядом со статусом потока. В открывшемся окне нажмите Запрос готов:Create_pipeline_BQ-YA_11_ru.png

Если запрос был указан без ошибок, то поток перейдет в статус Выполняется. Это значит, что OWOX BI начал формировать сегмент. После того как сегмент сформирован, поток отправит его в Яндекс.Аудитории. Распознавание сегмента в Яндекс.Аудиториях занимает до 2-х часов.

Как только сегмент загрузится в Яндекс.Аудитории, во вкладке История на странице вашего потока появится подробная информация о загрузке сегмента:Create_pipeline_BQ-YA_10_ru.png

В этой таблице:

  • Статус Обработка сегмента Яндекс.Аудиторий значит, что сегмент в процессе распознания Яндекс.Аудиториями после обновления данных. Обычно этот статус активен до двух часов, в течение которых сегмент недоступен.
  • Статус Загрузка успешна значит, что сегмент загружен и распознан Яндекс.Аудиториями. Вы можете проверить это в интерфейсе Яндекс.Аудиторий.
  • Последние изменения — время, когда был загружен сегмент.
  • Обработано данных — объем вашего сегмента.
  • Получено строк — количество записей в сегменте.
  • Найдено уникальных строк — оценка уникальности каждой записи загруженного сегмента от Яндекс.Аудиторий.
  • Совпало строк — количество строк в сегменте, который Яндекс.Аудитории распознал. В примере на скриншоте загружен сегмент с 27 562 уникальными ClientID, из которых Яндекс.Аудитории распознал 27 101. Это значит, что реклама, может быть показана 27 101 ClientID из 27 562.

Данные сегмента в Яндекс.Аудиториях обновляются каждый день. Обратите внимание, что при каждом обновлении данные записываются заново, поэтому во время обновления сегмент может быть недоступен до двух часов.

Если вы удалите сегмент из Яндекс.Аудиторий, то OWOX BI в течение 24 часов автоматически создаст новый сегмент и загрузит в него актуальные данные из Google BigQuery. Новый сегмент будет называться так же, но у него будет другой ID. В этом случае вам нужно будет заменить старый сегмент на новый в вашем сервисе настройки рекламы.

Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 0 из 0
Еще есть вопросы? Отправить запрос

0 Комментарии

Войдите в службу, чтобы оставить комментарий.