Información sobre la CP

campaign/info

Parámetros:

• token - autorización (string)
• id - identificador de la CP (int)
  category_id - identificador de categoría (int)
  parent - identificación de la campaña publicitaria de los padres (int)
  Es necesario especificar el identificador de la CP (id) O el identificador de categoría (category_id) O el identificación de la campaña publicitaria de los padres (parent). Si no pasa ninguno de estos parámetros, se mostrará toda la lista de las CP.
• currency - divisa (string, por defecto: moneda de la cuenta). Valores:
  • rub
  • usd
• language - lenguaje de descripción de campañas publicitarias (string, por defecto: idioma de la cuenta). Valores:
  • ru - Ruso
  • en - Inglés
  • es - Español
  • pt - Portugués
• filter - filtro de lista de campañas publicitarias (string, valor predeterminado: none). Valores:
  • active - campañas publicitarias en ejecución
  • activity_hour - actividad de la hora actual (actualizada a medianoche de cada hora)
  • activity_day - actividad del día actual (actualizada a las 00:00 h según la zona horaria de la cuenta)
  • activity_month - actividad del día actual (actualizada a las 00:00 h del primer día de cada mes según la zona horaria de la cuenta)
  • balance - con un saldo positivo de campañas publicitarias

Límite en el número de campañas publicitarias: 1000 uds. Para obtener una lista completa de campañas publicitarias, utilice el parámetro:

• pagination_skip - compensación, número de campañas publicitarias perdidas (int)

Ejemplo de llamada a un 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/info');
        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);
    }

// Resultado:

{
    "id": "999999",
    "type": "paid_se",
    "type_name": "actionas del buscador",
    "date_begin": "14.06.2019 13:56",
    "campaign": "mysite.com (https://google.ru: frase clave)",
    "one_action_cost": "0.786",
    "one_action_currency": "₽",
    "one_action_currency_iso": "RUB",
    "balance_actions": "2996",
    "actions_hour": "0",
    "actions_hour_limit": "1",
    "actions_today": "1",
    "actions_today_limit": "0",
    "actions_under_moderation": "0",
    "comments": "",
    "status": "active",
    "category_id": "9999",
    "category_name": "mysite.com",
    "error_code": 0
}

====================================================================================

<?php
    $post = array(
        'token' => $token,
        'id' => 999999
    );
    if ($curl = curl_init()) {
        curl_setopt($curl, CURLOPT_URL, 'https://www.ipweb.ru/api/v2/campaign/info');
        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);
    }

// Resultado:

{
    "id": "999999",
    "type": "paid_se",
    "type_name": "actions from the search engine",
    "date_begin": "14.06.2019 13:56",
    "campaign": "mysite.com (https://google.ru: keyword)",
    "one_action_cost": "0.786",
    "one_action_currency": "₽",
    "balance_actions": "2996",
    "actions_hour": "0",
    "actions_hour_limit": "1",
    "actions_today": "1",
    "actions_today_limit": "0",
    "actions_under_moderation": "0",
    "comments": "",
    "status": "active",
    "category_id": "9999",
    "category_name": "mysite.com",
    "children": [
        {
            "id": 888888,
            "url": "mysite.com",
            "actions": "1000",
            "period": "day",
            "spreading": "normal",
            "rejection": 0,
            "outer_clicks": 0,
            "actions_hour": 0,
            "actions_hour_limit": 42,
            "actions_today": 0,
            "actions_today_limit": 1000,
            "actions_month": 0,
            "actions_all": 0,
            "actions_under_moderation": "0",
            "status": "moderating"
        },
        {
            "id": 777777,
            "url": "mysite.com",
            "actions": "1000",
            "period": "day",
            "spreading": "normal",
            "rejection": 0,
            "outer_clicks": 0,
            "actions_hour": 0,
            "actions_hour_limit": 42,
            "actions_today": 0,
            "actions_today_limit": 1000,
            "actions_month": 0,
            "actions_all": 0,
            "actions_under_moderation": "0",
            "status": "moderating"
        }
    ],
    "error_code": 0
}

====================================================================================

<?php
    $post = array(
        'token' => $token,
        'category_id' => 9999
    );
    if ($curl = curl_init()) {
        curl_setopt($curl, CURLOPT_URL, 'https://www.ipweb.ru/api/v2/campaign/info');
        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);
    }

// Resultado:

{
    "campaigns": [
        {
            "id": "999999",
            "type": "paid_se",
            "type_name": "actionas del buscador",
            "date_begin": "14.06.2019 11:27",
            "campaign": "mysite.com (https://google.ru: frase clave 1)",
            "one_action_cost": "0.786",
            "one_action_currency": "₽",
            "balance_actions": "0",
            "actions_hour": "0",
            "actions_hour_limit": "1",
            "actions_today": "0",
            "actions_today_limit": "0",
            "actions_under_moderation": "0",
            "comments": "тест",
            "status": "stopped",
            "category_id": "9999",
            "category_name": "mysite.com"
        },
        {
            "id": "999998",
            "type": "paid_se",
            "type_name": "actionas del buscador",
            "date_begin": "14.06.2019 13:56",
            "campaign": "mysite.com (https://google.ru: frase clave 2)",
            "one_action_cost": "0.786",
            "one_action_currency": "₽",
            "balance_actions": "992",
            "actions_hour": "0",
            "actions_hour_limit": "1",
            "actions_today": "0",
            "actions_today_limit": "1",
            "actions_under_moderation": "0",
            "comments": "",
            "status": "active",
            "category_id": "9999",
            "category_name": "mysite.com"
        }
    ],
    "error_code": 0
}

Valores posibles del campo "Status":

• rejected - bloqueado por el moderador (entonces la respuesta contiene también el campo con la causa 'reject_reason').
• moderating - espera moderación.
• stopped - campaña se detuvo.
• active - campaña activa.
• inactive - campaña inactiva (no tiene presentaciones en la cuenta).