Работа с ретаргетинговыми кампаниями
Содержание
- 1 Что такое ретаргетинг
- 2 Настройка целевой аудитории
- 3 Формирование списка ретаргетинга с использованием данных рекламодателя
- 4 Статистика по всем материалам кампании
- 5 Статистика по материалу
- 6 Создание рекламной кампании
- 7 Редактирование рекламных кампаний
- 8 Список кампаний рекламного кабинета
- 9 Архивирование клиентов рекламного агенства
- 10 Получение кодов для СРА кампаний
- 11 Получение списка категорий по заданому фильтру
- 12 Получение списка форматов объявлений
- 13 Получение списка платформ
- 14 Получение списка браузеров
Что такое ретаргетинг
Ретаргетинг – это маркетинговая технология, которая позволяет показывать ваши рекламные объявления именно тем пользователям, которые ранее уже посещали ваш сайт, но не совершили целевого действия. Особенность и основное отличие ретаргетинга от другой рекламы в том, что вы показываете рекламу только той аудитории, которая интересовалась вашими товарами или услугами и тратите бюджет только на целевую аудиторию. Данный инструмент можно использовать для того, чтобы подтолкнуть к совершению покупки или, например, для уведомления о скидках, акциях, специальных предложениях и т.д. Это может быть реклама тех же товаров (услуг), которые пользователь уже просматривал на вашем сайте, похожих сопутствующих товаров или другие ваши предложения.
Настройка целевой аудитории
Таргетинг целевой аудитории - инструмент позволяющий настраивать ваши рекламные кампании под конкретно интересующую аудиторию пользователей. Данный функционал позволяет формировать аудиторию по ключевым словам, страницам или доменам, которыми ранее интересовались пользователи.
Создание и настройка целевой аудитории происходит в разделе "Кампания / Аудитория", при нажатии на кнопку "Создать аудиторию". Более подробное описание создания кампании можно найти в статье "Настройки аудитории" [1].
Формирование списка ретаргетинга с использованием данных рекламодателя
Если у рекламодателя есть собственный список пользователей, которым он хочет показывать ретаргетинговую кампанию, то он должен указать URL матчинга. Для этого необходимо в подразделе "Аудитории" нажать на кнопку "Получить код":
В появившейся форме следует заполнить поля:
- Название - название аудитории
- Срок участия - Поле для ввода количества дней, в течение которых пользователю будет показываться ретаргетинговая реклама. От 1 до 180 дней. По умолчанию 30. Отсчет начинается с момента установки куки пользователю.
- URL для матчинга – поле для ввода ссылки, только для рекламодателей, у которых есть уже сформированные списки ретаргетинга
Пример URL:
http://adv.com/sync-script.php?id=[UID]&url=[URL]
В УРЛе обязательно должны присутствовать макросы [UID] и [URL].
При показе любых материалов системы на любых площадках, мы вызываем указанный URL. В макросе [UID] мы передаем данные о куки, установленной нашей системой. В макросе [URL] мы передаем УРЛ, который рекламодатель должен вызвать в том случае, если пользователь ему интересен.
При вызове нашего URL в макросе ${UID} рекламодатель должен передать свои куки данного пользователя.
Если рекламодатель вызывает наш URL – пользователь попадает в список ретаргетинга.
Статистика по всем материалам кампании
Для получения статистики по всем материалам кампании используется метод ads.analytic.materials.get
Статистика по материалу
Для получения статистики по материалу используется метод ads.analytic.material.get
Создание рекламной кампании
Для для создания новой рекламной кампании используется метод ads.campaigns.put
Допустимое количество кампаний, создаваемых с помощью одного запроса — 50.
| Параметры | Значение | Дополнительные атрибуты |
|---|---|---|
| data | сериализованный JSON-массив объектов, описывающих создаваемые кампании. Описание объектов client_specification см. ниже. | обязательный параметр, строка |
| client_specification | ||
| client_id | id клиента, в рекламном кабинете которого будет создаваться кампания. Так же может принимать значение app_id (самого себя) | обязательный параметр, int (числовое значение) |
| ad_format | Формат объявления:
10 - Тизерная; 20 - Баннерная; 30 - VK-message; 40 - Clickunder; 60 - Контекстная |
обязательный параметр, int (числовое значение) |
| cost_type | Способ оплаты:
0 - СРС; 1 - СРА; 2 - СРМ |
обязательный параметр, int (числовое значение) |
| Link_url | ссылка на рекламируемый объект в формате: http://yoursite.cоm | обязательный параметр, строка |
| sex | Пол:
3 - любой; 2 - мужской; 1 - женский |
int (числовое значение) |
| age | Возвраст: /data.ages | последовательность чисел, разделенных запятой |
| cpa_mode | Тип уведомлений о конверсий для CPA: /ads.targeting.modes.get | int (числовое значение), обязательное для CPA кампании |
| categories | идентификаторы категорий: /data.categories.get?ad_format=% category_id: {region_id: cost} |
|
| tags | таргетинг по ключевым словам | последовательность ключевых слов, разделенных запятой: [“key1”, “key2”, .., “keyN”] Ключевые слова с ценой. Только для оплаты - за клики или за показы: {“key1”: “cost”, “key2”: “cost”, .., “keyN”: “cost”} cost - float |
| day_limit | Дневной лимит в рублях. Для всех типов кроме clickunder | положительное число |
| all_limit | Общий лимит в рублях. Для всех типов кроме clickunder | положительное число |
| click_limit | Максимальное кол. переходов в день. Для всех типов кроме clickunder. За показы и за клики. | положительное число |
| conversion_limit | Максимальное кол. конверсий в день. Для всех типов кроме clickunder. Только для CPA | положительное число |
| adult_content | присутсвие контента для взрослых в рекламной кампании:
0 - Нет; 1 - Да |
необязательный параметр, int (числовое значение), по умолчанию 0 |
| adult_site | Отображать объявления кампании на сайтах с контентом для взрослых:
0 - Нет; 1 - Да |
необязательный параметр, int (числовое значение), по умолчанию 0 |
| time_show | Временной таргетинг:
* - отображение в любые часы и дни недели {} - массив, где ключ имя дня недели ["Sn","Mn","Tu","Wd","Th","Fr","Sa"]: {} - ‘mn’: ‘*’ - все часы понендельника {} - ‘mn’: [0, .., 23] - часы через запятую |
необязательный параметр, * по умолчанию |
| platforms | таргетинг по платформам: /data.platforms | последовательность чисел, разделенных запятой |
| browsers | таргетинг по браузерам: /data.browsers | последовательность чисел, разделенных запятой |
| black_list | черный список площадок на которых не будет показана реклама | последовательность чисел ID площадок, разделенных запятой |
| white_list | белый список площадок на которых не будет показана реклама | последовательность чисел ID площадок, разделенных запятой |
| black_list_ip | блокировка по ip | последовательность ip адресов, разделенных запятой или массивом |
Результат:
Возвращает массив ответов на запросы в массиве data. Соответствующий объект в выходном массиве содержит id созданной кампании, и поля error_code и error_desc в случае возникновения ошибки.
Errors:
102 - unknown client 103 - overlimit campaigns
Редактирование рекламных кампаний
Для редактирования рекламных кампаний используется метод ads.campaigns.update
Максимальное допустимое количество кампаний, редактируемых с помощью одного запроса — 50.
Version log: 1.0.1 - добавлен параметр status
| Параметры | Значение | Дополнительные атрибуты |
|---|---|---|
| data | сериализованный JSON-массив объектов, описывающих изменения в кампаниях. Описание объектов client_mod_specification см. ниже. | обязательный параметр, строка |
| client_specification | ||
| campaign_id | id редактируемой кампании | обязательный параметр, положительное число |
| name | название кампании | необязательный параметр, строка длиной от 3 до 60 символов |
| link_url | ссылка на рекламируемый объект в формате http://yoursite.cоm | необязательный параметр, строка |
| sex | Пол:
3 - любой; 2 - мужской; 1 - женский |
необязательный параметр, int (числовое значение) |
| age | возраст: /data.ages | необязательный параметр, int (числовое значение) |
| categories | идентификаторы категорий:
/data.categories.get?ad_format=% category_id: {region_id: cost} |
необязательный параметр |
| tags | таргетинг по ключевым словам | необязательный параметр, последовательность ключевых слов, разделенных запятой |
| day_limit | дневной лимит в рублях. для всех типов кроме clickunder | необязательный параметр, положительное число |
| adult_content | присутсвие контента для взрослых в рекламной кампании:
0 - Нет; 1 - Да |
необязательный параметр, int (числовое значение), по умолчанию 0 |
| adult_site | отображать объявления кампании на сайтах с контентом для взрослых:
0 - Нет; 1 - Да |
необязательный параметр, int (числовое значение), по умолчанию 0 |
| time_show | Временной таргетинг:
* - отображение в любые часы и дни недели {} - массив, где ключ имя дня недели ["Sn","Mn","Tu","Wd","Th","Fr","Sa"]: {} - ‘mn’: ‘*’ - все часы понендельника {} - ‘mn’: [0, .., 23] - часы через запятую |
необязательный параметр, * по умолчанию |
| platforms | таргетинг по платформам: /data.platforms | последовательность чисел, разделенных запятой |
| browsers | таргетинг по браузерам: /data.browsers | последовательность чисел, разделенных запятой |
| black_list | черный список площадок на которых не будет показана реклама | последовательность чисел ID площадок, разделенных запятой |
| white_list | белый список площадок на которых не будет показана реклама | последовательность чисел ID площадок, разделенных запятой |
| black_list_ip | блокировка по ip | последовательность ip адресов, разделенных запятой или массивом |
| status | запуск/приостановка кампании:
0 - приостановлена; 1 - запущена |
необязательный параметр, int (числовое значение), по умолчанию 1 |
Результат:
Возвращает массив ответов на каждый запрос в массиве data. Соответствующий объект в выходном массиве содержит id изменяемого клиента и, в случае возникновения ошибки, поля error_code и error_desc.
Errors:
100 - unknown campaign 102 - unknown client
Список кампаний рекламного кабинета
Для получения списка кампаний рекламного кабинета используется метод ads.campaigns.get
| Параметры | Значение | Дополнительные атрибуты |
|---|---|---|
| client_id | Идентификатор клиента, у которого запрашиваются рекламные кампании | int (числовое значение) |
| include_archive | Флаг, задающий необходимость вывода архивных объявлений:
0 - выводить только активные кампании; 1 - выводить все кампании |
Флаг, может принимать значения 1 или 0 |
| campaign_ids | Фильтр выводимых рекламных кампаний.
Сериализованный JSON-массив, содержащий id кампаний. Выводиться будут только кампании, присутствующие в campaign_ids и являющиеся кампаниями указанного рекламного кабинета. Если параметр равен null, то выводиться будут все кампании. |
Строка |
| limit | ограничение на количество возвращаемых кампаний. Используется, только если параметр campaign_ids равен null | int (числовое значение) |
| offset | смещение. Используется в тех же случаях, что и параметр limit | int (числовое значение) |
Результат:
Возвращает массив объектов campaign, каждый из которых содержит следующие поля:
response: {
count: %total%,
items: [{
id — идентификатор кампании
name — название кампании
status — статус кампании (0 — кампания остановлена, 1 — кампания запущена, 2 — кампания удалена)
day_limit — дневной лимит кампании в рублях (0 — лимит не задан)
all_limit — общий лимит кампании в рублях (0 — лимит не задан)
ad_format — формат объявления
cost_type — тип оплаты
link_url - ссылка на рекламируемый объект
sex - пол
age - возраст
regions - идентификаторы регионов
categories - идентификаторы категорий.
adult_content - присутсвие контент для взрослых
adult_site - отображение объявлений кампании на сайтах с контентом для взрослых
},..]
}
Errors:
102 - unknown client
Архивирование клиентов рекламного агенства
Для архивирования клиентов рекламного агенства используется метод ads.campaigns.delete
Максимальное допустимое количество клиентов, редактируемых с помощью одного запроса — 10.
| Параметры | Значение | Дополнительные атрибуты |
|---|---|---|
| ids | Список id кампаний через запятую или массив с id кампаниями.
Например: “id1, id2, …, idn“ или [id1, id2, …, idn] |
обязательный параметр, строка |
Результат:
Возвращает массив ответов на каждый запрос. Каждый ответ является либо 0, что означает успешное удаление, либо массив error.
Errors:
100 - unknown campaign 101 - campaign already archive 102 - unknown client
Получение кодов для СРА кампаний
Для получения кодов по СРА кампаниям используется метод ads.campaigns.cpa.mode.get
| Параметры | Значение | Дополнительные атрибуты |
|---|---|---|
| campaign_id | id кампании | int (числовое значение), обязательный параметр |
Результат:
Возвращает объект с данными.
{
response: {
url: %url%
}
}
Получение списка категорий по заданому фильтру
Для возврата списка категорий по заданому фильтру используется метод ads.campaigns.categories.get
| Параметры | Значение | Дополнительные атрибуты |
|---|---|---|
| ad_format | формат объявления:
ads.campaigns.foarmats.get |
обязательный параметр, int (числовое значение) |
| category_id | id категории. ограничивает отображение только по id категории | необязательный параметр, int (числовое значение) |
Результат:
Возвращает массив ответов на запросы в массиве response.
response: {
count: %total%,
items: [{
%category_id%: {
%region_id%: {
min: %min_cost%,
max: %max_cost%
}
}
},..]
}
Получение списка форматов объявлений
Для получения списка форматов объявлений используется метод ads.campaigns.formats.get
Результат:
Возвращает массив ответов на запросы в массиве response.
response: {
count: %total%,
items: [{
id: %format_id%,
title: ‘%format title%’
},..]
}
Получение списка платформ
Для получения списка платформ используется метод ads.targeting.platforms.get
Результат:
Возвращает массив ответов на запросы в массиве response.
response: {
count: %,
items: [{
id: %platform_id%,
title: %platform_name%,
mobile: %is mobile%
},..]
}
Получение списка браузеров
Для получения списка браузеров используется метод ads.targeting.browsers.get
Результат:
Возвращает массив ответов на запросы в массиве response.
response: {
count: %,
items: [{
id: %browser_id%,
title: %browser_name%,
},..]
}
