Ваш справочник по PPC рекламе

Пополнение баланса

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

Для того что-бы пополнить свой баланс перейдите в Финансы → Движение средств. Создайте «новый платеж». Укажите сумму пополнения и нажмите «Оплатить». После успешной оплаты вы получите уведомление в вашем личном кабинете а так же на почту, использованную при регистрации. 

Обращаем ваше внимание на то, что проводя платеж вы соглашается с нашими правилами, размещенными по ссылке.

Структура рекламной кампании

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

    • Кампания — верхний уровень. Кампания включает в себя группы объявлений. На уровне кампании вам доступны базовые настройки, влияющие на все нижние уровни.
    • Группа объявлений — содержит в себе одно или несколько объявлений, объединенных каким то общим признаком. К примеру, географией показа, устройствами для показа и т.д.
    • Объявление — рекламное сообщение, которое вы хотите показать посетителю сайта

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

Создание рекламной кампании

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

    1. На странице всех кампаний нажать кнопку «Добавить кампанию» ;
    2. Заполнить форму настройки рекламной кампании (жирным — обязательные для заполнения поля):
      • Название — укажите понятное, осмысленное название вашей рекламной кампании. Название может содержать произвольные символы.
      • Период размещения — вы можете установить старт и окончание вашей рекламной кампании. На уровне рекламных групп вы можете установить индивидуальные периоды размещения, которые не могут выходить за пределы периода размещения на уровне рекламной кампании.
      • Бюджет — вы можете указать сколько всего готовы потратить на рекламную кампанию.
      • Дневной бюджетный лимит — вы можете указать сколько готовы тратить на рекламную кампанию в сутки. По умолчанию «0» — показы без лимита.
      • Цена клика — укажите, сколько вы готовы платить за переход по вашему объявлению. Вы можете настраивать индивидуальную стоимость перехода на уровне отдельного объявления. Стоимость перехода может варьироваться от 0.5 грн до 500.00 грн
      • Статус кампании — есть два статуса: «активно» — вы разрешаете кампании показываться; «не активно» — вы не разрешаете кампании показываться.
      • География показа — вы указываете, где именно должна показываться ваша реклама. По умолчанию география для показа — «Украина без АТО и Крыма». На уровне рекламных групп вы можете установить индивидуальную географию показа, которая не может выходить за пределы географии на уровне кампании.
      • Блек-лист — у Вас есть возможность исключить показ объявлений этой рекламной кампании на тех сайтах, аудитория которых Вас не интересует.
      • Вайт-лист — этот функционал позволяет показывать объявления только на тех сайтах, которые вас интересуют.
    3. Нажать кнопку «Сохранить» снизу страницы.

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

Создание рекламной группы

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

    1. Перейти внутрь этой кампании и нажать кнопку «Добавить группу»
    2. Заполнить форму настроек группы объявлений (жирным — обязательные для заполнения поля):
      • Название — укажите понятное, осмысленное название группы объявлений. Название может содержать произвольные символы.
      • Статус группы — есть два статуса: «активно» — вы разрешаете группе показываться; «не активно» — вы не разрешаете группе показываться.
      • Тип баннера — есть два варианта: «tizer» — статическое размещение, «tizer_float» — динамическое размещение (всплывающие тизеры).
      • Блек-лист — здесь Вы можете дополнительно расширить блек-лист, который установлен на уровне кампании.
      • Вайт-лист — этот функционал позволяет показывать объявления конкретной группы только на тех сайтах, которые вас интересуют, если эти сайты не были ранее установлены в блек-лист на уровне кампании.
      • Аудиторный таргетинг — используя этот функционал у Вас есть возможность показывать объявления только пользователям с определенными интересами.
      • География показа — с помощью этого поля вы можете установить индивидуальную географию показа, которая не может выходить за пределы географии на уровне кампании.
      • Устройства, операционные системы и браузеры — спектр настроек, который позволит ограничить показ рекламы на определенных устройствах, по умолчанию — не ограничено.
      • Дата и время показа — временные рамки в сутках, в течении которых должна показываться реклама, по умолчанию — не ограничено.
    3. Нажать кнопку «Сохранить» снизу страницы.

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

Создание объявления

Чтобы создать новое объявление необходимо:

    1. Перейти внутрь нужной вам группы объявлений и нажать кнопку «Добавить объявление»
    2. Заполнить форму настроек рекламного объявления (жирным — обязательные для заполнения поля):
      • Заголовок — укажите понятное и четкое оглавление вашего объявления (до 33). Заголовок может содержать произвольные символы.
      • Описание — детальное представление вашего товара или услуги (до 75 символов).
      • Цена клика — стоимость, которую вы готовы тратить за каждый переход по данному объявлению, по умолчанию — значение берется из настроек кампании.
      • Изображение — здесь необходимо загрузить картинку к вашему объявлению.
      • Ссылка — в этом поле необходимо прописать адрес сайта, на который будет происходить переход, в случае клика пользователем по объявлению.
      • Ссылка для показа — название кнопки, которая размещается под заголовком и описанием объявления (Детальнее.. , Подробнее.. , В магазин..)
      • Статус объявления — «активно» — вы разрешаете объявлению показываться, либо «не активно» — вы не разрешаете объявлению показываться.
    3. Нажать кнопку «Сохранить» в правом верхнем углу.
    4. Если необходимо создать сразу несколько объявлений — лучше использовать мультиформу — провести перед сохранением ряд необходимых действий: «Дублировать» либо «Создать еще», затем, после создания необходимого количества объявлений нажать кнопку «Сохранить» в правом верхнем углу.

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

Требования к объявлениям

Для публикации объявления в рекламной сети необходимо подготовить следующие материалы:

    • Изображение — квадратная картинка, высокого качества (не менее 400*400px);
    • Заголовок объявления — краткое описание товара или услуги (до 33 символов);
    • Описание объявления — детальное представление особенностей товара или услуги (до 75 символов);
    • Ссылка перехода — адрес сайта, куда должен попасть пользователь, нажав на объявление;

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

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

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

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

Ситуации в которых объявление может быть отклонено:

    • Заголовок объявления больше 33 символов;
    • Описание объявления больше 75 символов;
    • Изображение низкого качества, либо выделенный фрагмент не передает суть объявления;
    • Ссылка перехода нерабочая;
    • Ссылка для показа указана неверно;
    • Объявление дублирует предыдущие;


График модерации:

    • Пн — Пт: 08.00 — 22.00
    • Сб — Вс: 09.00 — 21.00

UTM-метки и переменные

utm-метки это инструмент, который обеспечивает передачу дополнительных сведений о источнике перехода в систему аналитики.

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

Виды utm-меток: 

    • utm_source — источник трафика. Метка передает источник, с которого пришел посетитель. Может заполняться как вручную так и автоматически 
    • utm_medium — тип трафика. Другими словами, как именно был привлечен посетитель. Могут присваиваться значения: cpc (оплата за клик); cpm (оплата за показы); email (рассылка) и прочее 
    • utm_campaign — рекламная кампания. Название или же идентификатор рекламной кампании, благодаря которой посетитель попал на сайт 
    • utm_term — ключевое слово. Может заполняться произвольно. 
    • utm_content — тип объявления. Может заполняться произвольно.

Вы можете заполнять значения как вручную, так и используя переменные. В рекламной системе AdPartner есть следующие переменные: 

    • (ad_id) — id рекламного объявления
    • (campaign_id) — id рекламной кампании
    • (site_name) — id сайта, с которого пришел посетитель
    • (banner_id) — id рекламного места, с которого пришел посетитель
    • (click_cost) — цена рекламного перехода в UAH (украинской гривне)

Пример, рекомендуемой разметки для ссылок перехода в рекламной системе AdPartner:

https://adpartner.pro?utm_source=AdPartner&utm_medium=cpc&utm_term=(site_name)&utm_campaign=(campaign_id)&utm_content=(ad_id)

Основные метрики

В списке рекламных кампаний рекламодателю доступны следующие метрики:

    • Показы — сумма показов всех объявлений рекламной кампании за выбранный период;
    • Клики — сумма рекламных переходов по всем объявлениям рекламной кампании за выбранный период;
    • Конверсии — количество целевых действий на стороне сайта рекламодателя, заранее настроенных в трекере, за выбранный период;
    • Конверсии, % — отношение конверсий к кликам, выраженное в процентах;
    • CTR — отношение кликов к показам, выраженное в процентах;
    • vCTR — отношение кликов к видимым показам выраженное в процентах;
    • Стоимость клика — средняя стоимость одного перехода по объявлению рекламной кампании за выбранный период;
    • CPM — средняя цена 1000 показов объявлений рекламной кампании;
    • Стоимость, UAH — затраты на рекламную кампанию за выбранный период;

В списке групп рекламной кампании рекламодателю доступны следующие метрики:

    • Показы — сумма показов всех объявлений группы за выбранный период;
    • Клики — сумма рекламных переходов по всем объявлениям группы за выбранный период;
    • Конверсии — количество целевых действий на стороне сайта рекламодателя, заранее настроенных в трекере, за выбранный период;
    • Конверсии, % — отношение конверсий к кликам, выраженное в процентах;
    • CTR — отношение кликов к показам, выраженное в процентах;
    • vCTR — отношение кликов к видимым показам выраженное в процентах;
    • Стоимость клика — средняя стоимость одного перехода по объявлению группы за выбранный период;
    • CPM — средняя цена 1000 показов объявлений группы;
    • Стоимость, UAH — затраты на группу объявлений за выбранный период;

В списке объявлений группы рекламодателю доступны следующие метрики:

    • Цена клика — цена одного рекламного клика на по объявлению;
    • Показы — сумма показов объявления за выбранный период;
    • Клики — сумма рекламных переходов по объявлению за выбранный период;
    • CTR — отношение кликов к показам объявления, выраженное в процентах;
    • vCTR — отношение кликов к видимым показам объявления, выраженное в процентах;
    • Стоимость клика — средняя стоимость одного перехода по объявлению за выбранный период;
    • CPM — средняя цена 1000 показов объявления;
    • Стоимость, UAH — затраты на объявление за выбранный период;

Отчеты

Первое, что видит рекламодатель, зайдя в свой личный кабинет — это отчет по его рекламным кампаниям, в котором собраны основные показатели за определенный период, такие как: показыкликиконверсииконверсии, %CTRvCTRстоимость кликаCPMстоимость. 

Также у рекламодателя есть возможность посмотреть отчет по сайтам, на которых показываются объявления всех его рекламных кампаний.
Для этого необходимо нажать на кнопку «Отчет по кампаниям» и выбрать с выпадающего списка — «По сайтам».
Здесь собраны основные показатели за определенный период, такие как: показыкликиCTRvCTRстоимость кликастоимость 1000 показов; стоимость.

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


Здесь у рекламодателя также есть возможность посмотреть отчет показателей всех групп в кампании по сайтам и по дням.
Для этого необходимо нажать на кнопку «Отчет по группам» и выбрать с выпадающего списка — «По сайтам» либо «По дням».

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

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

Для этого необходимо нажать на кнопку «Отчет по объявлениям» и выбрать с выпадающего списка — «По сайтам» либо «По дням».

На всех уровнях присутствует функционал, который позволяет выгрузить отчет в файл Excel или распечатать его на принтере — кнопки над таблицей показателей, «Excel» и «Print», соответственно.

Виды ремаркетинга

Одним из самых эффективных инструментов для увеличения количества конверсий является ремаркетинг.

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

Существует два вида ремаркетинга:

    • Классический — инструмент, который более подходит для владельцев одностраничных сайтов, позволяет возвращать пользователя обратно на посадочную страницу рекламодателя.
    • Динамический — инструмент, который больше подходит для владельцев интернет-магазинов, позволяет возвращать пользователя на страницу именно того товара, которым интересовался конкретный пользователь.
      Для его работы понадобится ссылка на xml-файл магазина.

Установка ремаркетингового пикселя

Если вы решили использовать такой инструмент, как ремаркетинг, первое что вам нужно сделать — это сообщить об этом намерении менеджеру и запросить у него ремаркетинговый пиксель.
Ремаркетинговый пиксель — это часть кода, который необходимо установить на сайте рекламодателя.

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

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

Классический ремаркетинг

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

Этапы активации классического ремаркетинга:

    1. Запросить у менеджера ремаркетинговый пиксель;
    2. Установить пиксель на все страницы сайта;
    3. Отписаться менеджеру, чтобы он проверил правильность установки и завершил настройку ремаркетинговой группы.

Динамический ремаркетинг

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

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

    1. Предоставить менеджеру доступ к xml-файлу магазина;
    2. Запросить у менеджера ремаркетинговый пиксель;
    3. Установить пиксель на все страницы сайта;
    4. Отписаться менеджеру, чтобы он проверил правильность установки и завершил настройку рекламной кампании с динамическим ремаркетингом.

Требования к XML файлу

Ниже содержатся технические требования к xml файлу

Структура xml / yml каталога для экспорта товаров

<yml_catalog date="2018-01-01 08:00">

<shop>

<name>Bestbay</name>

<company>Bestbay co.</company>

<url>http://bestbay.com.ua</url>

<currencies>

<currency id="UAH" rate="1"/>

<currency id="USD" rate="27"/>

</currencies>

<categories>

<category id="1">Мобильные устройства</category>

<category id="10" parentId="1">Телефоны</category>

<category id="101" parentId="10">Смартфоны</category>

<category id="102" parentId="10">Смарт часы</category>

</categories>

<offers>

...

</offers>

</shop>

</yml_catalog>

Описание элементов
nameкороткое название магазина, не более 20 символовобязательное
companyполное название магазина или компании, владеющей магазиномобязательное
urlurl адрес главной страницы магазинаобязательное
currenciesкурс валют магазинаобязательное
categoriesсписок товарных категорий магазинаобязательное
offersсписок товаров магазинаобязательное

Каждый товар xml / yml каталога представлен в виде элемента <offers>. Ниже приведен пример отдельного элемента

Структура элемента <offers> для каталога экспорта товаров

 

<offer id="1" available="true" bid="1,40" >

<url>http://bestbay.com.ua/product_name</url>

<price>250</price>

<oldprice>350</oldprice>

<currencyId>UAH</currencyId>

<categoryId>102</categoryId>

<picture>http://best.seller.ru/img/model_12345.jpg</picture>

<store>true</store>

<pickup>false</pickup>

<delivery>true</delivery>

<vendor>Brand</vendor>

<name>Мороженица Brand 3811</name>>

<description>

<![CDATA[

<h3>Мороженица Brand 3811</h3>

<p>Это прибор, который придётся по вкусу всем любителям десертов и сладостей, ведь с его помощью вы сможете делать вкусное домашнее мороженое из натуральных ингредиентов.</p>

]]>

</description>

<param name="Цвет">белый</param>

<manufacturer_warranty>true</manufacturer_warranty>

<country_of_origin>Китай</country_of_origin>

<barcode>0123456789379</barcode>

<rec>789,120</rec>

</offer>

Описание элементов
offerКарточка товараобязательное
offer idИдентификатор товараобязательное
offer availableНаличие товара. true — товар есть в наличии / false — товар отсутствует. При значении false товар не будет показываться пользователюобязательное
urlurl страницы товара на сайте. Допускаются кириллические ссылкиобязательное
pictureurl изображения товараобязательное
priceТекущая цена товараобязательное
currencyidВалюта, в которой указана цена товараобязательное
categoryidИдентификатор товарной категории, к которой принадлежит данный товараобязательное
nameПолное название товараобязательное
descriptionПолное описание товара. Длина текста не должна превышать 100 символов (превышение будет игнорироваться) В описании запрещено: использовать слова «скидка», «распродажа», «дешевый», «подарок» (кроме подарочных категорий), «бесплатно», «акция», «специальная цена», «новинка», «new», «аналог», «заказ», «хит»,указывать номера телефонов, адреса электронной почты, почтовые адреса, номера ICQ, логины мессенджеров, любые URL-ссылки. В формате YML допустимо использовать xhtml-теги при условии, что: они заключены в блок CDATA в форматеобязательное
oldpriceСтарая цена товара. В отдельных случаях, при заполненной старой цене, объявление будет содержать две цены и презентовать товар со скидкойне обязательное

Дополнительные возможности интерфейса

На всех уровнях взаимодействия с личным кабинетом (уровень кампании, группы, объявления) в интерфейсе присутствует многофункциональная кнопка «Изменить». Она работает вместе с чекбоксом (галочками) в таблице показателей.

    1. На уровне кампании у вас есть возможность выбрать необходимую кампанию (или кампании) и, применив кнопку «Изменить», включить или остановить ее.
    2. На уровне группы вы также можете выбрать необходимую группу (или группы) и, применив кнопку «Изменить», включить или остановить ее.
    3. Самый широкий функционал на уровне объявления.

Здесь у вас есть возможность выбрать необходимое объявление (или объявления) и, применив кнопку «Изменить», включить или остановить его, изменить ссылкуизменить ценускопировать его или вставить заранее скопированные объявления в эту группу.

XML рекламные кампании

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

Аудиторный таргетинг

Лучший способ найти целевую аудиторию из всех обитателей интернета — понимать кто же чем интересуется. Для оптимизации ваших расходов, мы распределили наш трафик по интересам. 
Таким образом, в личном кабинете у вас есть возможность настроить показ рекламы только на людей, которые интересуются вашим товаром или услугой. Это позволит поднять кампанию в выдаче и сэкономить ваши средства.
Для того, чтобы активировать данный функционал, необходимо в настройках группы найти поле «Аудиторный таргетинг» и отметить в нем галочками необходимые аудитории.
После этого — сохранить изменения.

Интеграция с помощью API

Мы даем возможность нашим клиентам интегрировать внешние приложения с рекламной системой AdPartner с помощью API.

Для работы с API вам понадобится:

    • client_id — ваш идентификатор в нашей рекламной системе
    • API_key для подтверждения права доступа к информации

Всю эту информацию вы можете получить у вашего менеджера, или же обратившись в службу поддержки.

Функционал API AdPartner позволяет использовать набор команд GET, с помощью которых можно получить следующие данные:

Баланс клиента

 

запрос: https://cp.adpartner.pro/api/v1/clients/client_id?token=API_key

ответ:

параметр

содержимое

id

id клиента

wallet

массив значений

wallet[balance]

текущий баланс

wallet[credit]

кредитный лимит

wallet[income]

сумма пополнений за весь период сотрудничества

Кампании клиента

 

запрос: https://cp.adpartner.pro/api/v1/campaigns?token=API_key

ответ:

параметр

содержимое

id

id рекламной кампании/й

name

название рекламной кампании/й

status

текущий статус: active — активная | manual_stopped — приостановлена вручную | ended — завершена | stopped_by_day_limit — приостановлена — достигнут суточный лимит | stopped_by_out_of_money — приостановлена — закончились средства на балансе | not_active — неактивно | process — в обработке | closed — закрыто | reject — отклонено | on_moderation — на модерации

statistic

массив значений

statistic[views]

число просмотров

statistic[clicks]

число переходов

statistic[wages]

расход

Кампания клиента

 

запрос: https://cp.adpartner.pro/api/v1/campaigns/campaigns_id?token=API_key

ответ:

параметр

содержимое

id

id рекламной кампании

name

название рекламной кампании

status

текущий статус: active — активная | manual_stopped — приостановлена вручную | ended — завершена | stopped_by_day_limit — приостановлена — достигнут суточный лимит | stopped_by_out_of_money — приостановлена — закончились средства на балансе | not_active — неактивно | process — в обработке | closed — закрыто | reject — отклонено | on_moderation — на модерации

statistic

массив значений

statistic[views]

число просмотров

statistic[clicks]

число переходов

statistic[wages]

расход

groups[]

массив значений (группы кампании)

groups[][id]

id группы / групп

Группа рекламной кампании

 

запрос: https://cp.adpartner.pro/api/v1/groups/groups_id?token=API_key

ответ:

параметр

содержимое

id

id рекламной группы

name

название рекламной группы

status

текущий статус: active — активная | manual_stopped — приостановлена вручную | ended — завершена | stopped_by_day_limit — приостановлена — достигнут суточный лимит | stopped_by_out_of_money — приостановлена — закончились средства на балансе | not_active — неактивно | process — в обработке | closed — закрыто | reject — отклонено | on_moderation — на модерации

statistic

массив значений

statistic[views]

число просмотров

statistic[clicks]

число переходов

statistic[wages]

расход

ads[]

массив значений (объявления группы)

ads[][id]

id объявления / объявлений

Объявление рекламной кампании

 

запрос: https://cp.adpartner.pro/api/v1/ads/ads_id?token=API_key

ответ:

параметр

содержимое

id

id рекламного объявления

name

название рекламного объявления

status

текущий статус: active — активная | manual_stopped — приостановлена вручную | ended — завершена | stopped_by_day_limit — приостановлена — достигнут суточный лимит | stopped_by_out_of_money — приостановлена — закончились средства на балансе | not_active — неактивно | process — в обработке | closed — закрыто | reject — отклонено | on_moderation — на модерации

statistic

массив значений

statistic[views]

число просмотров

statistic[clicks]

число переходов

statistic[wages]

расход

Дополнительные параметры для работы с API

Все запросы, кроме запроса баланса, поддерживают параметры для работы с датами и периодами.

 

Работа с заданными периодами

параметр

значения

dateInterval

default — по умолчанию установлен интервал за последние 90 дней | interval — при выборе ожидается передача еще параметров двух дат startDate/endDate в формате гггг-мм-дд | thisWeek — текущая неделя | lastWeek — прошлая неделя | thisMonth — текущий месяц | lastMonth — прошлый месяц | lastSeven — последние 7 дней | today — сегодня | yesterday — вчера | last30Days — последние 30 дней

 

Пример использования: статистика кампании по текущей неделе

https://cp.adpartner.pro/api/v1/campaigns/campaigns_id?token=API_key&dateInterval=thisWeek

Работа с произвольными периодами

параметр

значения

interval

ожидается передача еще двух параметров startDate/endDate

startDate

дата старта выборки в формате ГГГГ-ММ-ДД

endDate

дата окончания выборки в  формате ГГГГ-ММ-ДД

 

Пример использования: статистика кампании с 1 июня 2019 года по 7 июня 2019 года

https://cp.adpartner.pro/api/v1/campaigns/campaigns_id?token=API_key&dateInterval=interval&startDate=2019-06-01&endDate=2019-06-07

Коды статусов

код статуса

описание

200

успешный ответ

403

пользователь нераспознан

400

запрос не верен

404

отсутствует реклама