AdPump — Группы объявлений и Ads в API Директа

Группы объявлений (AdGroups) и объявления (Ads) — второй и третий уровень иерархии после кампании.

Коротко: adgroups и ads; ЕПК, ТГО, комбинаторные.

← Каталог API Директа · Введение · Версии API · OAuth и доступ · Сервисы v5 · Лимиты и баллы · Ограничения · Кампании · Ключи и ставки · Минус-фразы и площадки · Отчёты · Песочница · Агентства · Примеры JSON · Ошибки · Автоматизация · Документация Яндекса

Содержание

adgroups
ads
ЕПК
Модерация
Расширения

adgroups — группы объявлений

{

  "method": "add",

  "params": {

    "AdGroups": [{

      "Name": "Группа москва",

      "CampaignId": 12345678,

      "RegionIds": [213],

      "NegativeKeywords": {"Items": ["вакансия"]},

      "TrackingParams": "utm_source=yandex&utm_medium=cpc"

    }]

  }

}

Ключевые поля: RegionIds (справочник GeoRegions через dictionaries.get), NegativeKeywords, Type для ЕПК. adgroups.add.

ads — объявления

Тип	Поле	Описание
Текстовое	TextAd	Заголовок, текст, ссылка, отображаемые ссылки
Графическое	TextImageAd	Текст + изображение
ЕПК	UnifiedAd	Автогенерация заголовков/текстов
Динамическое	DynamicTextAd	По YML-фиду

{

  "method": "add",

  "params": {

    "Ads": [{

      "AdGroupId": 200001,

      "TextAd": {

        "Title": "Доставка цветов за 2 часа",

        "Title2": "От 990 рублей",

        "Text": "Свежие букеты. Бесплатная доставка по Москве.",

        "Href": "https://example.com/flowers",

        "Mobile": "NO",

        "SitelinkSetId": 50001

      }

    }]

  }

}

ЕПК (Unified Campaign)

Единая переключаемая кампания — поиск и сети в одной кампании:

Кампания: UnifiedCampaign в campaigns.add.
Группа: Type: UNIFIED_AD_GROUP в adgroups.add.
Объявление: UnifiedAd с автогенерацией заголовков и текстов.
Ключи добавляются отдельно через keywords.add.

Модерация объявлений

После ads.add статус MODERATION. Проверяйте через ads.get поле Status:

ACCEPTED — одобрено, показы возможны.
REJECTED — отклонено, см. StatusClarification.
MODERATION — на проверке.

Обход модерации запрещён (Ограничения).

Расширения объявлений

Дополнительные сервисы:

sitelinks — быстрые ссылки (наборы ссылок).
adimages — изображения для графических объявлений.
vcards — визитки с адресом и телефоном.
adextensions — уточнения, промоакции.

Перейти в инструмент