Директ.Автомат 2.0
 Экономит рекламный бюджет в Яндекс.Директе и избавляет от ручного труда 
ДОКУМЕНТАЦИЯ

05.03.2018

ДОКУМЕНТАЦИЯ ПРОГРАММЫ ДИРЕКТ АВТОМАТ 2.0
(По пунктам меню)
(Инструкция по установке: http://direct-automate.ru/directautomate/index/...)
1. СТАВКИ
После авторизации в программе загружается страница управления ставками. Пункт в разделе меню «Ставки».

На странице «Ставки» вы увидете либо список кампаний, если у вас в системе зарегистрирован 1 прямой аккаунт Яндекс.Директ. Либо список аккаунтов если у вас зарегистрирован агентский аккаунт или несколько аккаунтов Яндекс.Директ.
Иерархия доступа к страницам группы «Ставки»: Аккаунты -> Кампании -> Объявления -> Фразы
Выбрав нужный аккаунт (кликнув на его наименование) вы получите список рекламных кампаний.
Выбрав кампанию (кликнув на ее наименование) вы получите список объявлений соответствующей кампании.
Выбрав объявление (кликнув по его наименованию) вы получите список ключевых фраз соответствующих объявлению.

1.1 Кампании

Расшифровка полей в таблице:
1.1.1 ID - идентификатор кампании в Яндекс.Директ. Также сводная информация по расходу, показам, кликам и CTR.

1.1.2 Наименование - название кампании. При клике на заголовок открываются объявления соответствующие кампании.

1.1.3 Стратегия - стратегия управления ставками Яндекс.Директ.
В программе предустановлены встроенные стратегии управления ставками. В разделе «Стратегии» можно создавать собственные индивидуальные стратегии.

- Наследовать
Эта стратегия означает, что стратегия берется у вышестоящего элемента (кампании, объявления, фразы)

- Произвольный объем трафика
Эта стратегия означает, что объявление будет получать заданный в настройках стратегии объем трафика:
«Ставка» = «Цена за объем трафика» + «Цена за объем трафика» * «Наценка в %» / 100 + «Наценка в руб.».

- Минимальный объем трафика
Эта стратегия означает, что объявление будет показываться в гарантии на последнем месте:
«Ставка» = «Цена за минимальный объем трафика» + «Цена за минимальный объем трафика» * «Наценка в %» / 100 + «Наценка в руб.».

- Максимальный объем трафика
Эта стратегия означает, что объявление будет показываться в спецразмещении на 1 месте.
«Ставка» = «Цена за максимальный объем трафика» + «Цена за максимальный объем трафика» * «Наценка в %» / 100 + «Наценка в руб.».

- Фиксированная ставка
Стратегия, которая устанавливает фиксированную ставку.
«Ставка» = «Максимальная ставка».

26.09.2017

- Тематические площадки (РСЯ)
Обновление ставок только в рекламной сети яндекса.
Ставки вычисляются по алгоритму:
- выставляется ставка 100%, если 100% выше максимальной ставки, то 50%, если 50% выше максимальной ставки, то 20%, если 20% выше максимальной ставки, то ставка равна максимальной ставке.
- при наличии значения в поле охват в процентах (%) - ставка выставляется не выше этого процента.
- при отсутствии информации об охватах подставляется значение из поля нулевая ставка
- ставка не будет выше заданного значения максимальной ставки и не будет ниже заданного значения минимальной ставки

- Не обновлять ставки
Отключает обновление ставок

- Сбор статистики
Собирает статистику ставок конкурентов, не обновляя ставки

28.09.2017

1.2.0 Параметры стратегии на поиске
- Объем трафика (volume)
Это объем трафика (Например: 1 место = максимальный объем трафика), который требуется автоматически удерживать программой.

- Максимальная ставка (maximum)
Это ограничение максимально возможной ставки в валюте кампании. Ставка не поднимется выше, чем задано. Обязательно к заполнению. Если не задана, то равна минимально возможной ставке (0.01 у.е.).

- Максимальная списываемая цена (fixed)
Это ограничение максимально возможной списываемой цены за клик в валюте кампании.

- Наценка в % (percent)
Это добавочная цена к «Цене входа в гарантию или спецразмещение». Если установлена галочка «До первого места», то берется процент от разницы между «Ценой 1 места» и «Ценой входа», в противном случае процент высчитывается от «Цены входа»

- Наценка в единицах валюты (add)
Это добавочная цена к «Цене входа в гарантию или спецразмещение» в единицах валюты кампании (руб., у.е. и т.д.).

- Ограничение дневного бюджета (budget)
Ограничение дневного бюджета у кампании. По умолчанию работает только для кампаний.


1.1.5 Параметры для стратегии РСЯ
1.1.5.1. При отсутствии значения в поле охват в процентах (%) - ставка выставляется наибольший охват в процентах в пределах максимальной ставки.
1.1.5.2. При наличии значения в поле охват в процентах (%) - ставка выставляется меньшей или равной значению соответствующему охвату в процентах получаемому из АПИ.

Значения охватов можно посмотреть напротив каждой фразы в разделе "Ставки".
В некоторых случаях Яндекс не может вычислить охват. В этом случае необходимо заполнить поле нулевая ставка (0) в блоке настроек РСЯ.
Переменная "context_optimum", доступная в стратегиях, автоматически вычисляется в закрытом режиме в соответствии с алгоритмом описанным в пунктах 1 и 2 выше.

1.1.5.3 Блок настроек РСЯ
- Галочка включения управления ставками РСЯ (context)

- Наценка в % (context_percent)
Максимальный охват аудитории в процентах.

- Максимальная ставка (context_maximum)
Ограничение максимально возможной ставки в валюте кампании (Если не задана, то равна минимально возможной ставке 0.01 у.е.).

- Нулевая ставка (context_fixed)
Иногда яндекс не может вычислить значения минимального и максимального охвата. В данном поле можно задать фиксированное значение ставки, при отсутствии информации об охвате аудитории.

- Минимальная ставка (context_minimum)
Это ставка ниже которой стратегия не даст опустить ставку

28.09.2017

1.2 Группы объявлений
Все настройки в точности соответствуют настройкам в пунтах 1.1 Кампании.
Единственное отличие по умолчанию стратегия в "Группы" соответствует "Наследовать".
Наследовать - означает что все установки стратегия, параметры на поиске и параметры на РСЯ будут унаследованы объялениями, если у объявления не выбрана собственная стратегия или стратегия "Не обновлять ставки". Обращаем ваше внимание, что в случае если выбрана стратегия отличная от "Наследовать" значения параметров унаследованы не будут и будут равны выставленным значениям или нулю.

1.3 Фразы
Все настройки в точности соответствуют настройкам в пунктах 1.1 Кампании или 1.2 Объявления.
По умолчанию стратегия в "Фразы" соответствует "Наследовать". Обращаем ваше внимание, что в случае если выбрана стратегия отличная от "Наследовать" значения параметров унаследованы не будут и будут равны выставленным значениям или нулю.

1.3.1 Ставки и цены на поиске (на момент последнего обновления ставок)
- Позиция, Ставка и списываемая цена за клик (в скобочках).

1.3.2 Ставки и охваты на тематических площадках РСЯ (на момент последнего обновления ставок)
- Охват в процентах, ставка

28.09.2017

2. АККАУНТЫ
В данном разделе добавляются авторизационные данные для прямых и агентских аккаунтов Яндекс.Директ. Количество аккаунтов не ограничено.
Подробная инструкция по добавлению аккаунтов: http://direct-automate.ru/directautomate/index/board/29599370/

3. ПОЛЬЗОВАТЕЛИ
3.1 Администраторы
В данном разделе можно добавить или отредактировать "администратора" программы.

3.2 Представители по работе с клиентами
В данном разделе можно отредактировать "представителей" для агентских аккаунтов.
Добавить или удалить нельзя, поскольку синхронизация происходит автоматом с Яндекс.Директ.

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

28.09.2017

4. СТРАТЕГИИ (ФОРМУЛЫ)

Язык программирования формул PHP.
Официальный мануал: PHP.net
Переменные АПИ указываются без $, а функции АПИ без скобок "()".
В конце присваивания переменной или функции ставится точка с запятой(;).
Ветвление: ЕСЛИ (if), ИНАЧЕ ЕСЛИ (elseif), ИНАЧЕ (else), сравнить две переменные можно используя двойной знак равно (==), больше (>), меньше (<), больше или равно (>=), меньше или равно (<=), не равно - восклицательный знак и равно (!=), логическое И (AND), логическое ИЛИ (OR).
Несколько условий ветвления заключаются в фигурные скобки {}.

Пример: IF (переменная1 == переменная2 AND переменная3==переменная4) {переменная5=переменная1+переменная3;} ELSEIF (переменная1!=переменная2 OR переменная3!=переменная4) {переменная5=0;} ELSE переменная5=1;

4.1 Доступные свойства (переменные)

Пример: price=premium_min + premium_min*percent/100 + add; if (price>maximum) price=min_price;

price - ставка
min - ставка за минимальный объем трафика
max - ставка за максимальный объем трафика
optimum - ставка за заданный в настройках объем трафика
VOLUMES - массив объемов трафика. (Например: VOLUMES[75]['bid'] )
VOLUMES[объем трафика]['bid'] - ставка за объем трафика
VOLUMES[объем трафика]['cost'] - списываемая цена клика за объем трафика
VOLUMES[объем трафика]['volume'] - объем трафика
real_price - списываемая цена клика
price_old - ставка до перезаписи
step - шаг торгов в валюте кампании (0.1 руб.)
min_price - минимальная ставка в валюте кампании (0.3 руб.)
max_price - максимальная ставка в валюте кампании (10000 руб.)
volume - объем трафика
maximum - ограничение максимальной ставки
fixed - фиксированная ставка
percent - наценка в процентах
add - наценка в валюте кампании
budget - ограничение бюджета по ключевой фразе (по умолчанию не используется во встроенных стратегиях)
company_budget - ограничение бюджета по кампании
company_sum - расход за сегодня по кампании
company_click - клики за сегодня по кампании
company_show - показы за сегодня по кампании
company_ctr - ЦТР за сегодня по кампании, %
company_date - дата создания кампании, формат YYYY-MM-DD

28.09.2017

context - РСЯ: включено или выключено управление ставками на тематических площадках (1 или 0)
context_price - РСЯ: ставка
context_percent - РСЯ: охват аудитории, %
context_optimum - РСЯ: ставка соответствующая 100%, 50% или 20% охвату аудитории, на который хватает максимальной ставки.
context_max - РСЯ: ставка соответствующая 100% охвату аудитории
context_medium - РСЯ: ставка соответствующая 50% охвату аудитории
context_min - РСЯ: ставка соответствующая 20% охвату аудитории
context_fixed - РСЯ: ставка при отсутствии охвата
context_maximum - РСЯ: максимальная ставка
context_minimum - РСЯ: минимальная ставка
conversion - количество достигнутых целей за от 1 до 365 дней по фразе (интервал задается в настройки, требуется Яндекс.Метрика)
sum - расход за от 1 до 365 дней по фразе (интервал задается в настройки, требуется Яндекс.Метрика)
show - показы за от 1 до 365 дней по фразе (интервал задается в настройки, требуется Яндекс.Метрика)
click - клики за от 1 до 365 дней по фразе (интервал задается в настройки, требуется Яндекс.Метрика)
company - ID кампании в Яндекс.Директ
group - ID группы в Яндекс.Директ
banner - ID объявления в Яндекс.Директ
id - ID фразы в Яндекс.Директ
company_status - признак запущена ли кампания (1 - запущена, 2 - остановлена)
group_status - признак запущена ли группа (1 - запущена, 2 - остановлена)
status - признак запущена или на паузе фраза (1 - запущена, 2 - остановлена)
param1 - пользовательский параметр для каждой фразы (по умолчанию: 0.00)
param2 - пользовательский параметр для каждой фразы (по умолчанию: 0.00)
param3 - пользовательский параметр для каждой фразы (по умолчанию: 0.00)
position_value - позиция фразы в результатах поиска (Яндекс.XML)
datetime - текущие дата и время, формат YYYY-MM-DD HH:II:SS
date - текущая дата, формат YYYY-MM-DD
time - текущее время, формат HH:II:SS
week - текущий день недели, формат 0 - воскресенье, 1 - понедельник...6 - суббота

4.2 Доступные методы (функции)

Пример: if (company_sum>company_budget) company_stop; else company_start;

stop - Остановить ключевую фразу
start - Запустить ключевую фразу
banner_stop - Остановить объявление
banner_start - Запустить объявление
company_stop - Остановить кампанию
company_start - Запустить кампанию
place - позиция фразы вычисляемая по значению ставки
real - списываемая цена вычисляемая по значению ставки
link - проверка битых ссылок у объявлений (1 - валидная ссылка, 0 - не открывающаяся ссылка)

5. СТАТИСТИКА
5.1 Статистика
Средние значения показов, кликов, конверсий, ставок, стоимости клика, цен за все места гарантии и спец.размещения сводно по всем кампаниям, группам или фразам за один или несколько дней.

5.2 Лог ставок
График ставок, стоимости клика, цен входа и 1 места гарантии и спецразмещения за сегодня или другой день.

13.05.2017

6. ЗАДАНИЯ
6.1 Добавить или редактировать задания
На этой странице выводится список заданий по расписанию, которые выполняются через планировщик задач (crontab).
Планировщик может выполняться каждую минуту. Чтобы сделать выполнение заданий более редким, необходимо задать интервал в поле интервал в минутах и нажать кнопку сохранить.

6.1.1 Обновление ставок
Это задание отвечает за обновление ставок согласно выбранной вами автоматической стратегии.
Скорость обновления ставок ваше конкурентное преимущество. Если время выполнения в минутах по мере увеличения количества ключевых фраз обрабатываемых в программе становится слишком большим (час и более), то вы можете добавить несколько заданий обновления ставок нажав кнопку "Добавить задания". В параметрах добавленных заданий вы можете указать различные аккаунты или даже отдельные кампании. Ваши задания начнут обрабатывать разные аккаунты или кампании Я.Директ одновременно, что ускорит обновление задач в соответствующие количеству заданий число раз.

6.1.2 Синхронизация данных
Это задание отвечает за получение субклиентов, кампаний, объявлений, фраз и тегов. Появление в программе новых или обновление старых фраз происходит только после того как отработает задание синхронизации. Время первичной синхронизации будет максимальным. Время последующих синхронизаций будет подтягивать все кампании и только изменившиеся объявления или фразы, что существенно быстрее.

6.1.3 Статистика
Это задание отвечает за получение статистики по расходу, показам, кликам за день. А также за вычисление усредненной статистики.

13.05.2017

7. НАСТРОЙКИ
7.1 Планировщик
Это пример настройки планировщика заданий (Crontab). Он настраивается в панели управления хостинга или виртуального сервера. Здесь вы можете увидеть автоматически вычисленный путь к файлу который надо поместить в планировщик заданий.

7.2 Хранить статистику усредненную по дням, в днях
Отвечает за усредненную статистику по дням по расходу, показам, кликам и ставкам.

7.3 Хранить статистику в реальном времени, в днях
Отвечает за время, которое хранится статистика ставок обновляемых каждую минуту. Занимает много места на диске, поэтому по умолчанию время хранения 1 день.

7.4 Получать конверсии за следующее количество дней
Количество дней, за которые получаются конверсии, roi, доход, глубина просмотра, цена цели по фразам. Диапазон значений от 2 до 365 дней.

7.5 Обновлять ставки только у запущенных объявлений и фраз
Если включено, то ставки обновляются только у запущенных кампаний, объявлений и фраз. По умолчанию выключено, что соотвествует обновлять ставки у всех кампаний, объявлений и фраз.

7.6 Обновлять ставки у ретаргетинга

7.7 Количество фраз за один запрос при обновлении ставок
Количество фраз за один запрос к АПИ при обновлении ставок. Увеличивает потребляемую оперативную память, но при этом увеличивается скорость обновления ставок c Яндекс.Директ. Максимум 10000

7.8 Количество объявлений за один запрос при синхронизации
Это лимит объявлений получаемых за один запрос АПИ при синхронизации. Влияет на потребляемую оперативную память. Максимум 10000

7.9 Максимальное время выполнения скрипта, в секундах
Это время спустя которое программа принимает решение, что задание в планировщике зависло или аварийно завершилось и перезапускает задание. Должно быть больше среднего времени выполнения любого задания в разделе "Задания".

7.10 Временная зона
По умолчанию временная зона соответствует Московскому времени. Если вы хотите, чтобы время в интерфейсе соответствовало вашему локальному времени, то задайте смещение в часах в плюс или в минут относительно Московского времени. Например для Новосибирска в это поле надо вписать "3", для Самары "1", для Владивостока "7", для Берлина "-1".

7.11 Логин Яндекс.XML
Логин для доступа к Яндекс.XML (параметр в запросе: user)
Отвечает за определение позиций у фраз в поисковой выдаче с помощью Яндекс.XML
Необходимо зарегистрировать IP адрес вашего сайта в https://xml.yandex.ru/.
Узнать IP вашего сервера можно в разделе "Диагностика" -> "Конфигурация" или в службе поддержки вашего хостинга.

7.12 Ключ Яндекс.XML
Ключ для доступа к Яндекс.XML (параметр в запросе: key)

7.13 Регион Яндекс.XML
Регион поиска Яндекс.XML (параметр в запросе: lr, Москва - 213, Санкт-Петербург - 2, Пермь - 50, Самара - 51, Тольятти - 240, Чебоксары - 45, Казань - 43, Томск - 67, Новосибирск - 65, Екатеринбург - 54, Челябинск - 56, Сургут - 973, Ростов-на-Дону - 39) - https://xml.yandex.ru/

7.14 Максимальный расход баллов АПИ 5, %
100% позволяет программе расходовать весь дневной лимит баллов. Обновление ставок у 10000 фраз тратит максимум 45 баллов.

единоразовый платеж 5500 руб.
Служба работы с клиентами
Служба технической поддержки