حالة الحملة الإعلانية
يقرأ 4 دقائق
campaign/status
المعلمات:
- token - التفويض (سلسلة أحرف)
- id - معرّف الحملة الإعلانية (عدد صحيح )
ids - قائمة بمعرّفات الحملات الإعلانية، مفصولة بفاصلة (سلسلة ، على سبيل المثال: "100001, 100002, 10003")يمكن تحديد معرّف الحملة الإعلانية (id) أو قائمة معرّفات الحملات الإعلانية (ids). إذا لم يتم تمرير أي من هذه المعلمات، فسيتم عرض قائمة الحملات الإعلانية بالكامل. - status - حالة الحملة الإعلانية (سلسلة، الافتراضي: جميع الحملات الإعلانية). القيم:
- rejected - تم حظرها من قبل المشرف
- moderating - في انتظار المراجعة
- stopped - الحملة متوقفة
- active - الحملة نشطة
- inactive - الحملة غير نشطة (لا توجد مشاهدات مسجلة في الحساب)
- currency - العملة (سلسلة نصية، الافتراضي: عملة الحساب). القيم:
- rub
- usd
- language - لغة وصف الحملات الإعلانية (سلسلة نصية، الافتراضي: لغة الحساب). القيم:
- ru - الروسية
- en - الإنجليزية
- es - الإسبانية
- pt - البرتغالية
الحد الأقصى لعدد الحملات الإعلانية: 1000 حملة. للحصول على القائمة الكاملة للحملات الإعلانية، يتم استخدام المعلمة:
- pagination_skip - الإزاحة، عدد الحملات الإعلانية التي تم تخطيها (int)
مثال على استدعاء الطريقة:
<?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 - الحملة غير نشطة (لا توجد مشاهدات مسجلة لحسابها).