Loading...
Page tree
Skip to end of metadata
Go to start of metadata


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

  • автоматически промаркировать ссылки меткой roistat (подробнее о том, для чего необходимо размечать объявления меткой roistat и на что она влияет, читайте в инструкции Правила работы с метками );
  • загружать информацию о расходах по каждому ключевому слову.

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

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

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

Название типа объявленийСистемное название (в Яндекс.Директе)Может ли Roistat автоматически разметитьЗагружает ли Roistat расход по рекламным каналамРекомендации по работе с типом объявлений
Текстово-графическиеTEXT_AD++Включить кампании с таким типом в настройках рекламного канала.
Объявления будут размечаться автоматически.
Расходы будут загружаться автоматически.
ГрафическиеIMAGE_AD++
МобильныеMOBILE_APP_AD++
Смарт-баннерыSMART_BANNER_CAMPAIGN-+

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

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

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

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

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

МедийныеCPM_BANNER_AD--
ВидеообъявленияCPC_VIDEO_AD--

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

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

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

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

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

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

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

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

  1. Нажмите Дополнительные настройки. Откроются параметры:
    • Название – название рекламного канала в Roistat.   
    • НДС – НДС в процентах (необязательно). Можно указать разный НДС для разных периодов, формата: 18,2019-01-01=20
    • Комиссия – комиссия вашего агентства (необязательно).

    • Скидка – скидка рекламной площадки, если есть (необязательно).

    • Уникальные метки для объявления – уникальный параметр utm в ссылке объявления, который используется вместо метки roistat. См. подробнее Настройка рекламного канала без метки roistat.

  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} 

Как узнать ID рекламного канала

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

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} 

Как узнать ID рекламного канала

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

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

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

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

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

 

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

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


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


Разметка динамических объявлений вручную

(информация) Данный тип объявлений необходимо разметить UTM-метками.

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

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

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

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

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

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

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

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


3.  В настройках группы объявлений для настройки   Домен    в поле   Параметры в ссылке  необходимо вставить UTM-метку, которая поможет вам анализировать данные объявления в аналитике.

4.  Затем следует вставить UTM-метку для быстрых ссылок, если вы их используете.

Для этого нажмите кнопку   Добавить   /  Изменить    рядом с параметром   Быстрые ссылки   и для каждой из ссылок добавьте вашу UTM-метку:

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. Количество недостающих баллов: <укажите количество баллов, которого не хватает для разметки объявлений>".

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

  • No labels