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

campaña/estado

Parámetros:

• token: autorización (cadena de caracteres)
• id : identificador de la campaña publicitaria (entero )
  ids : lista de identificadores de campañas publicitarias separados por comas (cadena de caracteres , por ejemplo: «100001, 100002, 10003»)
  Se puede especificar el identificador de la campaña publicitaria (id) O bien una lista de identificadores de campañas publicitarias (ids). Si no se pasa ninguno de estos parámetros, se mostrará la lista completa de campañas publicitarias.
• status: estado de la campaña publicitaria (cadena de caracteres; por defecto: todas las campañas publicitarias). Valores:
  • rejected: bloqueada por el moderador
  • moderating: pendiente de moderación
  • stopped: campaña detenida
  • active: la campaña está activa
  • inactive: la campaña está inactiva (no tiene impresiones registradas)
• currency: moneda (cadena de caracteres; por defecto: la moneda de la cuenta). Valores:
  • rub
  • usd
• language: idioma de descripción de las campañas publicitarias (cadena de caracteres; por defecto: el idioma de la cuenta). Valores:
  • ru - ruso
  • en - inglés
  • es - español
  • pt - portugués

Límite en el número de campañas publicitarias: 1000 unidades. Para obtener la lista completa de campañas publicitarias, se utiliza el parámetro:

• pagination_skip: desplazamiento, número de campañas publicitarias omitidas (int)

Ejemplo de llamada al método:

<?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
}

Valores posibles del campo «status»:

• rejected: bloqueada por el moderador.
• moderating: pendiente de moderación.
• stopped: campaña detenida.
• active: la campaña está activa.
• inactive: la campaña está inactiva (no tiene impresiones registradas).