Примеры фидов по категориям — Директ. Справка

Примеры заполнения фида для некоторых категорий в формате YML.

<offer available="true">
  <name>Парогенератор Bosch TDS 4040</name>
  <typePrefix>Парогенератор</typePrefix>
  <model>TDS 4040</model>
  <vendor>Bosch</vendor>
  <description>Мощность: 2400 Вт; Постоянная подача пара: есть; Вертикальное отпаривание: есть; Вес: 3.4 кг; Автоматическое отключение: есть; Автоматическая регулировка пара: есть; Расход при паровом ударе: 270 г/мин; Максимальное давление пара: 5.5 бар;</description>
  <vendorCode>100028173415</vendorCode>
  <param name=«Цвет»>белый, синий, серый</param>
  <param name=«Материал»>Пластик</param>   
  <param name=«Размер» unit="см">Длина 38.5 Ширина 19.2 Высота 26</param>
  <param name=«Длина» unit="см">38.5</param>
  <param name=«Ширина» unit="см">19. 2</param>
  <param name=«Высота» unit="см">26</param>
  <condition>new</condition>
  <categories>123</categories>
  <picture>https://avatars.mds.yandex.net/get-mpic/5209485/img_id4945386046892792794.jpeg/orig</picture>
  <url>https://market.yandex.ru/product--parogenerator-bosch-tds-4040/1807277658</url>
  <price>11670</price>
  <oldprice>12000</price>
</offer>
              

<offer available="true">
  <name>Ультра-стойкий матовый карандаш для губ Kylie matte liquid lipstick & lip pencil</name>
  <vendor>Kylie</vendor>
  <price>982.00</price>
  <oldprice>1560.19</oldprice>
  <url>https://example.ru/kosmetika/blesk-dlja-gub_07/kylie/blesk-dlya-gub-karandash-kylie-matte-liquid-lipstick--lip-liner12tsv/</url>
  <currencyId>RUB</currencyId>
  <categoryId>1809</categoryId>
  <picture>https://example.
  ru/wa-data/public/shop/products/91/82/18291/images/13653/13653.970.jpeg</picture>
  <picture>https://example.ru/wa-data/public/shop/products/91/82/18291/images/13750/13750.970.jpg</picture>
  <picture>https://example.ru/wa-data/public/shop/products/91/82/18291/images/16256/16256.970.jpg</picture>
  <description>	<![CDATA[ <p>Карандаш для губ: Ультра-стойкий карандаш для губ имеет кремообразную текстуру, которая легко скользит по губам, очень легкое и удобное применение. Карандаш для губ легко затачивается в большинстве стандартных точилок.</p> ]]></description>
  <param name="Цвет">Красный</param>
  <param name="Объем"></param>
  <param name="Пол">Женский</param>
  <param name="Возраст">Для взрослых</param>
</offer>
            

<offer available="true">
  <url>https://www.example.ru/myagkaya-mebel/loft-ellou/</url>
  <price>29400</price>
  <oldprice>35280</oldprice>
  <currencyId>RUR</currencyId>
  <categoryId>1</categoryId>
  <picture>https://www. example.ru/model-image/loft-ellou-1400x1400-32405.jpg</picture>
  <vendor>Фабрика монолит</vendor>
  <model>Лофт Еллоу</model>
  <typePrefix>Диван</typePrefix>
  <name>Диван Лофт Еллоу механизм еврокнижка Фабрика монолит</name>
  <description>
  <![CDATA[ Современный диван Лофт Еллоу.Прочный механизм трансформации «еврокнижка» и удобные большие подушки. Большое спальное место. - Наполнитель - ППУ+ремни - Механизм трансформации – еврокнижка (два модуля) - Подушки набивные :поролоновая крошка+синтешар - Ткань только как на фото:велюр max yelloy 27 - высота сиденья 44 см - Глубина сиденья без подушек - 82 см - Глубина сиденья с подушками - 57 см - Толщина ппу на спальном месте – 10 см - Ящик для белья из лдсп Общий габарит: 250x97x95(150x200). ]]>
  </description>
  <param name="Длина" unit="см">250</param>
  <param name="Ширина" unit="см">97</param>
  <param name="Высота" unit="см">95</param>
  <param name="Размер" unit="см">Ширина 250 Ширина 97 Высота 95</param>
  <param name="Механизм">еврокнижка</param>
  <param name="Цвет">серый</param>
  <param name="Материал">Рогожка</param>
</offer>
            

<offer available="true">
  <url>https://example. ru/katalog-tovarov/vitaminy/vitaminy-gruppy-b/kompleks-vitaminov-b-50-now-100-tab</url>
  <price>1799</price>
  <oldprice>2000</oldprice>
  <currencyId>RUR</currencyId>
  <categoryId>160</categoryId>
  <store>true</store>
  <pickup>true</pickup>
  <name>NOW - комплекс витаминов B-50, 100 капс</name>
  <vendor>Now Foods</vendor>
  <picture>https://example.ru/assets/cache/images/vitamin/gruppa_b/kompleks-vitaminov-b-50-now-100-tab-01-x-7bd.jpeg</picture>
  <description>
  <![CDATA[ Комплекс витаминов B-50 помогут обеспечить организм важнейшими витаминами группы B, которые отвечают за многие процессы в человеческом организме. Принимают участие в росте и укреплении волос, а так же укрепляют нервную систему. ]]>
  </description>
</offer>
          

<offer available="true">
  <url>https://example.ru/catalog/jersey/product/FM220311B/</url>
  <price>8550.
  00</price>
  <currencyId>RUB</currencyId>
  <categoryId>5</categoryId>
  <picture>https://example.ru/upload/iblock/f6a/f6a5c906e5a473034a26b7db5b2e24ba.jpg</picture>
  <name>Длинное приталенное трикотажное черное платье бюстье</name>
  <vendor>You wanna</vendor>
  <description>"Сексуальное приталенное трикотажное платье. Его особенность в форме брителей, ведь они выполненены не типично и вызывают внимание. Будь ваша обувь высокая или низкая, платье сделает свое дело
  <br/>
  -платье
  <br/>
  -трикотаж
  <br/>
  -бюстье"
  </description>
  <param name="Цвет">Черный</param>
  <param name="Размер">ONE SIZE</param>
  <param name="Материал">Вискоза</param>
  <param name="Пол">Женский</param>
  <param name="Возраст">Для взрослых</param>
</offer>
            

<offers>
  <offer available="true" type="vendor. model">
  <typePrefix>Горный велосипед</typePrefix>
  <model>26.1 V</model>
  <vendor>ABCD</vendor> 
  <vendorCode>F2DDVX67DV</vendorCode>
  <description>Горный велосипед с широкими покрышками, сочетающий в себе надежность и универсальность. Он отлично показывает себя в городе и за его чертой. Модель подойдет как начинающим, так и опытным райдерам.</description>
  <categoryId>2</categoryId>
  <picture>https://domain/btrx/i/11/97/66/48/01_808.jpg</picture>
  <picture>https://domainbtrx/i/11/97/66/48/01_808.jpg</picture>
  <url>https://www.магазин-велосипедов.рф/product/F2DDVX67DV</url>
  <price>17680</price>
  <oldprice>20000</price>
  <param name="Цвет">Белый</param>
  <param name="Материал">Алюминий</param>  
  <param name="Пол">Унисекс</param>
  <param name="Возраст">Для взрослых</param>
  </offer>
</offers>
            

<offer available="true">
  <url>https://example. ru/ukrasheniya/kolco_black_ring/</url>
  <price>900</price>
  <oldprice>2000</oldprice>
  <currencyId>RUB</currencyId>
  <categoryId>85</categoryId>
  <picture>https://example.ru/image/catalog/Jewellery/Ring/DSC_012971.jpg</picture>
  <picture>https://example.ru/image/catalog/Jewellery/Ring/DSC_01254.jpg</picture>
  <picture>https://example.ru/image/catalog/Jewellery/Ring/DSC_01314.jpg</picture>
  <picture>https://example.ru/image/catalog/Jewellery/Ring/DSC_01273.jpg</picture>
  <picture>https://example.ru/image/catalog/Jewellery/Ring/DSC_0126.jpg</picture>
  <delivery>true</delivery>
  <name>Серебряное кольцо с черной эмалью King Black Ring</name>
  <vendor>King</vendor>
  <model>Black Ring</model>
  <typePrefix>Серебряное кольцо</typePrefix>
  <description>
  <![CDATA[ <div><div>Кольцо на руку из ювелирного сплава, родированное покрытие и эмаль.  <br></div><div><br></div><div><b>Цвет: </b>серебрянный с черной эмалью.</div><div><br></div></div><p><b>Уход</b>: После водных процедур обязательно рекомендуется просушить.</p><p>Избегать попадания спиртосодержащих средств.</p><pHelvetica Neue", Helvetica, Arial, sans-serif; letter-spacing: 0.02em;"><span><span>Параметры изделия</span></span><span>?безразмерное.</span><span><br></span></p><br> ]]>
  </description>
  <param name="Размер">17</param>
  <param name="Материал">Серебро</param>
  <param name="Цвет">Серебряный, черный</param>
  <param name="Пол">Унисекс</param>
</offer>
            

Внимание. Специалисты отдела клиентского сервиса могут вас проконсультировать только по рекламным кампаниям того логина, с которого вы обращаетесь. Логин можно увидеть в правом верхнем углу экрана. Специалист получит доступ к вашим данным только при обработке обращения.

 Написать в чат

Клиентам и представителям агентств можно связаться с нами круглосуточно по телефонам:

Россия: 8 800 234-24-80 (звонок из России бесплатный)

Москва: +7 495 739-37-77

Беларусь: 8 820 00-73-00-52 (звонок из Беларуси бесплатный), +375 17 336-31-36

Казахстан: +7 727 313-28-05, доб. 2480

Для доступа к кампаниям специалисту потребуется PIN-код.

Типы рекламы в Яндекс Директе и как выбрать подходящий

Чтобы составить объявление в Директе правильно, для начала стоит разобраться в видах рекламных кампаний, которые предлагает Яндекс. От этого зависит конверсионность. Подготовили для вас материал, в котором рассказываем о типах и форматах объявлений, а также о правилах их написания.

Текстово-графические

Текстово-графический — самый популярный из типов рекламных кампаний в Яндекс. Директе. Создать такое объявление проще и быстрее всего, основная формула «текст + картинка». Однако есть и вариации:

1. Только текст

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

   
   Пример текстового объявления в выдаче
   

2. Текст и картинка

   Самый распространенный вариант. Появляется на площадках РСЯ, реже в поисковой выдаче. Если в тексте объявления указана цена товара, Яндекс покажет его в разделе «Маркет».

   
   Пример текстового объявления в разделе «Новости»
   

3. Текст и видеодополнение

   Этот вид объявления в Директе похож на предыдущий, но вместо картинки в нем короткое видео. Продолжительность — не более пятнадцати секунд.

4. Только картинка

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

5. Только видео

   Ролик о вашем товаре/услуге продолжительностью до пятнадцати секунд. Может сопровождаться звуком. Он появляется, когда пользователь наводит мышку на объявление.

6. Для мобильных устройств

   Все перечисленные выше виды объявлений в Яндекс.Директ можно адаптировать для показа на мобильных экранах. Их удобнее просматривать со смартфона. С помощью такого объявления можно сразу позвонить рекламодателю через значок «телефонная трубка».

Смарт-баннеры

Смарт-баннеры — интерактивный вид рекламной кампании в Директе. Выглядят как карточки товаров с фото, ценой и описанием. Отличия от текстово-графических объявлений:

• Некоторые смарт-баннеры можно перелистывать.
• Динамически подстраиваются под каждого пользователя.

Примеры смарт-баннеров

Информация для смарт-баннеров подгружается из товарного фида — файла с данными обо всех продуктах/услугах на сайте. Яндекс.Директ автоматически комбинирует объявления на основе этих данных. Оплата в такой рекламной кампании идет за клик.

Динамические объявления

Еще один тип рекламной кампании в Яндекс.Директ, упрощающий работу с большим количеством однотипных объявлений. Они создаются системой автоматически под каждый товар (на основе данных фида или информации с сайта). Заголовки и текст меняются под запрос пользователя. Отличие от смарт-баннеров — размещаются в поиске, а не в РСЯ.

Мобильные приложения

Вид рекламных объявлений в Директе, с помощью которых продвигаются только мобильные приложения для Android и iOS. Система автоматически подгружает в РК прямую ссылку на приложение в магазинах Google Play и AppStore. Также пользователь видит его стоимость, рейтинг, количество оценок и другие характеристики. Объявления демонстрируются на поиске и в РСЯ, исключительно на мобильных устройствах с которыми приложение совместимо.

Медийно-контекстные баннеры

Крупные баннеры, размещающиеся на поиске — справа от выдачи. Появляются сразу в ответ на запрос пользователя (могут рекламировать как непосредственно запрашиваемые товары, так и сопутствующие). Обычно на них размещают фото, информацию о скидке, сроки акции. Этот вид объявлений приводит к большим охватам, повышает узнаваемость вашего продукта/компании.

Пример медийно-контекстного баннера

РСЯ

РСЯ (рекламная сеть Яндекса) — это множество сайтов-партнеров поисковой системы, которые дают место под размещение ее рекламы. В их число входят новостные агрегаторы, сервисы, блоги, сайты компаний и СМИ, интернет-магазины и множество других площадок. В РСЯ можно разместить следующие виды рекламных кампаний Директа:

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

Размещение объявлений на площадках РСЯ эффективно при ретаргетинге. Когда вам нужно «догнать» и вернуть пользователя на ваш сайт.

Медийная реклама в Директе

Медийная реклама — это зрелищный формат рекламы в Яндекс.Директе. Яркие баннеры, видео- и аудиореклама. Объявления этого типа обычно приносят гораздо больше лидов, чем простые текстово-графические РК. Однако это всего лишь крючок, цепляющий внимание потенциального покупателя. Привлекательная реклама не отменяет необходимости в эффективной воронке продаж.

Баннеры

Баннеры в Директе бывают двух видов — статические и динамические (HTML5-баннеры). Полные технические требования для них вы найдете на Яндекс.Справке. Ниже мы привели некоторые из обязательных правил.

Для статических баннеров:

• Формат — JPG, PNG или GIF.
• Размер в пикселях — 1456 × 180 для десктопной версии, 640 × 134 для мобильной.
• Максимальный вес файла — 1 МБ.

Для динамических баннеров:

• Формат — ZIP-архив с файлами HTML, JavaScript, JSON, CSS, JPEG, GIF, PNG, SVG.
• Размер в пикселях — 1456 × 180.
• Максимальный вес архива — 1 МБ.

Примеры баннеров в РСЯ

Видеореклама

Существует пять видов видеорекламы в Яндекс.Директе:

1. Потоковое видео (мультиролл). Проигрывается до/после показа основного ролика (размещается на видеохостингах РСЯ).
2. Видео в контенте (in-page). Появляется на сайтах с текстами, проигрывается при скроллинге страницы.
3. Видео в приложениях (Interstitial). Размещается в мобильных приложениях. Проигрывается перед/во время загрузки, при смене экрана и так далее.
4. Видео с вознаграждением. Показывается во время прохождения игр в мобильных приложениях. Пользователи награждаются за просмотр игровой валютой.
5. В нативном блоке. Баннерная реклама, которая органично встраивается в интерфейс приложений.

Технические требования (более подробно представлены в Яндекс. Справке):

• Рекомендуемая продолжительность — 15 секунд, максимальная — 30 секунд.
• Частота кадров — от 20 до 30 кадров в секунду.
• Рекомендуемое соотношение сторон — 16:9.
• Минимальная высота — 240 пикселей, минимальная ширина — 640 пикселей.
• Максимальное количество видеопотоков — 1, звуковых дорожек — 1.
• Длина бегущей строки — до 200 знаков.
• Минимальный размер шрифта — 18 пикселей (при разрешении 640 × 360).

Аудиореклама

Аудиореклама — еще один тип объявлений в Директе. Размещается на сервисах Яндекс.Музыка и Яндекс.Радио. А также на партнерских аудиоплощадках Яндекса — на радиостанциях, в приложениях с подкастами и прочих. Такую рекламу можно сопроводить графическим баннером и ссылкой, по которой пользователь будет переходить на лендинг.

Ретаргетинг

Ретаргетинг — вид рекламной кампании в Яндекс.Директе, направленный на пользователей, которые уже взаимодействовали с вашим брендом. Сегменты для ретаргетинга (людей, которые заходили на ваш сайт) можно собрать при помощи Яндекс.Метрики и Яндекс.Аудиторий. Этот тип РК решает следующие задачи:

1. Возвращение пользователей, которые еще ничего не купили, но потенциально заинтересованы в покупке.
2. Снижение стоимости привлечения клиента — вы показываете рекламу «теплой» аудитории.
3. Увеличение среднего чека, благодаря рекламе сопутствующих товаров/услуг.
4. Превращение единичных клиентов в постоянных (трансляция рекламы о новых товарах, скидках, акциях).

Геореклама

Геореклама — тип объявлений в Директе, который демонстрируется пользователю в близости от рекламируемого объекта. Например, реклама салона красоты рядом со станцией метро, где часто проходит потенциальный клиент. Есть два формата таких РК:

1. Гиперлокационный таргетинг. Настраивается по сегменту геолокации в Яндекс.Аудиториях. Минимальное расстояние — 500 метров.
2. Приоритетное размещение в Яндекс.Справочнике. После этого название вашей компании будет появляться в поисковой строке после введения подходящего запроса (в Яндекс.Картах и других мобильных приложениях-картах).

Как понять, какая реклама нужна вам?

Чтобы выбрать формат рекламы в Яндексе, нужно определиться с целью рекламной кампании. Вот самые распространенные из них:

• Повысить узнаваемость компании/бренда. Для этого подойдут баннеры на поиске и главной (а также другие медийные объявления).
• Увеличить CTR. Здесь можно использовать текстово-графические объявления — простой, но эффективный инструмент.
• Реклама интернет-магазина. Для демонстрации десятков и сотен товаров потенциальным покупателям подойдут смарт-баннеры и динамические объявления.

Правила составления эффективных объявлений в Яндекс.Директ

Итак, вы выбрали тип рекламной кампании в Яндекс.Директе. Теперь вам необходимо составить объявления — для этого есть определенные правила. Их соблюдение необходимо не только для того, чтобы ваша РК была эффективной. Но и чтобы система допустила вашу рекламу к показу потенциальным покупателям. Эти правила указаны в Яндекс.Справке — мы выделили главные из них.

Рекомендации по оформлению объявлений в Директе

Заголовок

1. Четко определите рекламируемый товар/услугу.

   Придерживайтесь правила — один продукт на одно объявление. Это должно быть отражено и в тексте, и в заголовке, и на фотографии/видео.

2. Не используйте слова в сравнительной и превосходной степени.

   Эти слова можно использовать только в том случае, если у вас есть независимое заключение о преимуществе вашего продукта перед конкурентами.

3. Если рекламируете СМИ — нужно это указать.

   Яндекс требует явно указывать в заголовке/тексте объявления, что рекламируется информационный ресурс. Для этого подойдут слова «подробнее», «читать далее» и подобные.

4. Не используйте запрещенные слова и тематики.

   Среди них — жаргонизмы, обсценная лексика, ложная информация. Не допускаются заголовки с агрессивными призывами, повторы одних и тех же слов/фраз, набор слов капсом. Нельзя указывать контактную информацию — для этого есть другие части объявления.

Иконка

Иконка — маленькое изображение рядом с текстово-графическим объявлением. Требования к ней такие же, как и к полноразмерной картинке:

• Высокая четкость изображения.
• Соответствие заголовку и тексту объявления, а также лендингу.
• Если на иконке есть текст — требования такие же, как к заголовку и тексту объявления.
• Не использовать изображения продукции конкурентов.
• Не использовать изображения с запрещенными к рекламе предметами: оружие, алкоголь, сигареты и другое.

Ссылка

К ссылке в объявлениях всех форматов Яндекс.Директ также предъявляет требования. Она должна:

• вести на корректный лендинг, соответствующий тексту объявления;
• корректно отображаться во всех браузерах, в десктопных и мобильных версиях;
• не быть инструментом фишинга;
• не содержать всплывающих блоков;
• не содержать контактных данных, информацию о скидках, акциях;
• не содержать слов, набранных транслитом;
• не содержать символов, кроме #, /, %, -, №.

Визитка

К объявлению можно прикрепить виртуальную визитку — ссылку «Контактная информация». При нажатии на нее появляется окошко с номером телефона, адресом, временем работы и другими данными. К тексту визитки предъявляются те же требования, что и к заголовку и тексту объявления.

Пример рекламных объявлений с визиткой

Название компании

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

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

1. Заполните поля с основным и дополнительным заголовками.

   Вам может не хватить 35 знаков, чтобы описать уникальное торговое предложение. Здесь поможет дополнительный заголовок — это еще 30 знаков.

2. Текст объявления должен раскрывать заголовок.

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

3. Текст объявления должен обещать решить проблему пользователя.

   Какую проблему пользователя решит переход по вашему объявлению? Постарайтесь ответить на этот вопрос и четко донести полученный ответ в тексте.

4. Краткость, конкретность, информативность.

   Пишите текст в информационном стиле — без метафор и пространных выражений. Приведите факты и цифры, используйте короткие и конкретные предложения.

5. Упомяните об акциях и спецпредложениях.

   Этот ход всегда приводит на сайт больше трафика, чем объявления без скидки. Используйте только в том случае, если действительно проводите акцию и собираетесь снизить цену на товар/услугу для пользователя.

Распространенные ошибки при составлении объявлений

• Плохо изложено/отсутствует УТП.
• Нет призыва к действию («купить», «заказать», «подписаться»).
• Заголовки не соответствуют ключевой фразе.
• Ссылка ведет на нерелевантный лендинг.
• Не используются расширения.

Автоматическое создание объявлений в Директ

Автоматическое создание рекламной кампании в Яндекс.Директе можно реализовать с помощью K50:Генератор. С помощью Генератора вы быстро создадите и запустите такие виды продающих объявлений, как смарт-баннеры, динамические, текстово-графические и другие. K50: Генератор обладает широкой морфологией, поддерживает функцию «если» и имеет гибкие шаблоны — объявления выглядят органически, как созданные вручную.

отчетов вместо GetBannersStat (Live). API Яндекс Директ. Версия 5

В этом примере для получения статистики используется служба отчетов.

Он показывает вызов GetBannersStat (Live) со следующими параметрами:

 curl \
  -д '{
    "метод": "GetBannersStat",
    "локаль": "en",
    "токен": "0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f",
    "параметр": {
      «ID кампании»: 10007,
      «Дата начала»: «01. 05.2018»,
      "КонечнаяДата": "2018-05-07",
      "GroupByColumns": [ "clDate", "clPhrase", "clROI" ],
      «Лимит»: 200,
      "Смещение": 0,
      "Порядок": ["clDate"],
      «Валюта»: «RUB»,
      "Включить НДС": "Да",
      "IncludeDiscount": "Да"
   }
  }' \
  https://api.direct.yandex.ru/live/v4/json/ 

Пример возвращаемых данных:

 {
  "данные": {
    "Стат": [{
      "StatDate": "2018-05-01",
      «ID фразы»: 414808784,
      "Фраза": "путешествие! в космос",
      «ID баннера»: 7654321,
      «Выручка»: 8271,77,
      «ROI»: 2,51,
      «Клики»: 329,
      «КликиПоиск»: 307,
      «Кликсконтекст»: 22,
      "Показывает": 2224,
      "ПоискПоиска": 1246,
      "ШоусКонтекст": 978,
      «Сумма»: 2356-29,
      "СуммаПоиск": 2303.68,
      "Сумконтекст": 52,61,
    },... ],
    «Дата начала»: «01.05.2018»,
    "КонечнаяДата": "2018-05-07",
    "Идентификатор кампании": 10007
  }
} 

Следующий запрос к службе отчетов позволяет получить те же данные:

 curl \
  -H 'Авторизация: носитель 0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f' \
  -H 'Принять-язык: en' \
  -H 'Клиент-Логин: agrom' \
  -H 'returnMoneyInMicros: false' \
  -д '{
    "параметры": {
      "Критерий выбора": {
        "ДатаОт": "2018-05-01",
        "DateTo": "2018-05-07",
        "Фильтр": [{
          "Поле": "CampaignId",
          «Оператор»: «В»,
          "Значения": ["10007"]
        }]
      },
      "FieldNames": [ "Дата", "AdId", "CriterionId", "CriterionType",
                      "Критерий", "Стоимость", "Клики", "Показы",
                      "AdNetworkType", "Доход", "GoalsRoi" ],
      "Страница": {
        "Лимит": 200
      },
      "Сортировать по": [{
        «Поле»: «Дата»
      }],
      "ReportName": "Доход и рентабельность инвестиций",
      "Тип отчета": "CUSTOM_REPORT",
      "DateRangeType": "CUSTOM_DATE",
      "Формат": "TSV",
      "Включить НДС": "ДА",
      "IncludeDiscount": "ДА"
    }
  }' \
  https://api. direct.yandex.com/json/v5/reports 

Объяснение:

• Чтобы получить отчет по клиенту агентства, укажите логин клиента в HTTP-заголовке Client-Login .

• Чтобы получить в отчете денежные значения в валюте рекламодателя, установите HTTP-заголовок returnMoneyInMicros: false .

• Чтобы получить отчет по конкретной кампании, отфильтруйте по CampaignId.

• Чтобы получить отчет за определенные даты, укажите эти даты в параметрах DateFrom и DateTo, а для параметра DateRangeType установите значение CUSTOM_DATE.

• Для получения статистики в разрезе объявлений включите поле AdId в параметр FieldNames.

• Для получения статистики в разрезе ключевых слов включите в параметр FieldNames поля CriterionId, CriterionType и Criterion.

• Чтобы получать статистику отдельно по поисковой и рекламной сетям, укажите поле AdNetworkType в параметре FieldNames. Строки отчета со значением SEARCH в этом поле содержат статистику по поиску, а строки со значением AD_NETWORK показывают статистику в рекламных сетях.

Образец отчета:

 "Доход и рентабельность инвестиций (01.05.2018 - 07.05.2018)"
Дата AdId CriterionId CriterionType Критерий Стоимость Клики Показы AdNetworkType Доход ЦелиRoi
2018-05-01 7654321 414808784 KEYWORD "путешествие !в космос" 2303,68 307 1246 ПОИСК 8104,22 2,52
01.05.2018 7654321 414808784 KEYWORD "путешествие! в космос" 52,61 22 978 AD_NETWORK 167,55 2,18
... 

метод «получить». API Яндекс Директ. Версия 5

При вызове метода get необходимо явно перечислить параметры, которые вы хотите получить, в массиве FieldNames.

Если в запросе указано

 "FieldNames": ["Id","Name","Status"] 

вы получите идентификаторы, имена и статусы объектов.

Если вам нужно получить параметр, для которого не задано значение, метод get возвращает значение null в этом параметре. См. раздел Значение null (nil).

Используйте входную структуру SelectionCriteria для фильтрации объектов в методе get . Набор критериев различается для разных сервисов. Это указано в описании получить метод для каждой службы.

Каждый критерий работает как оператор IN в SQL. Если задано несколько критериев, они объединяются с помощью условия И: вы получите объекты, которые одновременно соответствуют всем критериям. Если объекты, соответствующие критериям, не найдены, возвращается пустая структура.

Примечание. Метод get игнорирует идентификаторы объектов, которые не существуют, удалены или не принадлежат рекламодателю. Он не возвращает никаких предупреждений или ошибок для таких идентификаторов.

Если запрос устанавливает критерии

 "SelectionCriteria": {
   "CampaignIds": [1234567,1234589,1234777],
   "Статусы": ["ПРЕДВАРИТЕЛЬНО", "ПРИНЯТО"]
} 

вы получите объекты со статусом PREACCEPTED или ACCEPTED, принадлежащие кампаниям 1234567, 1234589 или 1234777. Аналогично оператору SQL SELECT … WHERE CampaignId IN (1234567,1234589,1234777) AND Status IN («PREACCEPTED» ,»ПРИНЯЛ»).

Метод get возвращает не более 10 000 объектов на запрос. Чтобы получить разбитые на страницы данные, используйте структуру

 "Страница": { /* LimitOffset */
   «Предел»: (длинный),
   «Смещение»: (длинное)
} 

Parameter	Type	Description	Required
LimitOffset structure
Limit	long	Количество возвращенных объектов (размер страницы). От 0 до 10 000. Если опущено, ограничение составляет 10 000.	Нет
Смещение	длинное	Количество объектов, которые следует пропустить при получении выделения. Если опущено, предполагается 0.	Нет

Если запрос устанавливает это:

 "Страница": { /* LimitOffset */
   «Лимит»: 200,
   "Смещение": 600
} 

Будет возвращено

объекта с номерами от 601 до 800.

Если возвращаемая страница не последняя (в выборке остались еще объекты), метод get возвращает поле LimitedBy — номер последнего возвращенного объекта. Чтобы получить следующую страницу, укажите значение LimitedBy как Offset для следующего вызова метода get с тем же SelectionCriteria.