Перейти к содержанию

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

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

  • Автоматически промаркировать ссылки меткой roistat для передачи информации о визите: время визита, страна/регион/город визита, а также другая информацию, которую можно передать из CRM.

    Подробнее о том, для чего необходимо размечать объявления меткой roistat и на что она влияет, читайте в инструкции Правила работы с метками.

  • Загружать информацию о расходах по каждому ключевому слову.

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

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

Примечание

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

Сначала определите, через какой рекламный аккаунт вы будете подключать кабинет к Roistat. От этого зависит, где выбирать кабинет при подключении.

Сценарий Какой аккаунт использовать Где выбрать кабинет
1. Через агентский аккаунт Аккаунт агентства, из которого вы управляете рекламой его клиентов. В Roistat после авторизации, если доступно несколько организаций. См. сценарий 1.
2. Через аккаунт рекламодателя или его паспортную организацию Аккаунт конкретного рекламодателя: прямого клиента Яндекса или клиента агентства. На стороне Яндекса при авторизации. В Roistat отдельного списка организаций не будет. См. сценарий 2.

Выбирайте сценарий по аккаунту, который используете при авторизации. Например, если вы работаете в агентстве, но входите непосредственно в паспортную организацию клиента, следуйте сценарию 2.

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

Аккаунт, роль пользователя и права доступа

Паспортная организация — аккаунт компании в Яндекс ID, через который её сотрудники работают в сервисах Яндекса, в том числе в Директе. Данные организации хранятся в общем аккаунте компании. В интерфейсе Яндекса аккаунт организации может отображаться с обозначением вида porg-…. Сотрудник входит в организацию со своим Яндекс-логином. У личного рекламного кабинета паспортная организация может отсутствовать.

Главный представитель — роль пользователя в агентстве или в кабинете рекламодателя. Главный представитель управляет другими представителями. Полный доступ и только чтение описывают права на работу с кампаниями. Главный представитель также имеет права на управление кампаниями; роль и уровень доступа не являются альтернативными сценариями подключения. Для клиента агентства возможности управления кампаниями зависят и от полномочий, которые предоставило агентство.

Управляющий аккаунт позволяет работать с другими рекламными кабинетами в пределах назначенных прав. Сам по себе доступ к нескольким кабинетам не делает аккаунт агентским. Для выбора сценария проверьте, под каким рекламным аккаунтом выполняете авторизацию.

Подробнее о ролях и доступах пользователей Директа и управляющих аккаунтах.

Для обоих сценариев проверьте:

  1. Права на редактирование рекламных кампаний — необходимы для автоматической разметки поддерживаемых объявлений меткой 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 Яндекс.Директа или выполните следующие действия:

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

  2. На панели слева выберите Инструменты → API.

    • Если отображается строка Программный доступ: открыт, API уже включен. Можно переходить к добавлению канала.

      Доступ к API Яндекс.Директа открыт

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

      Получение доступа к API Яндекс.Директа

  3. Нажмите Получить доступ к API.

  4. Прочитайте пользовательское соглашение и нажмите Согласен и Принять соглашение. Вы вернетесь на страницу управления доступом к API, где появится строка Программный доступ: открыт.

Если клиенту агентства нужны права на редактирование кампаний

Если вы подключаете аккаунт рекламодателя, который ведет агентство, попросите агентство предоставить права на редактирование кампаний. После получения прав проверьте доступ к API и переходите к сценарию 2.

Как агентству выдать клиенту права на редактирование

Эти действия выполняет представитель агентства, у которого есть права на изменение доступа клиента.

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

  2. На панели слева выберите Информация → Ваши представители.

    Представители агентства в Яндекс.Директе

  3. Нажмите на логин представителя, чтобы перейти в список клиентов.

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

    Изменение прав клиента агентства

  5. В блоке Дополнительные права установите флаг редактировать кампанию и сохраните настройки.

    Право на редактирование кампаний клиента

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

Используйте окно инкогнито

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

Начало подключения одинаковое для обоих сценариев:

  1. В проекте Roistat откройте раздел Интеграции.

  2. Нажмите Добавить интеграцию. В блоке Рекламные каналы выберите Яндекс.Директ и нажмите Добавить.

    Добавление интеграции Яндекс.Директ

После перехода на страницу Яндекса продолжите по выбранному сценарию.

Сценарий 1. Через агентский аккаунт

Этот сценарий подходит, если вы подключаете кабинет клиента из агентского аккаунта. Подключение выполняет представитель агентства, которому доступны кампании нужного клиента: главный представитель агентства или другой представитель с соответствующими правами.

  1. Авторизуйтесь в Яндексе под пользователем с доступом к агентскому аккаунту, из которого вы управляете клиентами.

  2. Если Яндекс запросит разрешение на доступ Roistat к данным, нажмите Разрешить.

  3. После возвращения в Roistat выберите организацию клиента:

    • Если доступно несколько организаций, выберите нужную в выпадающем списке по названию и ID.

      Выбор паспортной организации в Roistat: названия и ID доступных организаций

      Если у пункта вместо названия показан прочерк, например — (ID 333333), ориентируйтесь на ID. Выберите этот пункт вручную, если его ID соответствует нужной организации. Если не удается определить нужную организацию, уточните её у представителя агентства или обратитесь в поддержку Roistat.

    • Если доступна одна организация, она подключится автоматически.

    • Если у аккаунта нет паспортных организаций, подключение продолжится без выбора организации.

Затем перейдите к проверке подключенного кабинета.

Сценарий 2. Через аккаунт рекламодателя или его паспортную организацию

Этот сценарий подходит для подключения кабинета конкретного рекламодателя, в том числе клиента агентства. Подключение выполняет пользователь с доступом к этому кабинету: представитель рекламодателя или сотрудник его паспортной организации. Пользователь может работать в агентстве — порядок подключения определяется аккаунтом, под которым он авторизуется.

  1. Авторизуйтесь в Яндексе под пользователем с доступом к нужному рекламному кабинету.

  2. Выберите вариант входа для кабинета, который хотите подключить:

    • Паспортная организация: выберите нужную организацию на стороне Яндекса. Если на экране авторизации есть кнопка Войти как Сотрудник, используйте её для входа в организацию. Проверьте выбранную организацию, в том числе если её аккаунт обозначен как porg-….

    • Личный кабинет без паспортной организации: используйте вход под личным Яндекс-логином с доступом к нужному кабинету.

    Авторизация Яндекса: вход как сотрудник организации или под личным логином

  3. Если Яндекс запросит разрешение на доступ Roistat к данным, нажмите Разрешить.

  4. После возвращения в Roistat подключится кабинет, выбранный на стороне Яндекса. Отдельного списка организаций в Roistat в этом сценарии не будет, даже если у пользователя есть доступ к нескольким организациям.

Затем перейдите к проверке подключенного кабинета.

Проверьте подключенный кабинет

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

В карточке рекламного канала проверьте поля:

  • Аккаунт — логин, под которым подключен канал.
  • Паспортная организация — название организации при агентском подключении.
  • Кабинет Яндекс.Директ — ФИО представителя при клиентском подключении. Это поле отображается вместо поля Паспортная организация.
  • ID организации — ID подключенного кабинета. Название поля одинаково при агентском и клиентском подключении.

Карточка рекламного канала при агентском подключении: аккаунт, паспортная организация и ID организации

В списках подключений на странице Каналы и при просмотре интеграции Яндекс.Директ в разделе Интеграции проверьте столбцы:

  • Организация/представитель — название организации при агентском подключении или ФИО представителя при клиентском.
  • ID рекламодателя — идентификатор рекламодателя в Яндекс.Директе.

Если соответствующие данные не сохранены, в ячейке отображается прочерк.

Список подключений Яндекс.Директа: организация или представитель и ID рекламодателя

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

Логин и название организации во всплывающей подсказке в Аналитике

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

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

  • Добавление метки roistat никак не нарушает вашу текущую разметку:

    • Никакие существующие метки в объявлениях изменены или удалены не будут.
    • Метка roistat добавляется к уже существующей ссылке и ничего не заменяет.
  • Каждое размеченное объявление будет автоматически отправляться на модерацию. Срок модерации – до трех дней согласно документации Яндекса.

Обратите внимание

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

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

  • Одну паспортную организацию нельзя подключить повторно в том же проекте, в том числе через другой логин. При повторном подключении появится сообщение Данная паспортная организация Яндекс.Директ уже подключена в текущем проекте.

  • Для аккаунтов без паспортной организации сохраняется ограничение: один логин нельзя подключить дважды в одном проекте.

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

Примечание

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

  • Быстрые ссылки размечаются автоматически, как и обычные ссылки, если их тип поддерживает авторазметку. При этом Roistat также может добавить метку rs_stat – технический параметр, помогающий Roistat размечать быстрые ссылки (не удаляйте его).

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

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

  1. В карточке рекламного канала нажмите Дополнительные настройки. Откроются параметры:

    • Название – название рекламного канала в Roistat.
    • НДС – НДС в процентах (необязательно). Можно указать разный НДС для разных периодов в формате 0,2021-01-01=10,2021-04-01=20, где:

      • 0 – НДС до 01.01
      • 10 – НДС с 01.01 по 31.03
      • 20 – НДС с 01.04
    • Комиссия – комиссия вашего агентства (необязательно). Можно указать разную комиссию для разных периодов в формате 10,2021-01-01=20,2021-04-01=30, где:

      • 10 – комиссия до 01.01
      • 20 – комиссия с 01.01 по 31.03
      • 30 – комиссия с 01.04
    • Скидка – скидка рекламной площадки, если есть (необязательно). Можно указать разную скидку для разных периодов в формате 10,2021-01-01=15, где:

      • 10 – скидка до 01.01.2021
      • 15 – скидка с 01.01.2021.

      Таким образом, начиная с 1 января 2021 года, расходы будут рассчитываться с учетом скидки 15%, а до этой даты – с учетом скидки 10%.

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

    9.png

    Примечание

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

  2. Передвиньте вправо переключатель Размечать объявления автоматически, если вы хотите, чтобы все объявления автоматически размечались меткой roistat.

    Если опция отключена, Roistat не размечает объявления меткой roistat, и визиты загружаются в Аналитику на основе UTM-меток объявлений.

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

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

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

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

10-0.png

По умолчанию все добавленные кампании включаются для Аналитики и Управления ставками. Вы можете самостоятельно выбрать, данные по каким кампаниям должны загружаться в Аналитику и/или Управление ставками. Для этого передвиньте соответствующие переключатели вправо.

10.png

Обратите внимание

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

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

    12.png

    Скрытая архивная кампания не будет отображаться в настройках канала, но будет учитываться в Аналитике Roistat, если для этой кампании активирована опция Аналитика.

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

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

Например:

23.png

Примеры разметки

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

Пример разметки для кампаний «Медийная кампания на главной» и «Кампания с фиксированным CPM»

Без ручной разметки расходы по таким кампаниям будут отображаться, но не свяжутся с реальными визитами.
Детализация по ключевым словам отсутствует.
Разметьте такие кампании по шаблону:

http://site.ru/?roistat=direct1_{source_type}_{campaign_id}_{gbid}_{ad_id}

В примерах direct1 — название и ID рекламного канала. Замените 1 на ID рекламного канала Яндекс.Директ в вашем проекте.

Примечание

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

Обратите внимание

Если вы используете пиксели Яндекса для Медийной рекламы, то все метки необходимо добавлять на этапе создания посадочной страницы. Динамические параметры Я.Директа при этом не поддерживаются. Если метки добавлены иным способом, то они не сохранятся при редиректе через промежуточную страницу Яндекса вида https://amc.yandex.ru/show?cmd_id=...

Типы поддерживаемых кампаний и взаимодействие Roistat с ними

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

Тип группы объявлений
DYNAMIC_TEXT_AD_GROUP
+
(на уровне группы объявлений)
+ Включить кампании с типом DYNAMIC_TEXT_CAMPAIGN в настройках рекламного канала. Разметка применяется на уровне группы объявлений.
Медийные
CPM_BANNER_CAMPAIGN
+ + Включить кампании с таким типом в настройках рекламного канала. Объявления будут размечаться автоматически. Расходы по объявлениям подгружаются автоматически.
Медийная кампания на главной
CPM_FRONTPAGE_CAMPAIGN
- + Самостоятельно разметить кампанию вручную по шаблону для этих типов кампаний.
Кампания с фиксированным CPM
CPM_PRICE_CAMPAIGN
- + Самостоятельно разметить кампанию вручную по шаблону для этих типов кампаний.
Смарт-баннеры
SMART_BANNER_CAMPAIGN
- + Самостоятельно разметить смарт-баннеры меткой Roistat. Для данных типов кампаний нет возможности использовать UTM-метки вместо меток Roistat.
Медийно-контекстные баннеры (баннеры на поиске)
MCBANNER_CAMPAIGN
− + Самостоятельно разметить меткой Roistat. Для данных типов кампаний нет возможности использовать UTM-метки вместо меток Roistat.
Кампании, созданные через Мастер кампаний - + Добавить специальную метку вручную по инструкции.
Товарные кампании, созданные через Мастер кампаний - + Добавить специальную метку вручную по инструкции.
Реклама в телеграм-каналах
TEXT_CAMPAIGN
- + Самостоятельно разметить меткой Roistat. Для данных типов кампаний нет возможности использовать UTM-метки вместо меток Roistat.
Реклама мобильных приложений
MOBILE_APP_CAMPAIGN
+ + Включить кампании с таким типом в настройках рекламного канала. Объявления будут размечаться автоматически. Расходы по объявлениям подгружаются автоматически.
Единая перфоманс-кампанияβ (ЕПК)
UNIFIED_CAMPAIGN

Товарные объявления
SHOPPING_AD
+
(на уровне группы объявлений)
+ Включить кампании с таким типом в настройках рекламного канала.
При ручной разметке: разметить меткой roistat (достаточно добавить метку на уровне кампании или группы объявлений).
Обратите внимание: Для данных типов объявлений нет возможности использовать UTM-метки вместо меток Roistat.
Единая перфоманс-кампанияβ (ЕПК)
UNIFIED_CAMPAIGN

Текстово-графические объявления
TEXT_AD
+
(на уровне группы объявлений)
+ Включить кампании с таким типом в настройках рекламного канала. Объявления будут размечаться автоматически. Расходы по объявлениям подгружаются автоматически.
Единая перфоманс-кампанияβ (ЕПК)
UNIFIED_CAMPAIGN

Тип группы объявлений
UNIFIED_AD_GROUP
+
(на уровне группы объявлений)
+ Включить кампании с типом UNIFIED_CAMPAIGN в настройках рекламного канала. Разметка применяется на уровне группы объявлений.
Единая перфоманс-кампанияβ (ЕПК)
UNIFIED_CAMPAIGN

Графическкие объявления
IMAGE_AD
+ + Включить кампании с таким типом в настройках рекламного канала. Объявления будут размечаться автоматически. Расходы по объявлениям подгружаются автоматически.

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

Обратите внимание

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

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

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

  • Roistat не работает с Яндекс.Видео.

  • Необходимо выставить одинаковый часовой пояс в Roistat и в Яндекс.Директ. Иначе могут возникнуть расхождения в данных.

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

Подключение кампаний, созданных через Мастер кампаний

По кампаниям, созданным через Мастер кампаний, можно получать аналитику и автоматически загружать расходы (в том числе для Товарных кампаний).

Чтобы подключить кампанию:

  1. В проекте Roistat в настройках канала включите опцию Аналитика напротив нужной кампании.

    13-2.png

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

    24.png

    Разметка должна иметь вид:

    /?roistat=direct{channel_id}_{source_type}_{campaign_id}_rsMasterGroup_rsMasterBanner_{keyword}
    
    где:

    • {channel_id} – ID рекламного канала в Roistat.
    • rsMasterGroup_rsMasterBanner – статические параметры, необходимые для загрузки расходов (не убирайте их из разметки).
    • {source_type}, {campaign_id} и {keyword} – динамические параметры, по которым формируются уровни отчета в Аналитике Roistat.

    Пример ссылки с разметкой:

    https://site.ru/?roistat=direct1_{source_type}_{campaign_id}_rsMasterGroup_rsMasterBanner_{keyword}
    

    Для Товарных кампаний разметка должна иметь вид:

    /?roistat=direct{channel_id}_{source_type}_{campaign_id}_rsMasterGroup_rsMasterBanner_{keyword}
    
    где:

    • {channel_id} – ID рекламного канала в Roistat.
    • {campaign_id} – статический параметр – укажите вместо него ID (номер) Товарной кампании.
    • rsMasterGroup_rsMasterBanner – статические параметры, необходимые для загрузки расходов (не убирайте их из разметки).
    • {source_type} и {keyword} – динамические параметры, по которым формируются уровни отчета в Аналитике Roistat.

    Пример ссылки с разметкой:

    https://site.ru/?roistat=direct1_{source_type}_72935567_rsMasterGroup_rsMasterBanner_{keyword} 
    

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

  1. Убедитесь, что статус кампании находится в режиме Черновик.

  2. Кликните по названию кампании, чтобы перейти на страницу кампании.

    13-redact.png

  3. На странице кампании нажмите Редактировать.

  4. На странице редактирования кампании нажмите Изменить ссылку.

  5. Отредактируйте ссылку с разметкой и сохраните изменения.

Отчет Аналитики по кампаниям Яндекс.Директ в проекте Roistat будет выглядеть так:

13-4.jpg

В таблице Группа Мастер кампаний и Объявление Мастер кампаний – статические названия уровней отчета. Они будут одинаковыми для всех кампаний, созданных через Мастер кампаний, так как Roistat не получает названия этих уровней от Яндекс.Директ.

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

Не появляется выбор паспортной организации

Проверьте, по какому сценарию выполняете подключение:

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

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

Подключился другой кабинет или Яндекс не предлагает выбрать аккаунт

Сравните данные подключенного аккаунта и кампании канала с нужным кабинетом Яндекс.Директа — см. проверку подключенного кабинета. При подключении организации на экране авторизации Яндекса выбирайте Войти как Сотрудник, если такой вариант доступен. Вариант Войти как [личный логин] может подключить личный кабинет администратора.

Яндекс может запомнить предыдущий выбор и не показывать его при повторной авторизации.

Сначала попробуйте окно инкогнито

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

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

Перед отзывом доступа

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

  1. Откройте Доступ к вашим данным в Яндекс ID под аккаунтом, который используете для подключения канала.
  2. Найдите приложение Roistat и отзовите у него доступ.
  3. Повторно пройдите авторизацию через Roistat. Для подключения организации выберите Войти как Сотрудник на экране Яндекса, если он предлагает этот вариант.
  4. Проверьте данные подключенного кабинета и кампании в Roistat.

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

Организация уже подключена в проекте

Сообщение Данная паспортная организация Яндекс.Директ уже подключена в текущем проекте означает, что в проекте уже есть канал с этой организацией. Найдите его в списке интеграций и продолжите настройку существующего канала.

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

В каких статусах можно размечать объявления?

В статусах кампаний: ON, SUSPENDED, ENDED

В статусах типов кампаний: TEXT_CAMPAIGN, DYNAMIC_ TEXT_CAMPAIGN, CPM_BANNER_CAMPAIGN

В статусах баннеров: ON, SUSPENDED

В типах группы объявлений: DYNAMIC_TEXT_AD_GROUP

Разметка смарт-баннеров вручную

Кампании с типом Смарт-баннеры нельзя разметить автоматически. Их необходимо разметить вручную меткой Roistat: 

roistat=direct[channel_id]_{source_type}_{campaign_id}_{gbid}_{banner_id}&roistat_referrer={source}

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

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

  2. Откройте настройки группы объявлений: нажмите на шестеренку слева от названия группы объявлений и выберите пункт Редактировать.

  3. Затем вставьте метку roistat:

    roistat=direct[channel_id]_{source_type}_{campaign_id}_{gbid}_{banner_id}&roistat_referrer={source}
    

    25-1.png

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

Обратите внимание

Убедитесь, что фид, привязанный к смарт-баннеру, не используется для интеграции Roistat с Яндекс.Маркетом. В противном случае визиты будут относиться к каналу Яндекс.Маркет, а не Яндекс.Директ.

Разметка вручную баннеров с типом IMAGE_AD и субтипом TEXT_AD_BUILDER_AD

Кампании с типом IMAGE_AD и субтипом TEXT_AD_BUILDER_AD нельзя разметить автоматически. Их необходимо разметить вручную меткой Roistat: 

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

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

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

  2. Откройте настройки группы объявлений: нажмите на шестеренку слева от названия группы объявлений и выберите пункт Редактировать.

  3. Затем вставьте метку roistat:

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

    25.png

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

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

Данный тип кампаний необходимо разметить меткой Roistat: 

roistat=direct<id_канала>_{source_type}_{banner_id}_{keyword}&roistat_referrer={source}&roistat_pos={position_type}_{position}

Чтобы разметить ссылки объявлений:

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

    18.png

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

  2. В разделе Добавление объявлений вставьте метку roistat в ссылки объявлений. Ссылки должны иметь следующий вид: https://site.ru/?roistat=direct<id_канала>_{source_type}_{banner_id}_{keyword}&roistat_referrer={source}&roistat_pos={position_type}_{position}

    Если нет дополнительных меток, вставьте метку после знака ?. Если есть уже какие-то метки отслеживания, вставьте метку после знака &. Ссылка не должна содержать несколько знаков ?

    18-2.png

  3. Нажмите Сохранить.

Обратите внимание

Информация о кампании данного типа появится на странице рекламного канала в течение дня после получения первых просмотров рекламы в выдаче Яндекса. Это связано с ограничениями Яндекс.Директа.

Не сохраняются метки Медийной рекламы

Если вы используете пиксели Яндекса для Медийной рекламы,

то все метки необходимо добавлять на этапе создания посадочной страницы.

Динамические параметры Я.Директа при этом не поддерживаются.

Если метки добавлены иным способом, то они не сохранятся при редиректе через промежуточную страницу Яндекса вида https://amc.yandex.ru/show?cmd_id=...

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

Метку 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?

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

Также можно подключить другую паспортную организацию под тем же логином. Одну и ту же паспортную организацию нельзя подключить повторно в этом проекте.

Используйте окно инкогнито

Откройте Roistat в окне инкогнито и войдите в нужный проект, чтобы выбрать нужный Яндекс-аккаунт при авторизации.

  1. Перейдите на страницу https://cloud.roistat.com/projects/номер_проекта/channels, заменив номер_проекта номером вашего проекта в Roistat.

  2. Напротив Яндекс.Директ нажмите Добавить канал.

    Страница Каналы: добавление канала Яндекс.Директ, организация или представитель и ID рекламодателя

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

За что Яндекс.Директ списывает баллы?

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

Примечание

Если в подключенном к Roistat аккаунте Яндекс.Директ недостаточно баллов для разметки всех объявлений, нужно дождаться начисления новых API-баллов. После этого разметка запустится автоматически в течение 1-2 дней. Убедитесь, что баллы не расходуются на другие сервисы: в этом случае время разметки может быть увеличено. Если у вас остались вопросы, напишите в службу поддержки Roistat.

Адреса с метками Roistat воспринимаются Яндекс.Вебмастером как отдельные страницы и попадают в поиск. Как это исправить?

Чтобы адреса с добавленными метками Roistat не воспринимались как отдельные страницы и не индексировались, в файле robots.txt необходимо прописать директиву Clean-param. Пример:

User-agent: Yandex
Disallow:
Clean-param: roistat_referrer&roistat_pos

В данном случае параметры roistat_referrer и roistat_pos больше не будут учитываться при индексации страницы.

Что делать, если при подключении аккаунта возникает ошибка: Запрещено получать токены с данными правами для данного приложения (unauthorized_client)
  1. Необходимо проверить заполненность аккаунта в ЯндексID. В аккаунте должны быть заполнены полностью ФИО, телефон, фотография

  2. В случае возникновения проблемы после заполнения аккаунта в ЯндексID, напишите, пожалуйста, нам в поддержку


Полезные статьи