广告活动的状态

读 4 分钟

campaign/status

参数:

  • token - 授权凭证 (字符串)
  • id - 广告活动标识符 (int )
    ids - 以逗号分隔的广告活动标识符列表 (string ,例如:"100001, 100002, 10003")
  • status - 广告活动的状态(字符串,默认:所有广告活动)。取值:
    • rejected - 被审核员屏蔽
    • moderating - 待审核
    • stopped - 广告系列已停止
    • active - 广告系列处于活动状态
    • inactive - 广告系列处于非活动状态(账户中尚无展示记录)
  • currency - 货币(字符串,默认值:账户货币)。取值:
    • rub
    • usd
  • language - 广告活动描述语言(字符串,默认:账户语言)。取值:
    • ru - 俄语
    • en - 英语
    • es - 西班牙语
    • pt - 葡萄牙语

广告系列数量上限:1000个。若要获取完整的广告系列列表,请使用以下参数:

  • pagination_skip - 偏移量,跳过的广告活动数量(整数

方法调用示例:

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

Rate the material:

Rating: 0 out of 5. Total ratings: 0.
Last modified

I don't understand anything! Help :-(