Изменения в работе с аудит-пикселями

Изменился порядок работы с аудит пикселями через АПИ.

Появилось понятие Тип пикселя. На текущий момент существуют следующие типы, позволяющие отследить события:

  • impression – Показ объявления (Impression)
  • playbackStarted – Воспроизведение видео (Start video)
  • playheadReachedValue25 – Просмотрено 25% видео (Reached 25% of video)
  • playheadReachedValue50 – Просмотрено 50% видео (Reached 50% of video)
  • playheadReachedValue75 – Просмотрено 75% видео (Reached 75% of video)
  • playheadReachedValue100 – Просмотрено 100% видео (Reached 100% of video)
  • closedByUser – Реклама закрыта пользователем (Closed by user)

Для добавления пикселя в объявление, необходимо задать необходимые пиксели в словаре audit_pixels при создании кампании. В словаре указывается тип, и соответствующие ему адреса пикселей. Проверить корректность конкретного адреса пикселя можно с помощью запроса https://target.my.com/doc/api/detailed/#resource_audit_pixel

Для одной кампании можно задать совокупно не более 10 пикселей любых доступных типов. 

Примерный вид секции audit_pixel в объекте campaign:

"audit_pixels":
{
    "impression": [
        "//ad.server.com/i/img;p=110872134334098;idfa=;idfa_lat=;aaid=;aaid_lat=;cache=",
        "//ad. server.com/i/img;p=110872153493098;idfa=;idfa_lat=;aaid=;aaid_lat=;cache=",
    ],
    "last_view": [
        "//ad. server.com/i/img;p=110872061af9135;idfa=;idfa_lat=;aaid=;aaid_lat=;cache=",
        "//ad. server.com/i/img;p=110872061931513;idfa=;idfa_lat=;aaid=;aaid_lat=;cache="
    ],
    "100view": [
        "//ad.atdmt1111.com/i/img;p=11087206181934;idfa=;idfa_lat=;aaid=;aaid_lat=;cache=",
        "//ad.atdmt3333.com/i/img;p=11087206119347;idfa=;idfa_lat=;aaid=;aaid_lat=;cache="
    ]
}

Доступные для пакета пиксели описаны в секциях options.settings и features.settings объекта пакета, возвращаемом при запросе к packages.json:

{
          "name": "audit_pixels",
          "types": [
            {
              "id": "impression",
              "description": "Impression"
            },
            {
              "id": "playbackStarted",
              "description": "Startvideo"
            },
            {
              "id": "playheadReachedValue25",
              "description": "Reached25%ofvideo"
            },
            {
              "id": "playheadReachedValue50",
              "description": "Reached50%ofvideo"
            },
            {
              "id": "playheadReachedValue75",
              "description": "Reached75%ofvideo"
            },
            {
              "id": "playheadReachedValue100",
              "description": "Reached100%ofvideo"
            }
          ]
        }

В настоящее время установка пикселей доступна для следующих пакетов:

пакет

пиксели

164, 169, 196, 197, 220, 237

impression, playbackStarted, playheadReachedValue25, playheadReachedValue50, playheadReachedValue75, playheadReachedValue100

235

impression, playbackStarted, playheadReachedValue25, playheadReachedValue50, playheadReachedValue75, playheadReachedValue100, closedByUser

120 121 122 123 188 191 194 200 210 211 223 224 226 227 228 229 233 236 237 238 239 242

impression

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

Права на использование аудит-пикселей выдаются по запросу в службу поддержки support_target@corp.my.com.