Statut de la campagne publicitaire

campagne/statut

Paramètres :

• token - autorisation (chaîne de caractères)
• id - identifiant de la campagne publicitaire (entier )
  ids - liste d'identifiants de campagnes publicitaires séparés par des virgules (chaîne de caractères , par exemple : « 100001, 100002, 10003 »)
  Vous pouvez indiquer l'identifiant d'une campagne publicitaire (id) OU une liste d'identifiants de campagnes publicitaires (ids). Si aucun de ces paramètres n'est fourni, la liste complète des campagnes publicitaires sera affichée.
• status - statut de la campagne publicitaire (chaîne de caractères, par défaut : toutes les campagnes publicitaires). Valeurs :
  • rejected - bloquée par le modérateur
  • moderating - en attente de modération
  • stopped - campagne suspendue
  • active : la campagne est active
  • inactive - campagne inactive (aucune impression enregistrée sur le compte)
• currency - devise (chaîne de caractères, par défaut : devise du compte). Valeurs :
  • rub
  • usd
• language - langue de description des campagnes publicitaires (chaîne de caractères, par défaut : langue du compte). Valeurs :
  • ru - russe
  • en - anglais
  • es - espagnol
  • pt - portugais

Limite du nombre de campagnes publicitaires : 1 000. Pour obtenir la liste complète des campagnes publicitaires, utilisez le paramètre :

• pagination_skip - décalage, nombre de campagnes publicitaires ignorées (entier)

Exemple d'appel de la méthode :

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

Valeurs possibles du champ « status » :

• rejected - bloquée par le modérateur.
• moderating - en attente de modération.
• stopped - campagne suspendue.
• active : la campagne est active.
• inactive - la campagne est inactive (elle n'a encore généré aucune impression).