modify

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

  1. Формат запроса
  2. Формат ответа
  3. Параметры ответа
  4. Другие действия с объектом

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

https://api.adfox.ru/v1/API.php
 ? loginAccount=<string>
 & loginPassword=<string>
 & object=tracingPoint
 & action=modify
 & objectID=<integer>
 & [advertiserID=<integer>]
 & [name=<string>]
 & [categoryID=<integer>]
 & [templateTypeID=<integer>]
 & [referrer=<string>]
 & [weight=<integer>]
 & [userID=<integer>]
Query-параметры
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

Статус обработки запроса. Расшифровку смотрите в разделе Обработка ошибок.

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

Запрос:

https://api.adfox.ru/v1/API.php?loginAccount={your_login}&loginPassword={sha256_your_password}&object=tracingPoint&action=modify&objectID=3&name=topline_click&weight=100

Ответ:

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

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

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