Ремаркетинг по показам и кликам

Появилась возможность настраивать ремаркетинг на показы и клики для ваших компаний. Как это работает.

Установку можно делать также и с помощью API myTarget. 

Запрос кампаний для использования

Запросить все кампании, данные которых можно использовать в ремаркетинге можно с помощью запроса:

GET /api/v2/remarketing/campaigns.json

Ответ:

{
    items: [
        {
            "id": 1223567,
            "created": "2016-06-21 22:15:28",
            "name": "Новая кампания 20-12-2016",
        },
        {
            "id": 1223222,
            "created": "2016-06-21 22:15:30",
            "name": "Новая кампания 30-12-2016",
        }
    ],
    count: 2
}

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

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

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

Создание нового списка кампаний:

POST /api/v2/remarketing/campaign_lists.json

{
    "name": "Группа кампаний по показам",
    "campaigns_ids": [1223567]
 }

Ответ содержит только идентификатор вновь созданной группы:

{
  "id": 549
}

Изменение существующего списка кампаний:

POST /api/v2/remarketing/campaign_lists/<campaign_lists_id>.json

{
    "name": "Новое название группы",
    "campaigns_ids": [1223567,1223568]
}

Можно передавать только свойство к изменению. В campaign_ids указывается полный список идентификаторов кампаний, а не только новые для добавления. При удачном изменении будет возвращен статус 204 No content. 

Посмотреть текущие списки:

GET /api/v2/remarketing/campaign_lists.json

Ответ

{
    items: [
        {
            "id": 1223567,
            "created": "2016-06-21 22:15:28",
            "name": "Список кампаний по кликам",
            "campaigns_ids": [1223567]
        },
        {
            "id": 1223222,
            "created": "2016-06-21 22:15:28",
            "name": "Список кампаний по показам",
            "campaigns_ids": [1223222]
        }
    ],
    count: 2
}

Удалить список 

DELETE /api/v2/remarketing/campaign_lists/<campaign_lists_id>.json

Создание аудитории

В API /api/v1/remarketings.json объект disjunctions теперь принимает в том числе таргетинг remarketing_campaign_lists:

{ ...
   "remarketing_campaign_lists": [
   {
      "campaign_list_id": 42,
      "type": <"positive"|"negative">,
      "source": <"clicks"|"shows">,
      "max_count": 4
   },
   ...
],
... }

  • campaign_list_id - идентификатор списка кампаний 
  • type - positive (учитывать пользователей, которые видели, кликали рекламу) | negative (пользователь не видел/кликал рекламу)
  • source - clicks (учитывать пользователей, которые делали клик по баннеру кампаний) | shows (учитывать пользователей, которые видели баннер кампаний)
  • max_count - количество кликов.показов. 

max_count

Поле max_count не доступно пользователям в интерфейсе. Вместо этого работает логика:

  • Если пользователь выбирает "Достигнута ли цель? --> Да", то мы устанавливаем "max_count": 0 и тип "type": "negative"
  • Если пользователь выбирает "Достигнута ли цель? --> Нет", то мы устанавливаем "max_count": 0 и тип "type": "positive"

Для типа positive будут выбраны только те пользователи, которые совершали действие (просмотр/клик) менее или равное max_count раз. К примеру, max_count==0. Выбираем всех кто сделал менее или 0 действий (т.е. тех, кто не кликал\не видел рекаму). Max_count==5 - выбираем тех, кто сделал 5 действий или менее действий. Т.е. выбираются пользователи в рамках max_count.

Для типа negative будут выбраны пользователи, которые совершали действие (просмотр/клик) более max_count раз. К примеру, max_count==0. Выбираем всех кто сделал более 0 действий. Max_count==5 - выбираем тех, кто сделал более 5 действий. Т.е. выбираются пользователи, превысившие граничное max_count. 

К примеру, max_count==0. Выбираем всех кто сделал более 0 действий. Max_count==5 - выбираем тех, кто сделал более 5 действий. 

Если positive, то выбираются все пользователи, которые сделали менее или равно max_count действий. К примеру, max_count==0. Выбираем всех кто сделал менее или 0 действий (т.е. тех, кто не кликал\не видел рекаму). Max_count==5 - выбираем тех, кто сделал 5 действий или менее действий. 

Обратите внимание, что в случае сохранения кампании в интерфейсе myTarget, max_count будет выставлен в 0.