Работа с ретаргетинговыми кампаниями — различия между версиями

Материал из Справочник сервиса Kadam.net
Перейти к: навигация, поиск
Строка 8: Строка 8:
 
[[Файл:работ_ретар_камп_1.jpg|100px|centre|frame|рис. 1]]
 
[[Файл:работ_ретар_камп_1.jpg|100px|centre|frame|рис. 1]]
  
==Статистика по кампании==
+
==Формирование списка ретаргетинга с использованием данных рекламодателя==
Для получения статистики по кампании используется метод <b>ads.analytic.campaign.get</b><br/>
+
Если у рекламодателя есть собственный список пользователей, которым он хочет показывать ретаргетинговую кампанию, то он должен указать URL матчинга.
 
+
Пример URL:  
<table>
+
  <tr bgcolor = #DCDCDC>
+
      <th width = 130 align = left>Параметры</th>
+
      <th width = 300 align = left>Значение</th>
+
      <th width = 350 align = left>Дополнительные атрибуты</th>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>campaign_id</td>
+
      <td>id кампании</td>
+
      <td>int (числовое значение), обязательный параметр</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>region_id</td>
+
      <td>id региона: data.geo.regions.get</td>
+
      <td>int (числовое значение), необязательный параметр</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>period</td>
+
      <td>Способ группировки данных по датам:
+
          <p>day — статистика по дням;</p>
+
          <p>month - статистика по месяцам</p>
+
          <p>Временные ограничения задаются параметрами date_from и date_to</p>
+
      </td>
+
      <td>обязательный параметр, строка</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>date_from</td>
+
      <td>Начальная дата выводимой статистики. Используется разный формат дат для разного значения параметра period:
+
          <p>day: YYYY-MM-DD, пример: 2011-09-27;</p>
+
          <p>month: YYYY-MM, пример: 2011-09</p>
+
      </td>
+
      <td>обязательный параметр, строка</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>date_to</td>
+
      <td>Конечная дата выводимой статистики. Используется разный формат дат для разного значения параметра period:
+
          <p>day: YYYY-MM-DD, пример: 2011-09-27;</p>
+
          <p>month: YYYY-MM, пример: 2011-09</p>
+
      </td>
+
      <td>обязательный параметр, строка</td>
+
  </tr>
+
</table>
+
<b>Результат:</b><br/>
+
Возвращает объект с данными
+
 
<code>
 
<code>
 
<pre>
 
<pre>
{
+
http://adv.com/sync-script.php?id=[UID]&url=[URL]
response: {
+
count: %total items%
+
items: {
+
shows
+
clicks
+
ctr
+
cpm
+
money
+
                      }
+
                  }
+
}
+
 
</pre>
 
</pre>
 
</code>
 
</code>
 +
В УРЛе обязательно должны присутствовать макросы [UID] и [URL].
 +
При показе любых материалов системы на любых площадках, мы вызываем указанный URL. В макросе [UID] мы передаем данные о куки, установленной нашей системой. В макросе [URL] мы передаем УРЛ, который рекламодатель должен вызвать в том случае, если пользователь ему интересен.
 +
При вызове нашего URL в макросе ${UID} рекламодатель должен передать свои куки данного пользователя.
 +
Если рекламодатель вызывает наш URL – пользователь попадает в список ретаргетинга.
 +
 
==Статистика по всем материалам кампании==
 
==Статистика по всем материалам кампании==
 
Для получения статистики по всем материалам кампании используется метод <b>ads.analytic.materials.get</b><br/>
 
Для получения статистики по всем материалам кампании используется метод <b>ads.analytic.materials.get</b><br/>

Версия 09:30, 12 ноября 2015

Что такое ретаргетинг

Ретаргетинг – это маркетинговая технология, которая позволяет показывать ваши рекламные объявления именно тем пользователям, которые ранее уже посещали ваш сайт, но не совершили целевого действия. Особенность и основное отличие ретаргетинга от другой рекламы в том, что вы показываете рекламу только той аудитории, которая интересовалась вашими товарами или услугами и тратите бюджет только на целевую аудиторию. Данный инструмент можно использовать для того, чтобы подтолкнуть к совершению покупки или, например, для уведомления о скидках, акциях, специальных предложениях и т.д. Это может быть реклама тех же товаров (услуг), которые пользователь уже просматривал на вашем сайте, похожих сопутствующих товаров или другие ваши предложения.

Настройка целевой аудитории

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

Создание и настройка целевой аудитории происходит в разделе "Кампания / Аудитория", при нажатии на кнопку "Создать аудиторию". Более подробное описание создания кампании можно найти в статье "Настройки аудитории" [1].

рис. 1

Формирование списка ретаргетинга с использованием данных рекламодателя

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

http://adv.com/sync-script.php?id=[UID]&url=[URL]

В УРЛе обязательно должны присутствовать макросы [UID] и [URL]. При показе любых материалов системы на любых площадках, мы вызываем указанный URL. В макросе [UID] мы передаем данные о куки, установленной нашей системой. В макросе [URL] мы передаем УРЛ, который рекламодатель должен вызвать в том случае, если пользователь ему интересен. При вызове нашего URL в макросе ${UID} рекламодатель должен передать свои куки данного пользователя. Если рекламодатель вызывает наш URL – пользователь попадает в список ретаргетинга.

Статистика по всем материалам кампании

Для получения статистики по всем материалам кампании используется метод ads.analytic.materials.get

Параметры Значение Дополнительные атрибуты
campaign_id id кампании int (числовое значение), обязательный параметр
period Способ группировки данных по датам:

1. day — статистика по дням;

2. month — статистика по месяцам;

Временные ограничения задаются параметрами date_from и date_to

обязательный параметр, строка
date_from Начальная дата выводимой статистики. Используется разный формат дат для разного значения параметра period:

1. day: YYYY-MM-DD, пример: 2011-09-27

2. month: YYYY-MM, пример: 2011-09

обязательный параметр, строка
date_to Конечная дата выводимой статистики. Используется разный формат дат для разного значения параметра period:

1. day: YYYY-MM-DD, пример: 2011-09-27

2. month: YYYY-MM, пример: 2011-09

обязательный параметр, строка

Результат:
Возвращает объект с данными

{
	response: {
		count: %total items%
		items: {
			teaser_id
			date
			shows
			clicks
			ctr
			cpm
			money
                       }
                  }
}

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

Для получения статистики по материалу используется метод ads.analytic.material.get

Параметры Значение Дополнительные атрибуты
material_id id материала int (числовое значение), обязательный параметр
period Способ группировки данных по датам:

1. day — статистика по дням;

2. month — статистика по месяцам;

Временные ограничения задаются параметрами date_from и date_to

обязательный параметр, строка
date_from Начальная дата выводимой статистики. Используется разный формат дат для разного значения параметра period:

1. day: YYYY-MM-DD, пример: 2011-09-27

2. month: YYYY-MM, пример: 2011-09

обязательный параметр, строка
date_to Конечная дата выводимой статистики. Используется разный формат дат для разного значения параметра period:

1. day: YYYY-MM-DD, пример: 2011-09-27

2. month: YYYY-MM, пример: 2011-09

обязательный параметр, строка

Результат:
Возвращает объект с данными

{
	response: {
		count: %total items%
		items: {
			date
			shows
			clicks
			ctr
			cpm
			money
                       }
                  }
}

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

Для для создания новой рекламной кампании используется метод 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%,
       },..]
}