Статус рекламной кампании
campaign/status
Параметры:
- token - авторизация (string)
- id - идентификатор рекламной кампании (int)
ids - список идентификаторов рекламных кампаний, разделенных запятой (string, например: "100001, 100002, 10003")Можно указать идентификатор рекламной кампании (id) ИЛИ список идентификаторов рекламных кампаний (ids). Если не передать ни одного из этих параметров, будет выведен весь список рекламных кампаний. - status - статус рекламной кампании (string, по умолчанию: все рекламные кампании). Значения:
- rejected - заблокирована модератором
- moderating - ожидает модерацию
- stopped - кампания остановлена
- active - кампания активна
- inactive - кампания неактивна (у нее нет показов на счету)
- currency - валюта (string, по умолчанию: валюта учётной записи). Значения:
- rub
- usd
- language - язык описания рекламных кампаний (string, по умолчанию: язык учётной записи). Значения:
- ru - русский
- en - английский
- es - испанский
- pt - португальский
Лимит по количеству рекламных кампаний: 1000 шт. Что бы получить полный список рекламных кампаний, используется параметр:
- pagination_skip - смещение, количество пропущенных рекламных кампаний (int)
Пример вызова метода:
<?php
$post = array(
'token' => $token,
'id' => 999999
);
if ($curl = curl_init()) {
curl_setopt($curl, CURLOPT_URL, 'https://www.ipweb.ru/api/v2/campaign/status');
curl_setopt($curl, CURLOPT_RETURNTRANSFER,true);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $post);
$out = curl_exec($curl);
echo $out;
curl_close($curl);
}
// Результат:
{
"id": 999999,
"balance_actions": 2,
"actions_hour": 0,
"actions_today": 0,
"actions_month": 0,
"actions_all": 12,
"status": "stopped",
"one_action_cost": 0.786,
"one_action_currency": "₽",
"one_action_currency_iso": "RUB"
}
====================================================================================
<?php
$post = array(
'token' => $token
);
if ($curl = curl_init()) {
curl_setopt($curl, CURLOPT_URL, 'https://www.ipweb.ru/api/v2/campaign/status');
curl_setopt($curl, CURLOPT_RETURNTRANSFER,true);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $post);
$out = curl_exec($curl);
echo $out;
curl_close($curl);
}
// Результат:
{
"campaigns": [
{
"id": 999999,
"balance_actions": 2,
"actions_hour": 0,
"actions_today": 0,
"actions_month": 0,
"actions_all": 12,
"status": "stopped",
"one_action_cost": 0.786,
"one_action_currency": "₽",
"one_action_currency_iso": "RUB"
},
{
"id": 999999,
"balance_actions": 2,
"actions_hour": 0,
"actions_today": 0,
"actions_month": 0,
"actions_all": 12,
"status": "stopped",
"one_action_cost": 0.786,
"one_action_currency": "₽",
"one_action_currency_iso": "RUB"
}
],
"error_code": 0
}
Возможные значения поля «status»:
- rejected - заблокирована модератором.
- moderating - ожидает модерацию.
- stopped - кампания остановлена.
- active - кампания активна.
- inactive - кампания неактивна (у нее нет показов на счету).