Статус рекламной кампании

Читать 5 минут

campaign/status

Параметры:

  • token - авторизация (string)
  • id - идентификатор рекламной кампании (int)
    ids - список идентификаторов рекламных кампаний, разделенных запятой (string, например: "100001, 100002, 10003")
  • 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 - кампания неактивна (у нее нет показов на счету).
IPweb

Оцените материал:

Рейтинг: 0 из 5. Всего оценок: 0.
Последнее изменение

Нужна помощь? Пишите!
-