Интеграция Roistat с Яндекс.Директ

Подключение Яндекс.Директ к системе Roistat позволяет:

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

Несколько проектов могут подключаться к одному аккаунту Яндекс.Директ.

Таблица по взаимодействию Roistat с разными типами кампаний Яндекс.Директа

Название типа кампанийСистемное название (в Яндекс.Директе)Может ли Roistat автоматически разметитьЗагружает ли Roistat расход по рекламным каналамРекомендации по работе с типом кампаний
Текстово-графические
(за исключением видео)
TEXT_CAMPAIGN
(за исключением CPC_VIDEO_AD)
++

Включить кампании с таким типом в настройках рекламного канала.


Объявления будут размечаться автоматически.


Расходы по объявлениям подгружаются автоматически.

МобильныеMOBILE_APP_CAMPAIGN ++
ДинамическиеDYNAMIC_TEXT_CAMPAIGN++
Смарт-баннерыSMART_BANNER_CAMPAIGN-+

Самостоятельно разметить меткой Roistat.
Расходы будут загружаться автоматически.

(warning) Для данных типов кампаний нет возможности использовать
UTM-метки вместо меток Roistat

Медийно-контекстные баннеры
(баннеры на поиске)
MCBANNER_CAMPAIGN-+
МедийныеCPM_BANNER_CAMPAIGN--

Самостоятельно разметить с помощью UTM-меток.

Ввести вручную расход.

Подробное описание типов кампаний читайте в документации Яндекс.Директ.

(warning) По кампаниям типа "Смарт-баннеры" и "Медийно-контекстные баннеры" Roistat отображает в отчетах на уровне объявлений только ID объявлений. Это связано с ограничениями со стороны Яндекс.Директа. Для анализа конкретных объявлений вы по прежнему сможете перейти по ним по ссылке.

(warning)  Яндекс.Директ по API передает расход в часовом поясе Москвы (UTC+3). Чтобы у вас совпадал расход в Аналитике Roistat и в Яндекс.Директ, в профиле Roistat укажите часовой пояс Москвы (UTC+3).

(warning) Отображение расходов по рекламным каналам зависит в том числе и от часового пояса, указанного в настройках вашего аккаунта Roistat. Если в Яндекс.Директе  расходы отображаются в часовом поясе +3, а в аккаунте Roistat выбран часовой пояс +5, то из-за этого возникнет разница в расходах между рекламным кабинетом и проектом Roistat.

(warning) Roistat не работает с Яндекс.Видео.

(warning) Не переносите в архив кампании, информация по которым еще не загрузились в Roistat. Это приведет к потере данных.

Шаг 1. Проверка/настройка доступа в Яндекс.Директ

К Roistat подключаются клиентские аккаунты Яндекс.Директ.

Если ваш аккаунт ведет агентство, подключиться к Roistat вы можете самостоятельно или через агентство.

Чтобы подключить рекламный канал Яндекс.Директ к вашему проекту в Roistat, у вас должны быть:

  1. права на редактирование рекламных кампаний — необходимы для того, чтобы Roistat смог разметить все объявления меткой roistat после подключения аккаунта. Метка roistat имеет следующий формат:

roistat=direct[channel_id]_{source_type}_{banner_id}_{keyword}&roistat_referrer={source}&roistat_pos={position_type}_{position}
где [channel_id] - это id рекламного канала в системе Roistat.

  2. доступ к API необходим, чтобы настраивать взаимодействие Яндекс.Директ и Roistat с помощью API.


У такого аккаунта Яндекс.Директа права на редактирование рекламных кампаний уже есть автоматически.

Доступ к API возможен только для пользователей Профессионального веб-интерфейса.

Подробнее о том, как сменить интерфейс Яндекс.Директ, читайте в документации Яндекс.Директ  в соответствующем разделе.


Проверить доступ и включить API можно в вашем аккаунте, перейдя на страницу настроек API по ссылке  https://direct.yandex.ru/registered/main.pl?cmd=apiSettings, или выполнить несколько шагов, описанных ниже.

Чтобы проверить статус доступа к API, необходимо:

1. Зайти в свой аккаунт Яндекс.Директ.

 
2. В верхнем меню выбрать пункт API .

Если на открывшейся странице вы видите строку Программный доступ:  открыт :

… это значит, что функциональность API уже включена, и вы можете переходить к следующему шагу Добавление канала в систему .


Если у вас открылась такая страница:

… это значит, что вы еще не включали API.


Чтобы включить API, необходимо:

1. Нажать ссылку Получить доступ к API :

  2. Откроется Пользовательское Соглашение функциональности API Сервиса Яндекс.Директ . После его прочтения установите переключать в положение Согласен и нажмите кнопку Принять соглашение :


  3. После этого вы будете автоматически перенаправлены на страницу управления доступом к API, где увидите строку Программный доступ:  открыт :

Готово: сервис API успешно подключен. Теперь вы можете перейти к следующему шагу Добавление канала в систему .


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

Права на редактирование рекламных кампаний вашего аккаунта предоставляются вашим агентством. После их получении вы затем сможете включить API для своего аккаунта Яндекс.Директ.

1. Для получения прав на редактирование обратитесь с соответствующим запросом к своему агентству.
2. После получения прав на редактирование вам необходимо включить API. Подробнее о том, как это сделать, смотрите в п. Если у вас клиентский аккаунт без агентства.

 
Готово: теперь вы можете перейти к следующему шагу Добавление канала в систему.


Чтобы в проект Roistat вашего клиента загружалась информация по его рекламным кампаниям, вам необходимо предоставить соответствующему аккаунту в Яндекс.Директе права на редактирование кампаний.

Включить API может только сам клиент и только после получения прав на редактирование кампаний.

Чтобы выдать какому-либо клиентскому аккаунту права на редактирование рекламных кампаний, необходимо:

1. Зайти в агентский аккаунт Яндекс.Директ.

2. Открыть список клиентов, выбрав пункт Мои клиенты в верхнем меню:

  3. Найти нужного клиента и открыть его настройки, нажав ссылку редактировать в соответствующей строке таблицы справа:

  4. На открывшейся странице настроек клиента в блоке Дополнительные права установить флаг редактировать кампанию. и сохранить настройки:

Готово: права для клиентского аккаунта на редактирование кампаний выданы.

Подробнее об API Яндекс.Директа читайте в соответствующей документации.

Подробнее об ограничениях доступа при работе с API в Яндекс.Директе читайте по ссылкам для API версий 4 и Live 4 и версии 5.

Шаг 2. Добавление канала в систему

(warning) В один проект Roistat нельзя подключить два одинаковых рекламных канала. Если вы попытаетесь сделать это, то появится сообщение об ошибке. 

  1. В проекте Roistat откройте Каталог интеграций.
  2. В блоке Рекламные каналы на виджете Яндекс.Директ нажмите Подключить:

  3. Нажмите Продолжить, чтобы разрешить подключение канала к проекту Roistat. Если в момент подключения канала вы не авторизованы в своем аккаунте Яндекс.Директ, откроется форма авторизации.
  4. Введите логин и пароль вашего аккаунта в Яндекс.
    Откроется страница OAuth-авторизации Яндекс.
  5. Нажмите Разрешить, чтобы разрешить Roistat доступ к данным аккаунта Яндекс.Директ.  
    Сразу же после разрешения доступа для Roistat автоматически начнется разметка ваших объявлений меткой roistat, а вы будете перенаправлены на страницу подключенного канала для завершения его настройки. Каждое размеченное объявление будет автоматически отправляться на модерацию.

(информация) Никакие существующие метки в объявлениях изменены или удалены НЕ будут. Метка  roistat добавляется к уже существующей ссылке и ничего не заменяет. Добавление метки  roistat никак не нарушает вашу текущую разметку.

Шаг 3. Настройка параметров канала

  1. Нажмите Дополнительные настройки. Откроются параметры:
  2. Передвиньте вправо переключатель кнопки Размечать объявления автоматически, если вы хотите, чтобы все объявления автоматически размечались меткой roistat. Если кнопка в положении Выключено, то Roistat не размечает объявления меткой roistat, и визиты загружаются в Аналитику на основе utm-меток объявлений.

Для сохранения настроек нажмите кнопку Сохранить .

Шаг 4. Выбор кампании для управления

По умолчанию к Roistat подключаются все кампании из вашего аккаунта в Яндекс.Директе, а также установлена опция автоматического подключения всех новых кампаний.

"Добавлять новые кампании автоматически, если название содержит". Если вы хотите, чтобы автоматически добавлялись не все кампании, а только с определенным названием, то можете указать здесь шаблон названия. В шаблоне можно использовать регулярные выражения."

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

Чтобы данные по кампаниям были доступны для сервиса  Управление ставками , передвиньте одноименный переключатель вправо.

Вы можете не подключать те кампании, которые не должны учитываться Roistat.

(информация) Новые кампании Яндекс.Директа автоматически включаются для аналитики и управления ставками, если включен переключатель Добавлять новые кампании автоматически, если название содержит и если кампании проходят по указанным вами условиям:


(информация) Рекламные кампании, добавленные в архив, продолжают отображаться в настройках рекламного канала Яндекс.Директ. Чтобы отменить эту функцию, перейдите в рекламный канал и нажмите кнопку Скрыть архивные кампании:

Шаг 5. Ручная разметка ссылок объявлений

Если у вашего аккаунта Яндекс.Директ нет прав на редактирование кампаний или по другой причине Roistat не может автоматически размечать ссылки, вы можете разметить объявления вручную.

Например:

Примеры разметки (в данном случае direct1 – это название и ID рекламного канала в Roistat):

site.ru/ ?roistat=direct1_{source_type}_{banner_id}_{keyword}&roistat_referrer={source}&roistat_pos={position_type}_{position}
site.ru/catalog/page.php ?roistat=direct1_{source_type}_{banner_id}_{keyword}&roistat_referrer={source}&roistat_pos={position_type}_{position}
site.ru/cveti.html?param=p& roistat=direct1_{source_type}_{banner_id}_{keyword}&roistat_referrer={source}&roistat_pos={position_type}_{position}

(информация) Полный список динамических параметров Директа, которые вы можете включать в метку roistat после direct1 и перед &roistat_referrer , описан по ссылке.

(информация) Метка roistat может содержать до семи параметров.

Разметка Смарт-Баннеров вручную

(информация) Данный тип кампаний необходимо разметить меткой Roistat: ?roistat=direct<id_канала>_{source_type}_{banner_id}_{keyword}&roistat_referrer={source}&roistat_pos={position_type}_{position} 

(информация) Баннеры с типом IMAGE_AD и субтипом TEXT_AD_BUILDER_AD нельзя разметить автоматически.
Их 
необходимо разметить вручную меткой Roistat: roistat=direct<id_канала>_{source_type}_{banner_id}_{keyword}&roistat_referrer={source}&roistat_pos={position_type}_{position} 

Яндекс.Директ

Чтобы разметить ссылки группы объявлений, выполните несколько простых шагов.

1.  Зайдите в свой аккаунт Яндекс.Директ, откройте список кампаний, нажав ссылку   Мои кампании    в верхнем меню и зайдите в настройки нужной вам кампании, нажав на соответствующий заголовок:

Для создания новой кампании нажмите ссылку  Создать кампанию  в верхнем меню.

2.  Затем необходимо открыть настройки группы объявлений.

Они открываются с помощью клика по ссылке   Редактировать группу  в настройках существующей кампании или после перехода ко второму шагу создания рекламной кампании:

 

3.  В настройках группы объявлений для настройки в поле Добавить параметры к ссылкам  необходимо вставить метку roistat (roistat=direct<id_канала>_{source_type}_{banner_id}_{keyword}&roistat_referrer={source}&roistat_pos={position_type}_{position}).

5.  Сохраните настройки объявлений группы.

Разметка МКБ (баннеры на поиске) вручную

(информация) Данный тип кампаний необходимо разметить меткой Roistat: ?roistat=direct<id_канала>_{source_type}_{banner_id}_{keyword}&roistat_referrer={source}&roistat_pos={position_type}_{position} 

Яндекс.Директ

Чтобы разметить ссылки группы объявлений, выполните несколько простых шагов.

1.  Зайдите в свой аккаунт Яндекс.Директ, откройте список кампаний, нажав ссылку   Мои кампании    в верхнем меню и зайдите в настройки нужной вам кампании, нажав на соответствующий заголовок:

Для создания новой кампании нажмите ссылку  Создать кампанию  в верхнем меню.

2.  Затем необходимо открыть настройки группы объявлений.

Они открываются с помощью клика по ссылке   Редактировать группу  в настройках существующей кампании или после перехода ко второму шагу создания рекламной кампании:

 

3.  В настройках группы баннеров в поле  Ссылка на сайт необходимо вставить метку roistat (roistat=direct<id_канала>_{source_type}_{banner_id}_{keyword}&roistat_referrer={source}&roistat_pos={position_type}_{position}). Если нет дополнительных меток, то после знака ?, если есть уже какие-то метки отслеживания, то после знака &.

(warning) Ссылка не должна содержать несколько знаков ?


5.  Сохраните настройки объявлений группы.



Разметка объявлений с помощью сервиса Директ Коммандер

Метку roistat или utm-метку можно добавить или отредактировать с помощью сервиса Директ Коммандер Директ Коммандер помогает работать с большим объёмом данных — создавать, настраивать и редактировать масштабные рекламные кампании. 

Метка roistat имеет следующий формат:

roistat=direct[channel_id]_{source_type}_{banner_id}_{keyword}&roistat_referrer={source}&roistat_pos={position_type}_{position}

где [channel_id] - это id рекламного канала в системе Roistat.

Здесь выложены видео, в которых рассказывается о настройке Директ Коммандер.

Как добавить второй аккаунт Яндекс.Директ в проект Roistat

  1. Пройдите по ссылке https://cloud.roistat.com/projects/Номер проекта/channels, где вместо Номер проекта введите число, соответствующее номеру вашего проекта в Roistat.
    (warning) Если в момент подключения канала вы авторизованы в уже подключенном к Roistat аккаунте Яндекс.Директ, выйдите из него.
  2. Напротив Яндекс.Директ нажмите кнопку Добавить канал:  

  3. Нажмите Продолжить, чтобы разрешить подключение канала к проекту Roistat   .
    Если в момент подключения канала вы не авторизованы в своем аккаунте Яндекс.Директ, откроется форма авторизации .
  4. Введите логин и пароль вашего аккаунта в Яндекс .
    Откроется страница OAuth-авторизации Яндекс.
  5. Нажмите Разрешить, чтобы разрешить Roistat доступ к данным аккаунта Яндекс.Директ.
    Начнется разметка ваших объявлений меткой roistat , а вы будете перенаправлены на страницу подключенного канала для завершения его настройки.

Решение проблем

После подключения рекламного канала Яндекс.Директ Roistat размечает объявления меткой roistat. Если вы изменили или добавили объявления в существующие кампании или добавили новые кампании, Roistat размечает новые объявления меткой roistat. Для разметки объявлений меткой  roistat   Roistat использует API-метод Яндекс.Директа. Яндекст.Директ списывает за использование API -метода баллы. О том, как начисляются и расходуются баллы Яндекс.Директа и что это такое, можно узнать в документации Яндекс.Директа.
(информация) Если в подключенном к Roistat аккаунте Яндекс.Директ недостаточно баллов для разметки всех объявлений, вы можете написать в техническую поддержку Яндекса или вашему персональному менеджеру в Roistat письмо с просьбой о начислении дополнительных баллов. Например: "Прошу предоставить дополнительные баллы Яндекс.Директ, чтобы Roistat мог разметить наши объявления в Яндекс.Директе меткой roistat. Количество недостающих баллов: <укажите количество баллов, которого не хватает для разметки объявлений>".

Рекомендуемые статьи