superCampaign
Получить список суперкампаний.
Формат запроса
Примечание
Доступна пагинация.
https://adfox.yandex.ru/api/v1
? object=account
& action=list
& actionObject=superCampaign
& [actionObjectID=<integer>]
& [dateAddedFrom=<YYYY-MM-DD>]
& [dateAddedTo=<YYYY-MM-DD>]
& [show=<string>]
& [search=<string>]
|
Чтобы получить данные только по одной суперкампании, укажите ее идентификатор. Значение по умолчанию: 0 — выводить список всех суперкампаний. |
|
Фильтрация данных: вывести суперкампании, созданные после указанной даты. |
|
Фильтрация данных: вывести суперкампании, созданные до указанной даты. |
|
Настройка вывода данных. Допустимые значения:
Значение по умолчанию: |
|
Фильтрация по подстроке в имени суперкампании. Может содержать русские и латинские буквы, цифры и любые символы. |
* Обязательный параметр
Формат ответа
<response>
<status>
<code>{integer}</code>
</status>
<result>
<data>
<row0>
<ID>{integer}</ID>
<name>{string}</name>
<advertiserID>{integer}</advertiserID>
<advertiserAccount>{string}</advertiserAccount>
<assistantID>{integer}</assistantID>
<assistantAccount>{string}</assistantAccount>
<additionalAdvertiserIDs/>
<additionalAdvertiserAccounts/>
<additionalAssistantIDs/>
<additionalAssistantAccounts/>
<logicType>{integer}</logicType>
<type>{integer}</type>
<status>{integer}</status>
<impressionsMethodID>{integer}</impressionsMethodID>
<maxImpressions>{integer}</maxImpressions>
<maxImpressionsPerDay>{integer}</maxImpressionsPerDay>
<maxImpressionsPerHour>{integer}</maxImpressionsPerHour>
<maxClicks>{integer}</maxClicks>
<maxClicksPerDay>{integer}</maxClicksPerDay>
<maxClicksPerHour>{integer}</maxClicksPerHour>
<maxUniqueImpressions>{integer}</maxUniqueImpressions>
<frequencyTypeImpressions>{integer}</frequencyTypeImpressions>
<uniquePeriodImpressions>{string}</uniquePeriodImpressions>
<impressionsPerPeriod>{integer}</impressionsPerPeriod>
<minimalPeriodImpressions>0:00</minimalPeriodImpressions>
<dateStart>{date}</dateStart>
<dateEnd>{date}</dateEnd>
<dateFinished>{date}</dateFinished>
<dateAdded>{date}</dateAdded>
<sendToErir>{integer}</sendToErir>
<contractID>{integer}</contractID>
<publisherContractID>{integer}</publisherContractID>
<costType>{integer}</costType>
</row0>
</data>
</response>
Параметры ответа
|
Статус обработки запроса. Значение |
|
Элемент списка с соответствующим номером. |
|
Название суперкампании. |
|
ID рекламодателя. |
|
Учетная запись рекламодателя. |
|
ID ассистента, которому приписана суперкампания. |
|
Учетная запись ассистента, которому приписана суперкампания. |
|
ID дополнительных рекламодателей. |
|
Учетные записи дополнительных рекламодателей. |
|
ID дополнительных ассистентов. |
|
Учетные записи дополнительных ассистентов. |
|
Тип кампании. Возможные значения:
|
|
Статус. |
|
Методика подсчета показов. Возможные значения:
|
|
Ограничение показов всего. |
|
Ограничение показов в сутки. |
|
Ограничение показов в час. |
|
Ограничение кликов всего. |
|
Ограничение кликов в сутки. |
|
Ограничение кликов в час. |
|
Максимальное количество показов посетителю. |
|
Период частоты показов. |
|
Если период частоты показов выбран как «другой период» ( |
|
Количество показов за период. |
|
Минимальный период между показами. |
|
Дата начала суперкампании. |
|
Дата окончания суперкампании. |
|
Дата завершения открутки. |
|
Дата добавления суперкампании. |
|
Передавать данные в ЕРИР. Возможные значения:
|
|
Идентификатор прямого или первичного договора. |
|
Идентификатор конечного договора. |
|
Тип кампании. Возможные значения:
|
Пример запроса и ответа
Запрос:
https://adfox.yandex.ru/api/v1?object=account&action=list&actionObject=superCampaign
Ответ:
<response> <status> <code>0</code> </status> <result> <data> <row0> <ID>29038</ID> <name>example</name> <advertiserID>226201</advertiserID> <advertiserAccount>petrov</advertiserAccount> <assistantID>221327</assistantID> <assistantAccount>ivanov</assistantAccount> <additionalAdvertiserIDs/> <additionalAdvertiserAccounts/> <additionalAssistantIDs/> <additionalAssistantAccounts/> <logicType>0</logicType> <type>0</type> <status>2</status> <impressionsMethodID>0</impressionsMethodID> <maxImpressions>0</maxImpressions> <maxImpressionsPerDay>0</maxImpressionsPerDay> <maxImpressionsPerHour>0</maxImpressionsPerHour> <maxClicks>0</maxClicks> <maxClicksPerDay>0</maxClicksPerDay> <maxClicksPerHour>0</maxClicksPerHour> <maxUniqueImpressions>0</maxUniqueImpressions> <frequencyTypeImpressions>6</frequencyTypeImpressions> <uniquePeriodImpressions>0:00</uniquePeriodImpressions> <impressionsPerPeriod>1</impressionsPerPeriod> <minimalPeriodImpressions>0:00</minimalPeriodImpressions> <dateStart>2021-07-02 00:00:00</dateStart> <dateEnd>2022-03-31 23:59:00</dateEnd> <dateFinished>2022-04-01 00:30:01</dateFinished> <dateAdded>2021-07-02</dateAdded> <sendToErir>1</sendToErir> <contractID>167</contractID> <publisherContractID>123</publisherContractID> <costType>2</costType> </row0> </data> </response>
Другие действия с объектом
Читайте также о других действиях с объектом superCampaign
:
- добавить суперкампанию;
- удалить суперкампанию;
- редактировать суперкампанию;
- добавить дополнительного ассистента;
- добавить дополнительного рекламодателя;
- удалить дополнительного ассистента;
- удалить дополнительного рекламодателя.
Чтобы получить данные только по одной суперкампании, укажите ее идентификатор.
Значение по умолчанию: 0 — выводить список всех суперкампаний.
Фильтрация данных: вывести суперкампании, созданные после указанной даты.
Фильтрация данных: вывести суперкампании, созданные до указанной даты.
Настройка вывода данных.
Допустимые значения:
-
common
— краткий вывод:- ID;
- name.
-
short
— сокращенный вывод:- ID;
- name;
- status;
- dateStart;
- dateEnd;
- dateFinished.
-
advanced
— полный вывод.
Значение по умолчанию: advanced
.
Фильтрация по подстроке в имени суперкампании.
Может содержать русские и латинские буквы, цифры и любые символы.
Обязательный параметр