modify

Редактировать параметры точки учета действия.

Формат запроса

https://adfox.yandex.ru/api/v1
  ? object=tracingPoint
  & action=modify
  & objectID=<integer>
  & [advertiserID=<integer>]
  & [name=<string>]
  & [categoryID=<integer>]
  & [templateTypeID=<integer>]
  & [referrer=<string>]
  & [weight=<integer>]
  & [userID=<integer>]

objectID*

ID объекта, над которым производится действие.

advertiserID

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

Примечание

Ошибка «Duplicate entry for key «advertiser_id_user_id»» означает, что у рекламодателя уже существует точка с данным Идентификатором (поле «Идентификатор», не путать с «ID»).

name

Название объекта. Может содержать русские и латинские буквы, цифры и любые символы.

categoryID

ID временной категории.

Читайте также:

templateTypeID

ID типа шаблона. Подробнее о типах шаблонов читайте в статье Шаблоны referer.

Допустимые значения:

  • 0 — стандартный;
  • 1 — POSIX.2.

Значение по умолчанию: 0.

referrer

Шаблон URL для сравнения с адресом страницы сайта, полученным из запроса. Если адрес не подходит под шаблон URL, загрузка точки не будет засчитана.

Пример записи:

  • для стандартного типа шаблонов:

    ⃰site.ru/index.php
    
  • Для POSIX.2:

    homer-simpson-tv\.blog4ever\.com|forum\.rojadirecta\.org|
    ^hidan\.eklablog\.com.٭|^aniworld\.spb\.ru\/.٭\/adfox\/.
    ٭s$
    

Может содержать русские и латинские буквы, цифры и любые символы.

weight

Вес точки учета действия. Используется для построения отчетов. Так, например, для посадочной страницы после клика по баннеру вес будет меньше, а для страницы оформления заказа — больше, так как целью рекламной кампании являлось увеличение продаж.

Допустимые значения:

  • 0≤N≤100, где N — вес точки учета, позволяющий определить степень ее важности для достижения рекламных целей.

userID

Пользовательский идентификатор точки учета действия.

* Обязательный параметр

Формат ответа

<response>
<status>
  <code>{integer}</code>
</status>
</response>

Параметры ответа

code

Статус обработки запроса. Значение 0 — запрос выполнен успешно. Расшифровку смотрите в разделе Обработка ошибок.

Пример запроса и ответа

Запрос:

https://adfox.yandex.ru/api/v1?object=tracingPoint&action=modify&objectID=3&name=topline_click&weight=100

Ответ:

<response>
<status>
  <code>0</code>
</status>
</response>

Другие действия с объектом

Читайте также о других действиях с объектом tracingPoint:

Предыдущая
Следующая