Изменение рекламы

Перед изменением

Попросите агента прочитать текущие данные, показать номера объектов, прежние и предлагаемые значения. После согласования агент передаёт confirm: true нужному инструменту. Для повторной проверки используются инструменты чтения.

Ответ API может содержать частичный успех: одни объекты изменились, другие получили отказ. Проверяйте результаты каждого объекта, поля applied, errors и warnings там, где они возвращаются. Одного верхнего ok: true недостаточно, чтобы считать все элементы изменёнными.

Ставки и бюджеты

Перед назначением ставки прочитайте direct_get_campaigns и direct_get_keyword_bids. Признак strategy.manual_bids показывает возможность ручного управления. На автоматической стратегии ручную ставку Директ может отклонить или не применить; сменить стратегию существующей кампании этим плагином нельзя.

direct_set_keyword_bid принимает отбор по фразам, группам или кампаниям. Это альтернативные способы отбора, их нельзя смешивать. Ставка на группу или кампанию заменяет индивидуальные ставки входящих фраз: сначала сохраните текущие значения. Автоматическое назначение запрашивается через auto: true; параметры такого вызова описаны в схеме инструмента.

direct_set_campaign_budget задаёт daily_budget в валюте аккаунта. Режим STANDARD используется по умолчанию, DISTRIBUTED задаёт распределение расхода в течение дня. remove: true снимает дневное ограничение. Для кампаний с ручными ставками инструмент предупреждает, что Директ пересчитывает дневной бюджет в недельный по расписанию показов.

Остановка и архив

Выбирайте уровень действия по задаче:

resume возобновляет показы, если выполнены условия Директа; он не заменяет первоначальный запуск черновика. Архивный объект сначала возвращают из архива. Возобновление может снова включить расход.

Минус-фразы и списки ограничений

• direct_add_campaign_negative_keywords дополняет текущий список кампании.
• Минус-фразы группы добавляются через direct_update_adgroup.
• direct_remove_campaign_negative_keywords и direct_remove_adgroup_negative_keywords снимают выбранные фразы; remove_all: true очищает соответствующий список.
• direct_add_shared_negative_keywords создаёт или дополняет общий набор. Изменение существующего набора действует во всех кампаниях, где он используется.
• direct_update_campaign привязывает или отвязывает общие наборы. negative_keyword_sets_operation поддерживает ADD, REMOVE и SET.

При добавлении минус-фраз плагин сначала читает список и сохраняет уже заданные фразы. При снятии он записывает остаток. Не добавляйте знак минуса перед фразой в аргументе negative_keywords.

У direct_update_adgroup регионы показа заменяются целиком: передавайте полный желаемый список регионов.

Запрещённые площадки (direct_set_excluded_sites) и заблокированные IP (direct_set_blocked_ips) поддерживают operation: ADD, REMOVE и SET. SET заменяет весь список, пустой список с SET очищает его. Плагин читает прежние значения перед записью. Для IP предусмотрен предел 25 адресов на кампанию.

Объявления и дополнения

direct_update_ads работает с текстовыми и комбинаторными объявлениями. Модель определяется по данным Директа; отдельной настройки выбора модели нет.

Для комбинаторного объявления передавайте полные списки titles и texts, если хотите их заменить. Короткая запись title или text, которая потеряла бы варианты, отклоняется с would_lose_variants. Остальные непереданные поля не изменяются.

Дополнения создаются отдельно, затем присоединяются через direct_update_ads:

Загрузка картинки сама по себе не добавляет её в объявление. У direct_add_ad_image до десяти изображений за вызов и предел файла 10 МБ. Можно задать crop_ratio для обрезки по центру; перекодирование и обрезка зависят от наличия GD на сервере.

Цена задаётся блоком price, возрастная метка — age_label, описание для ЕРИР — erir_description. Изменение объявления, уже прошедшего модерацию, может потребовать повторной модерации со стороны Директа.

Ретаргетинг и автотаргетинг

Условие ретаргетинга создаёт direct_add_retargeting_list. Его привязка к группе выполняется через direct_add_audience_target и может повлиять на показы работающей группы. Ставку и состояние привязки меняют direct_set_audience_target_bid и direct_set_audience_target_state.

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

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

Новая кампания

Обычная последовательность инструментов:

direct_create_campaign
  → direct_add_adgroup
  → direct_add_ads
  → direct_add_keywords

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

Новые объявления создаются без отправки на модерацию. Проверьте структуру и тексты в интерфейсе Директа, выполните необходимые шаги оплаты, модерации и запуска. Фактический тип созданной кампании проверяйте через direct_get_campaigns: он зависит от аккаунта и может быть UNIFIED_CAMPAIGN.

Добавление группы или фраз в уже работающую кампанию не создаёт для неё отдельного изолированного режима проверки. Учитывайте текущее состояние кампании и объявлений.

Товарные фиды

direct_manage_feed без feed_id создаёт фид по URL: нужны name, business_type и url. С feed_id редактируется существующий фид. Доступ к закрытой выгрузке передаётся в login и password, снятие UTM-меток задаётся remove_utm_tags.

Созданный фид обрабатывается не мгновенно. Статус и товары проверяйте через direct_get_feeds. Файловые фиды инструмент не загружает; тип бизнеса существующего фида менять им нельзя.

Удаление без возврата

direct_delete_objects требует отдельного права в группе «Удаление без возврата» и confirm: true. Аргумент object_type выбирает вид объекта:

Изображения выбираются через image_hashes, остальные объекты — через ids. Отмены удаления инструментом нет. Директ может отказать в удалении конкретного объекта; проверяйте поэлементные результаты. Для временного прекращения показов используйте остановку, для кампаний и объявлений также доступен архив.