|
|
Строка 24: |
Строка 24: |
| </pre> | | </pre> |
| </code> | | </code> |
− | В УРЛе обязательно должны присутствовать макросы [UID] и [URL].<br> | + | В URL обязательно должны присутствовать макросы [UID] и [URL].<br> |
| При показе любых материалов системы на любых площадках, мы вызываем указанный URL. В макросе [UID] мы передаем данные о куки, установленной нашей системой. В макросе [URL] мы передаем УРЛ, который рекламодатель должен вызвать в том случае, если пользователь ему интересен.<br> | | При показе любых материалов системы на любых площадках, мы вызываем указанный URL. В макросе [UID] мы передаем данные о куки, установленной нашей системой. В макросе [URL] мы передаем УРЛ, который рекламодатель должен вызвать в том случае, если пользователь ему интересен.<br> |
| При вызове нашего URL в макросе ${UID} рекламодатель должен передать свои куки данного пользователя. | | При вызове нашего URL в макросе ${UID} рекламодатель должен передать свои куки данного пользователя. |
| Если рекламодатель вызывает наш URL – пользователь попадает в список ретаргетинга. | | Если рекламодатель вызывает наш URL – пользователь попадает в список ретаргетинга. |
− |
| |
− | ==Статистика по всем материалам кампании==
| |
− | Для получения статистики по всем материалам кампании используется метод <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> * - отображение в любые часы и дни недели</p>
| |
− | <p> {} - массив, где ключ имя дня недели ["Sn","Mn","Tu","Wd","Th","Fr","Sa"]:</p>
| |
− | <p> {} - ‘mn’: ‘*’ - все часы понендельника</p>
| |
− | <p> {} - ‘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> * - отображение в любые часы и дни недели</p>
| |
− | <p> {} - массив, где ключ имя дня недели ["Sn","Mn","Tu","Wd","Th","Fr","Sa"]:</p>
| |
− | <p> {} - ‘mn’: ‘*’ - все часы понендельника</p>
| |
− | <p> {} - ‘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>
| |
− | 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 - отображение объявлений кампании на сайтах с контентом для взрослых
| |
− | },..]
| |
− | }
| |
− | </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>
| |
− | {
| |
− | response: {
| |
− | url: %url%
| |
− | }
| |
− | }
| |
− | </pre>
| |
− | </code>
| |
− |
| |
− | ==Получение списка категорий по заданому фильтру==
| |
− | Для возврата списка категорий по заданому фильтру используется метод <b>ads.campaigns.categories.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>ad_format</td>
| |
− | <td>формат объявления:
| |
− | <p>ads.campaigns.foarmats.get</p>
| |
− | </td>
| |
− | <td>обязательный параметр, int (числовое значение)</td>
| |
− | </tr>
| |
− | <tr bgcolor = #F5F5F5>
| |
− | <td>category_id</td>
| |
− | <td>id категории. ограничивает отображение только по id категории</td>
| |
− | <td>необязательный параметр, int (числовое значение)</td>
| |
− | </tr>
| |
− | </table>
| |
− | <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>
| |
Ретаргетинг – это маркетинговая технология, которая позволяет показывать ваши рекламные объявления именно тем пользователям, которые ранее уже посещали ваш сайт, но не совершили целевого действия. Особенность и основное отличие ретаргетинга от другой рекламы в том, что вы показываете рекламу только той аудитории, которая интересовалась вашими товарами или услугами и тратите бюджет только на целевую аудиторию. Данный инструмент можно использовать для того, чтобы подтолкнуть к совершению покупки или, например, для уведомления о скидках, акциях, специальных предложениях и т.д. Это может быть реклама тех же товаров (услуг), которые пользователь уже просматривал на вашем сайте, похожих сопутствующих товаров или другие ваши предложения.
Таргетинг целевой аудитории - инструмент позволяющий настраивать ваши рекламные кампании под конкретно интересующую аудиторию пользователей. Данный функционал позволяет формировать аудиторию по ключевым словам, страницам или доменам, которыми ранее интересовались пользователи.
Создание и настройка целевой аудитории происходит в разделе "Кампания / Аудитория", при нажатии на кнопку "Создать аудиторию". Более подробное описание создания кампании можно найти в статье "Настройки аудитории" [1].
Если у рекламодателя есть собственный список пользователей, которым он хочет показывать ретаргетинговую кампанию, то он должен указать URL матчинга. Для этого необходимо в подразделе "Аудитории" нажать на кнопку "Получить код":
В URL обязательно должны присутствовать макросы [UID] и [URL].
При показе любых материалов системы на любых площадках, мы вызываем указанный URL. В макросе [UID] мы передаем данные о куки, установленной нашей системой. В макросе [URL] мы передаем УРЛ, который рекламодатель должен вызвать в том случае, если пользователь ему интересен.
При вызове нашего URL в макросе ${UID} рекламодатель должен передать свои куки данного пользователя.
Если рекламодатель вызывает наш URL – пользователь попадает в список ретаргетинга.