广告活动的状态
读 4 分钟
campaign/status
参数:
- token - 授权凭证 (字符串)
- id - 广告活动标识符 (int )
ids - 以逗号分隔的广告活动标识符列表 (string ,例如:"100001, 100002, 10003")可以指定广告活动标识符(id)或广告活动标识符列表(ids)。如果未传递上述任何参数,则将显示所有广告活动列表。 - 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 - 活动处于非活跃状态(账户中尚无展示记录)。