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

Материал из Справочник сервиса Kadam.net
Перейти к: навигация, поиск
(Формирование списка ретаргетинга с использованием Kadam кода)
 
(не показано 97 промежуточных версий этого же участника)
Строка 1: Строка 1:
==Что такое ретаргетинг==
+
==Что такое ретаргетинг== <!--T:1-->
 
Ретаргетинг – это маркетинговая технология, которая позволяет показывать ваши рекламные объявления именно тем пользователям, которые ранее уже посещали ваш сайт, но не совершили целевого действия. Особенность и основное отличие ретаргетинга от другой рекламы в том, что вы показываете рекламу только той аудитории, которая интересовалась вашими товарами или услугами и тратите бюджет только на целевую аудиторию. Данный инструмент можно использовать для того, чтобы подтолкнуть к совершению покупки или, например, для уведомления о скидках, акциях, специальных предложениях и т.д. Это может быть реклама тех же товаров (услуг), которые пользователь уже просматривал на вашем сайте, похожих сопутствующих товаров или другие ваши предложения.
 
Ретаргетинг – это маркетинговая технология, которая позволяет показывать ваши рекламные объявления именно тем пользователям, которые ранее уже посещали ваш сайт, но не совершили целевого действия. Особенность и основное отличие ретаргетинга от другой рекламы в том, что вы показываете рекламу только той аудитории, которая интересовалась вашими товарами или услугами и тратите бюджет только на целевую аудиторию. Данный инструмент можно использовать для того, чтобы подтолкнуть к совершению покупки или, например, для уведомления о скидках, акциях, специальных предложениях и т.д. Это может быть реклама тех же товаров (услуг), которые пользователь уже просматривал на вашем сайте, похожих сопутствующих товаров или другие ваши предложения.
 
+
==Списки ретаргетинга==
==Настройка целевой аудитории==
+
Для создания нового списка ретаргетинга в разделе "Кампании / Аудитории" необходимо нажать на кнопку "Получить код":
Таргетинг целевой аудитории - инструмент позволяющий настраивать ваши рекламные кампании под конкретно интересующую аудиторию пользователей. Данный функционал позволяет формировать аудиторию по ключевым словам, страницам или доменам, которыми ранее интересовались пользователи.
+
[[Файл:Retargetskr.png|100px|centre|frame|рис. 1]]
 
+
В появившейся форме необходимо заполнить следующие поля:
Создание и настройка целевой аудитории происходит в разделе "Кампания / Аудитория", при нажатии на кнопку "Создать аудиторию". Более подробное описание создания кампании можно найти в статье "Настройки аудитории" [http://wiki.kadam.net/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%B0%D1%83%D0%B4%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%B8].
+
[[Файл:работ_ретар_камп_1.jpg|100px|centre|frame|рис. 1]]
+
 
+
==Формирование списка ретаргетинга с использованием данных рекламодателя==
+
Если у рекламодателя есть собственный список пользователей, которым он хочет показывать ретаргетинговую кампанию, то он должен указать URL матчинга. Для этого необходимо в подразделе "Аудитории" нажать на кнопку "Получить код":
+
[[Файл:работ_ретар_камп_2.jpg|100px|centre|frame|рис. 2]]
+
В появившейся форме следует заполнить поля:
+
 
<ul>
 
<ul>
 
         <li><b>Название</b> - название аудитории</li>
 
         <li><b>Название</b> - название аудитории</li>
 
         <li><b>Срок участия</b> - Поле для ввода количества дней, в течение которых пользователю будет показываться ретаргетинговая реклама. От 1 до 180 дней. По умолчанию 30. Отсчет начинается с момента установки куки пользователю.</li>
 
         <li><b>Срок участия</b> - Поле для ввода количества дней, в течение которых пользователю будет показываться ретаргетинговая реклама. От 1 до 180 дней. По умолчанию 30. Отсчет начинается с момента установки куки пользователю.</li>
 
         <li><b>URL для матчинга</b> – поле для ввода ссылки, только для рекламодателей, у которых есть уже сформированные списки ретаргетинга</li>
 
         <li><b>URL для матчинга</b> – поле для ввода ссылки, только для рекламодателей, у которых есть уже сформированные списки ретаргетинга</li>
 +
        <li><b>XML-фид</b> - укажите ссылку на товарный xml-фид. Только для динамического ретаргетинга (более подробное описание можно найти в статье <i>[[Создание_xml-фида_для_динамического_ретаргетинга|Создание xml-фида для динамического ретаргетинга]]</i>)</li>
 
</ul>
 
</ul>
[[Файл:работ_ретар_камп_4.jpg|100px|centre|frame|рис. 3]]
+
[[Файл:Работ_ретар_камп_11.JPG|100px|centre|frame|рис. 2]]
Пример URL:  
+
==Формирование списка ретаргетинга с использованием Kadam кода==
<code>
+
В таблице со списками ретаргетинга для каждой аудитории, которая была создана с помощью действия "Получить код" отображается ссылка «Код ремаркетинга».
 +
[[Файл:Retargetskr2.png|100px|centre|frame|рис. 3]]
 +
При клике по ссылке открывается всплывающее окно, содержащее код контейнера, который Вам '''НЕ следует''' устанавливать вовсе. На страницу своего сайта нужно установить код согласно шаблона предварительно поставив в него id аудитории:
 
<pre>
 
<pre>
http://adv.com/sync-script.php?id=[UID]&url=[URL]
+
<img src="//r.uuidksinc.net/match/xxxxxxx/" width="1" height="1" />
 +
где xxxxxxx - id созданной аудитории
 
</pre>
 
</pre>
</code>
+
<!-- Для работы с динамическим ретаргетингом, также необходимо устновить код из второго поля под кодом контейнера.
В УРЛе обязательно должны присутствовать макросы [UID] и [URL].<br>
+
[[Файл:Динамич_ретар_камп_3.JPG|100px|centre|frame|рис. 4]-->
При показе любых материалов системы на любых площадках, мы вызываем указанный URL. В макросе [UID] мы передаем данные о куки, установленной нашей системой. В макросе [URL] мы передаем УРЛ, который рекламодатель должен вызвать в том случае, если пользователь ему интересен.<br>
+
Посетителям страниц сайта, на которых установлен контейнер, будет установлен файл cookie на то количество дней, которое указано в настройках списка ретаргетинга. Таким образом пользователь попадет в список ретаргетинга.
При вызове нашего URL в макросе ${UID} рекламодатель должен передать свои куки данного пользователя.
+
Показы ретаргетинговой кампании по аудитории, которая собиралась именно с использованием Kadam кода, будут начинаться сразу же после поступления хотя бы одного пользователя в аудитории. Количество пользователей аудитории с использованием Kadam кода не отображаются (будет стоять всегда "-"). Показы ретаргетинговой кампании по остальным аудиториям будут начинаться только если список ретаргетинга составляет более 50 человек. Если список менее 50 человек, статус кампании – «Ожидает аудитории».
Если рекламодатель вызывает наш URL – пользователь попадает в список ретаргетинга.
+
<!--При выполнении пользователем определенных действий на странице с рекламными материалами, информация по ID товара и уровню заинтересованности пользователя, может передаваться с помощью специального скрипта:
 
+
==Статистика по всем материалам кампании==
+
Для получения статистики по всем материалам кампании используется метод <b>ads.analytic.materials.get</b><br/>
+
 
+
==Статистика по материалу==
+
Для получения статистики по материалу используется метод <b>ads.analytic.material.get</b><br/>
+
 
+
==Создание рекламной кампании==
+
Для для создания новой рекламной кампании используется метод <b>ads.campaigns.put</b><br>
+
Допустимое количество кампаний, создаваемых с помощью одного запроса — 50.<br/>
+
<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>data</td>
+
      <td>сериализованный JSON-массив объектов, описывающих создаваемые кампании. Описание объектов client_specification см. ниже.</td>
+
      <td>обязательный параметр, строка</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>client_specification</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>client_id</td>
+
      <td>id клиента, в рекламном кабинете которого будет создаваться кампания. Так же может принимать значение app_id (самого себя)
+
      </td>
+
      <td>обязательный параметр, int (числовое значение)</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>ad_format</td>
+
      <td>Формат объявления:
+
          <p>10 - Тизерная;</p>
+
          <p>20 - Баннерная;</p>
+
          <p>30 - VK-message;</p>
+
          <p>40 - Clickunder;</p>
+
          <p>60 - Контекстная</p>
+
      </td>
+
      <td>обязательный параметр, int (числовое значение)</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>cost_type</td>
+
      <td>Способ оплаты:
+
          <p>0 - СРС;</p>
+
          <p>1 - СРА;</p>
+
          <p>2 - СРМ</p>
+
      </td>
+
      <td>обязательный параметр, int (числовое значение)</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>Link_url</td>
+
      <td>ссылка на рекламируемый объект в формате: http://yoursite.cоm
+
      </td>
+
      <td>обязательный параметр, строка</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>sex</td>
+
      <td>Пол:
+
          <p>3 - любой;</p>
+
          <p>2 - мужской;</p>
+
          <p>1 - женский</p>
+
      </td>
+
      <td>int (числовое значение)</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>age</td>
+
      <td>Возвраст: /data.ages</td>
+
      <td>последовательность чисел, разделенных запятой</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>cpa_mode</td>
+
      <td>Тип уведомлений о конверсий для CPA: /ads.targeting.modes.get</td>
+
      <td>int (числовое значение), обязательное для CPA кампании</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>categories</td>
+
      <td><p>идентификаторы категорий:</p>
+
          <p>/data.categories.get?ad_format=%</p>
+
          <p>category_id: {region_id: cost}</p>
+
      </td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>tags</td>
+
      <td>таргетинг по ключевым словам</td>
+
      <td><p>последовательность ключевых слов, разделенных запятой: [“key1”, “key2”, .., “keyN”]</p>
+
          <p>Ключевые слова с ценой. Только для оплаты - за клики или за показы: {“key1”: “cost”, “key2”: “cost”, .., “keyN”: “cost”}</p>
+
          <p>cost - float</p>
+
      </td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>day_limit</td>
+
      <td>Дневной лимит в рублях. Для всех типов кроме clickunder</td>
+
      <td>положительное число</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>all_limit</td>
+
      <td>Общий лимит в рублях. Для всех типов кроме clickunder</td>
+
      <td>положительное число</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>click_limit</td>
+
      <td>Максимальное кол. переходов в день. Для всех типов кроме clickunder. За показы и за клики.</td>
+
      <td>положительное число</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>conversion_limit</td>
+
      <td>Максимальное кол. конверсий в день. Для всех типов кроме clickunder. Только для CPA</td>
+
      <td>положительное число</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>adult_content</td>
+
      <td>присутсвие контента для взрослых в рекламной кампании:
+
          <p>0 - Нет;</p>
+
          <p>1 - Да</p>
+
      </td>
+
      <td>необязательный параметр, int (числовое значение), по умолчанию 0</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>adult_site</td>
+
      <td>Отображать объявления кампании на сайтах с контентом для взрослых:
+
          <p>0 - Нет;</p>
+
          <p>1 - Да</p>
+
      </td>
+
      <td>необязательный параметр, int (числовое значение), по умолчанию 0</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>time_show</td>
+
      <td>Временной таргетинг:
+
          <p>&nbsp;&nbsp; * - отображение в любые часы и дни недели</p>
+
          <p>&nbsp;&nbsp; {} - массив, где ключ имя дня недели ["Sn","Mn","Tu","Wd","Th","Fr","Sa"]:</p>
+
          <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; {} - ‘mn’: ‘*’ - все часы понендельника</p>
+
          <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; {} - ‘mn’: [0, .., 23] - часы через запятую</p>
+
      </td>
+
      <td>необязательный параметр, * по умолчанию</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>platforms</td>
+
      <td>таргетинг по платформам:  /data.platforms</td>
+
      <td>последовательность чисел, разделенных запятой</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>browsers</td>
+
      <td>таргетинг по браузерам:  /data.browsers</td>
+
      <td>последовательность чисел, разделенных запятой</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>black_list</td>
+
      <td>черный список площадок на которых не будет показана реклама</td>
+
      <td>последовательность чисел ID площадок, разделенных запятой</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>white_list</td>
+
      <td>белый список площадок на которых не будет показана реклама</td>
+
      <td>последовательность чисел ID площадок, разделенных запятой</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>black_list_ip</td>
+
      <td>блокировка по ip</td>
+
      <td>последовательность ip адресов, разделенных запятой или массивом</td>
+
  </tr>
+
</table>
+
<b>Результат:</b><br/>
+
Возвращает массив ответов на запросы в массиве data. Соответствующий объект в выходном массиве содержит id созданной кампании, и поля error_code и error_desc в случае возникновения ошибки.
+
<p>Errors:</p>
+
<pre>  102 - unknown client
+
  103 - overlimit campaigns</pre>
+
 
+
==Редактирование рекламных кампаний==
+
Для редактирования рекламных кампаний используется метод <b>ads.campaigns.update</b><br>
+
Максимальное допустимое количество кампаний, редактируемых с помощью одного запроса — 50.<br>
+
Version log: 1.0.1 - добавлен параметр status
+
<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>data</td>
+
      <td>сериализованный JSON-массив объектов, описывающих изменения в кампаниях. Описание объектов client_mod_specification см. ниже.</td>
+
      <td>обязательный параметр, строка</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>client_specification</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>campaign_id</td>
+
      <td>id редактируемой кампании
+
      </td>
+
      <td>обязательный параметр, положительное число</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>name</td>
+
      <td>название кампании</td>
+
      <td>необязательный параметр, строка длиной от 3 до 60 символов</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>link_url</td>
+
      <td>ссылка на рекламируемый объект в формате http://yoursite.cоm</td>
+
      <td>необязательный параметр, строка</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>sex</td>
+
      <td>Пол:
+
          <p>3 - любой;</p>
+
          <p>2 - мужской;</p>
+
          <p>1 - женский</p>
+
      </td>
+
      <td>необязательный параметр, int (числовое значение)</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>age</td>
+
      <td>возраст: /data.ages</td>
+
      <td>необязательный параметр, int (числовое значение)</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>categories</td>
+
      <td>идентификаторы категорий:
+
          <p>/data.categories.get?ad_format=%</p>
+
          <p>category_id: {region_id: cost}</p>
+
      </td>
+
      <td>необязательный параметр</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>tags</td>
+
      <td>таргетинг по ключевым словам</td>
+
      <td>необязательный параметр, последовательность ключевых слов, разделенных запятой</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>day_limit</td>
+
      <td>дневной лимит в рублях. для всех типов кроме clickunder</td>
+
      <td>необязательный параметр, положительное число</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>adult_content</td>
+
      <td>присутсвие контента для взрослых в рекламной кампании:
+
          <p>0 - Нет;</p>
+
          <p>1 - Да</p>
+
      </td>
+
      <td>необязательный параметр, int (числовое значение), по умолчанию 0</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>adult_site</td>
+
      <td>отображать объявления кампании на сайтах с контентом для взрослых:
+
          <p>0 - Нет;</p>
+
          <p>1 - Да</p>
+
      </td>
+
      <td>необязательный параметр, int (числовое значение), по умолчанию 0</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>time_show</td>
+
      <td>Временной таргетинг:
+
          <p>&nbsp;&nbsp; * - отображение в любые часы и дни недели</p>
+
          <p>&nbsp;&nbsp; {} - массив, где ключ имя дня недели ["Sn","Mn","Tu","Wd","Th","Fr","Sa"]:</p>
+
          <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; {} - ‘mn’: ‘*’ - все часы понендельника</p>
+
          <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; {} - ‘mn’: [0, .., 23] - часы через запятую</p>
+
      </td>
+
      <td>необязательный параметр, * по умолчанию</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>platforms</td>
+
      <td>таргетинг по платформам:  /data.platforms</td>
+
      <td>последовательность чисел, разделенных запятой</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>browsers</td>
+
      <td>таргетинг по браузерам:  /data.browsers</td>
+
      <td>последовательность чисел, разделенных запятой</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>black_list</td>
+
      <td>черный список площадок на которых не будет показана реклама</td>
+
      <td>последовательность чисел ID площадок, разделенных запятой</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>white_list</td>
+
      <td>белый список площадок на которых не будет показана реклама</td>
+
      <td>последовательность чисел ID площадок, разделенных запятой</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>black_list_ip</td>
+
      <td>блокировка по ip</td>
+
      <td>последовательность ip адресов, разделенных запятой или массивом</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>status</td>
+
      <td>запуск/приостановка кампании:
+
          <p>0 - приостановлена;</p>
+
          <p>1 - запущена</p>
+
      </td>
+
      <td>необязательный параметр, int (числовое значение), по умолчанию 1</td>
+
  </tr>
+
</table>
+
<b>Результат:</b><br/>
+
Возвращает массив ответов на каждый запрос в массиве data. Соответствующий объект в выходном массиве содержит id изменяемого клиента и, в случае возникновения ошибки, поля error_code и error_desc.
+
<p>Errors:</p>
+
<pre>  100 - unknown campaign
+
  102 - unknown client</pre>
+
 
+
==Список кампаний рекламного кабинета==
+
Для получения списка кампаний рекламного кабинета используется метод <b>ads.campaigns.get</b>
+
 
+
<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>client_id</td>
+
      <td>Идентификатор клиента, у которого запрашиваются рекламные кампании</td>
+
      <td>int (числовое значение)</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>include_archive</td>
+
      <td>Флаг, задающий необходимость вывода архивных объявлений:
+
          <p>0 - выводить только активные кампании;</p>
+
          <p>1 - выводить все кампании</p>
+
      </td>
+
      <td>Флаг, может принимать значения 1 или 0</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>campaign_ids</td>
+
      <td>Фильтр выводимых рекламных кампаний.
+
          <p>Сериализованный JSON-массив, содержащий id кампаний. Выводиться будут только кампании, присутствующие в campaign_ids и являющиеся кампаниями указанного рекламного кабинета. Если параметр равен null, то выводиться будут все кампании.</p>
+
      </td>
+
      <td>Строка</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>limit</td>
+
      <td>ограничение на количество возвращаемых кампаний. Используется, только если параметр campaign_ids равен null</td>
+
      <td>int (числовое значение)</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>offset</td>
+
      <td>смещение. Используется в тех же случаях, что и параметр limit</td>
+
      <td>int (числовое значение)</td>
+
  </tr>
+
</table>
+
<b>Результат:</b><br/>
+
Возвращает массив объектов campaign, каждый из которых содержит следующие поля:
+
<code>
+
 
<pre>
 
<pre>
response: {
+
kadamr.event(
      count: %total%,
+
{gid:'123123',interest:'Cart'}
      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 - отображение объявлений кампании на сайтах с контентом для взрослых
+
      },..]
+
}
+
 
</pre>
 
</pre>
</code>
+
Пример ниже иллюстрирует передачу данных, при нажатии пользователем на ссылку:
<p>Errors:</p>
+
<pre>  102 - unknown client</pre>
+
 
+
==Архивирование клиентов рекламного агенства==
+
Для архивирования клиентов рекламного агенства используется метод <b>ads.campaigns.delete</b><br>
+
Максимальное допустимое количество клиентов, редактируемых с помощью одного запроса — 10.<br/>
+
 
+
<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>ids</td>
+
      <td>Список id кампаний через запятую или массив с id кампаниями.
+
          <p>Например:</p>
+
          <p>“id1, id2, …, idn“ или [id1, id2, …, idn]</p>
+
      </td>
+
      <td>обязательный параметр, строка</td>
+
  </tr>
+
</table>
+
<b>Результат:</b><br/>
+
Возвращает массив ответов на каждый запрос. Каждый ответ является либо 0, что означает успешное удаление, либо массив error.
+
<p>Errors:</p>
+
<pre>  100 - unknown campaign
+
  101 - campaign already archive
+
  102 - unknown client</pre>
+
 
+
==Получение кодов для СРА кампаний==
+
Для получения кодов по СРА кампаниям используется метод <b>ads.campaigns.cpa.mode.get</b><br/>
+
 
+
<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>
+
</table>
+
<b>Результат:</b><br/>
+
Возвращает объект с данными.
+
<code>
+
 
<pre>
 
<pre>
{
+
<a onclick="kadamr.event(
response: {
+
{gid:'123123',interest:'Cart'}
url: %url%
+
);">send retarget</a>
                  }
+
}
+
 
</pre>
 
</pre>
</code>
+
-->
  
==Получение списка категорий по заданому фильтру==
+
==Формирование списка ретаргетинга с использованием данных рекламодателя==
Для возврата списка категорий по заданому фильтру используется метод <b>ads.campaigns.categories.get</b><br/>
+
Для составления списка ретаргетинга при наличии собственной базы, рекламодатель в настройках списка ретаргетинга должен указать URL для матчинга. Более подробное описание можно найти в статье [[Создание_списка_ретаргетинга_по_матчингу#|"Создание списка ретаргетинга по матчингу"]].
 
+
==Управление ретаргетингом в кампании==
<table>
+
Для настройки ретаргетинга в рекламной кампании необходимо перейти на интерфейс "Управление кампанией" (Кампании / Кампании / Изменить).
  <tr bgcolor = #DCDCDC>
+
Под полем "Сайт для проверки" расположен чек - бокс "Выбрать аудиторию", при нажатии на который появляется поле "Аудитории" и чек - бокс "Товарный ретаргетинг". Для работы по динамическому ретаргетингу в выбранной аудитории должен быть загружен xml-фид. Также Вы не можете выбрать больше одной аудитории.
      <th width = 130 align = left>Параметры</th>
+
В поле "Аудитрии" отмечаются аудитории и списки ретаргетинга, пользователям из которых будет показана ваша реклама. При отмеченом чек - боксе "Товарный ретаргетинг" появляется дополнительное поле "Уровень заинтересованности", с возможностью выбрать соответствующий уровень заинтересованности пользователей, которым нужно показывать рекламные материалы кампании. Данный чек - бокс необходимо проставлять только в том случае, если у Вас для загрузки есть xml-фид и динамические баннера.
      <th width = 300 align = left>Значение</th>
+
[[Файл:работ_ретар_камп_18.JPG|100px|centre|frame|рис. 5]]
      <th width = 350 align = left>Дополнительные атрибуты</th>
+
Также можно задать режим использования аудиторий. Условие (И) обозначает, что пользователь должен принадлежать ко всем указанным аудиториям. Условие (ИЛИ) обозначает, что пользователь должен принадлежать, как минимум, к одной из указанных аудиторий (рис.6).
  </tr>
+
[[Файл:Rezhimretarg.png|100px|centre|frame|рис. 6]]
  <tr bgcolor = #F5F5F5>
+
Для ретаргетинговых кампаний нет возможности настроить такие таргетинги:
      <td>ad_format</td>
+
<ol>
      <td>формат объявления:
+
      <li>Таргетинг по ключевым словам</li>
            <p>ads.campaigns.foarmats.get</p>
+
      <li>Регионы и мобильные операторы</li>
      </td>
+
      <li>Категории</li>
      <td>обязательный параметр, int (числовое значение)</td>
+
      <li>Пол целевой аудитории</li>
  </tr>
+
      <li>Возраст целевой аудитории</li>
  <tr bgcolor = #F5F5F5>
+
      <li>Таргетинг по платформам</li>
      <td>category_id</td>
+
      <li>Таргетинг по браузерам</li>
      <td>id категории. ограничивает отображение только по id категории</td>
+
</ol>
      <td>необязательный параметрint (числовое значение)</td>
+
Ставка для ретаргетинговой кампании единая для всех пересечений регион-категория.
  </tr>
+
Для того, чтобы отобрать в перечне кампаний только те, в которых используется ретаргетинг, предназначен фильтр "Аудитория":
</table>
+
[[Файл:Rabotretarkam1.png|100px|centre|frame|рис. 7]]
<b>Результат:</b><br/>
+
Возвращает массив ответов на запросы в массиве response.  
+
<code>
+
<pre>
+
response: {
+
            count: %total%,
+
            items: [{
+
                      %category_id%: {
+
                            %region_id%: {
+
                        min: %min_cost%,
+
                        max: %max_cost%
+
                            }
+
                      }
+
                  },..]
+
}
+
</pre>
+
</code>
+
 
+
==Получение списка форматов объявлений==
+
Для получения списка форматов объявлений используется метод <b>ads.campaigns.formats.get</b><br/>
+
 
+
<b>Результат:</b><br/>
+
Возвращает массив ответов на запросы в массиве response.  
+
<code>
+
<pre>
+
response: {
+
      count: %total%,
+
      items: [{
+
            id: %format_id%,
+
            title: ‘%format title%’
+
      },..]
+
}
+
</pre>
+
</code>
+
 
+
==Получение списка платформ==
+
Для получения списка платформ используется метод <b>ads.targeting.platforms.get</b><br/>
+
 
+
<b>Результат:</b><br/>
+
Возвращает массив ответов на запросы в массиве response. 
+
<code>
+
<pre>
+
response: {
+
      count: %,
+
      items: [{
+
          id: %platform_id%,
+
          title: %platform_name%,
+
          mobile: %is mobile%
+
      },..]
+
}
+
</pre>
+
</code>
+
 
+
==Получение списка браузеров==
+
Для получения списка браузеров используется метод <b>ads.targeting.browsers.get</b><br/>
+
 
+
<b>Результат:</b><br/>
+
Возвращает массив ответов на запросы в массиве response.
+
<code>
+
<pre>
+
response: {
+
      count: %,
+
      items: [{
+
          id: %browser_id%,
+
          title: %browser_name%,
+
      },..]
+
}
+
</pre>
+
</code>
+

Текущая версия на 12:29, 21 октября 2019

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

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

Списки ретаргетинга

Для создания нового списка ретаргетинга в разделе "Кампании / Аудитории" необходимо нажать на кнопку "Получить код":

рис. 1

В появившейся форме необходимо заполнить следующие поля:

  • Название - название аудитории
  • Срок участия - Поле для ввода количества дней, в течение которых пользователю будет показываться ретаргетинговая реклама. От 1 до 180 дней. По умолчанию 30. Отсчет начинается с момента установки куки пользователю.
  • URL для матчинга – поле для ввода ссылки, только для рекламодателей, у которых есть уже сформированные списки ретаргетинга
  • XML-фид - укажите ссылку на товарный xml-фид. Только для динамического ретаргетинга (более подробное описание можно найти в статье Создание xml-фида для динамического ретаргетинга)
рис. 2

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

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

рис. 3

При клике по ссылке открывается всплывающее окно, содержащее код контейнера, который Вам НЕ следует устанавливать вовсе. На страницу своего сайта нужно установить код согласно шаблона предварительно поставив в него id аудитории:

<img src="//r.uuidksinc.net/match/xxxxxxx/" width="1" height="1" />
где xxxxxxx - id созданной аудитории

Посетителям страниц сайта, на которых установлен контейнер, будет установлен файл cookie на то количество дней, которое указано в настройках списка ретаргетинга. Таким образом пользователь попадет в список ретаргетинга. Показы ретаргетинговой кампании по аудитории, которая собиралась именно с использованием Kadam кода, будут начинаться сразу же после поступления хотя бы одного пользователя в аудитории. Количество пользователей аудитории с использованием Kadam кода не отображаются (будет стоять всегда "-"). Показы ретаргетинговой кампании по остальным аудиториям будут начинаться только если список ретаргетинга составляет более 50 человек. Если список менее 50 человек, статус кампании – «Ожидает аудитории».

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

Для составления списка ретаргетинга при наличии собственной базы, рекламодатель в настройках списка ретаргетинга должен указать URL для матчинга. Более подробное описание можно найти в статье "Создание списка ретаргетинга по матчингу".

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

Для настройки ретаргетинга в рекламной кампании необходимо перейти на интерфейс "Управление кампанией" (Кампании / Кампании / Изменить). Под полем "Сайт для проверки" расположен чек - бокс "Выбрать аудиторию", при нажатии на который появляется поле "Аудитории" и чек - бокс "Товарный ретаргетинг". Для работы по динамическому ретаргетингу в выбранной аудитории должен быть загружен xml-фид. Также Вы не можете выбрать больше одной аудитории. В поле "Аудитрии" отмечаются аудитории и списки ретаргетинга, пользователям из которых будет показана ваша реклама. При отмеченом чек - боксе "Товарный ретаргетинг" появляется дополнительное поле "Уровень заинтересованности", с возможностью выбрать соответствующий уровень заинтересованности пользователей, которым нужно показывать рекламные материалы кампании. Данный чек - бокс необходимо проставлять только в том случае, если у Вас для загрузки есть xml-фид и динамические баннера.

рис. 5

Также можно задать режим использования аудиторий. Условие (И) обозначает, что пользователь должен принадлежать ко всем указанным аудиториям. Условие (ИЛИ) обозначает, что пользователь должен принадлежать, как минимум, к одной из указанных аудиторий (рис.6).

рис. 6

Для ретаргетинговых кампаний нет возможности настроить такие таргетинги:

  1. Таргетинг по ключевым словам
  2. Регионы и мобильные операторы
  3. Категории
  4. Пол целевой аудитории
  5. Возраст целевой аудитории
  6. Таргетинг по платформам
  7. Таргетинг по браузерам

Ставка для ретаргетинговой кампании единая для всех пересечений регион-категория. Для того, чтобы отобрать в перечне кампаний только те, в которых используется ретаргетинг, предназначен фильтр "Аудитория":

рис. 7