Статус рекламної кампанії

campaign/status

Параметри:

• token — авторизація (string)
• id — ідентифікатор рекламної кампанії (int )
  ids — список ідентифікаторів рекламних кампаній, розділених комою (string , наприклад: "100001, 100002, 10003")
  Можна вказати ідентифікатор рекламної кампанії (id) АБО список ідентифікаторів рекламних кампаній (ids). Якщо не передати жодного з цих параметрів, буде виведено весь список рекламних кампаній.
• status — статус рекламної кампанії (string, за замовчуванням: усі рекламні кампанії). Значення:
  • rejected — заблокована модератором
  • moderating — очікує на модерацію
  • stopped — кампанія зупинена
  • active — кампанія активна
  • inactive — кампанія неактивна (у неї немає показів на рахунку)
• currency — валюта (рядок, за замовчуванням: валюта облікового запису). Значення:
  • rub
  • usd
• language — мова опису рекламних кампаній (рядок, за замовчуванням: мова облікового запису). Значення:
  • 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 — кампанія неактивна (у неї немає показів на рахунку).