Skip to end of metadata
Go to start of metadata


Описание

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

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

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

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

К Roistat подключаются следующие типы объявлений:

  • динамические
  • объявление для рекламы мобильных приложений
  • текстово-графические (обычные)

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

Внимание!

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

Шаг 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 — включение 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. Подтвердите, что вы разрешаете подключение канала к проекту Roistat, нажав кнопку «Продолжить»:

3. Если в момент подключения канала вы не авторизованы в своем аккаунте Яндекс.Директ, откроется форма авторизации, в которой необходимо будет указать ваши логин и пароль:

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

5. Сразу же после разрешения доступа для Roistat автоматически начнется разметка ваших объявлений меткой roistat, а вы будете перенаправлены на страницу подключенного канала для завершения его настройки.

Каждое размеченное объявление будет автоматически отправляться на модерацию.

Никакие существующие метки в объявлениях изменены или удалены НЕ будут.

Метка roistat просто добавляется к уже существующей ссылке и ничего не заменяет. Добавление метки roistat никак не нарушит вашу текущую разметку.

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

После добавления рекламного канала следует настроить его параметры.

Для этого на открывшейся странице созданного рекламного канала нажмите кнопку «Дополнительные настройки», после чего появятся следующие параметры для настройки:

  • Название – название рекламного канала в Roistat;
  • НДС – НДС в процентах (необязательно);
  • Комиссия – комиссия вашего агентства (необязательно);
  • Скидка – скидка рекламной площадки, если есть (необязательно).

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

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

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

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

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

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

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

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

Для этого сначала необходимо узнать ID рекламного канала в Roistat, а затем разметить нужные объявления меткой roistat.

 1. Посмотреть ID рекламного канала можно на странице его настроек. Подробнее в инструкции «Как узнать ID рекламного канала».

 2. Чтобы разметить объявления, в вашем аккаунте Яндекс Директ в настройках каждого объявления в поле «Ссылка на сайт» добавьте метку 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 немного отличается от схемы работы с текстовыми объявлениями. Динамические объявления генерируются автоматически, и пользователь не имеет возможности контролировать каждое из них в отдельности. Поэтому размечать необходимо как домен, общий для группы, так и быстрые ссылки для каждого объявления.

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

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

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

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


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

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


3. В настройках группы объявлений для настройки «Домен» в поле «Параметры в ссылке» необходимо вставить метку roistat=direct[channel_id]_{source_type}_{banner_id}_{keyword}&roistat_referrer={source}&roistat_pos={position_type}_{position} (перечень настроек совпадает и для редактирования группы, и для ее создания):

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

Для этого нажмите кнопку «Добавить»/«Изменить» рядом с параметром «Быстрые ссылки» и для каждой из ссылок добавьте метку roistat=direct[channel_id]_{source_type}_{banner_id}_{keyword}&roistat_referrer={source}&roistat_pos={position_type}_{position}:

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

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

 За что Roistat списывает API баллы Директа?

Roistat списывает API баллы только за маркировку объявлений меткой rs.

Как это происходит. Как только вы подключили рекламный канал Директ к Roistat ссылки автоматически размечаются меткой rs. Также, если вы изменили или добавили объявления в существующие кампании, Roistat также при необходимости размечает новые ссылки меткой rs. Такой же принцип и при добавлении новых кампаний.
В том случае, если предоставленных API баллов было недостаточно для разметки всех объявлений, то вы можете написать в техническую поддержку Яндекс, либо вашему персональному менеджеру просьбу о начислении дополнительных API баллов. Пример такого запроса может быть таким: "Прошу предоставить дополнительные API баллы для того, чтобы сервис Roistat мог автоматически разметить наши ссылки rs-меткой".

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

  • No labels