الطريقة: POST /api/v1/advertiser/campaign
الوصف: يمكنك إنشاء حملة إعلانية عبر واجهة برمجة التطبيقات لحساب الإعلانات الخاص بك على HilltopAds.
يرجى ملاحظة أن هذه الطريقة متاحة فقط لتنسيقات الظهور المنبثق على الهواتف المحمولة و الظهور المنبثق على أجهزة الكمبيوتر.
المعلمات:
الاسم
| وصف
| مثال | تعليق
|
key | مفتاح API فريد يمكنك توليده في قسم الـ API في حساب HilltopAds الخاص بك | nXzgO3Bc | هذا هو المعلمة المطلوبة في الطلب. |
format | تنسيق الإعلان الذي يجب إنشاء الحملة له. | Popunder mobile | يمكنك تحديد نوع إعلان واحد فقط. هذا هو المعلمة المطلوبة في الطلب. |
rate | السعر لكل 1000 عرض (CPM). | 1.53 | جميع الأسعار (السعر) محددة في الطلب بدون عملة، ولكن سيتم تعيينها بالدولار الأمريكي في النتيجة. هذا هو المعلمة المطلوبة في الطلب. |
capTotal | حد التكرار لعرض الإعلان. هذه المعلمة تشير إلى عدد مرات عرض الإعلان.
| 2 | يمكنك تحديد رقم واحد فقط.
|
capResetAfter | حد التكرار لعرض الإعلان. هذه المعلمة تشير إلى مدى عرض الإعلان. | 12 | يمكنك تحديد رقم واحد فقط.
|
capForCampaign | حد التكرار لعرض الإعلان. هذه المعلمة تشير إلى ما إذا كانت القاعدة تنطبق على الحملة أم الشعار. | campaign | بالنسبة لتنسيق الظهور المنبثق، يمكنك تحديد فقط الحملة. |
channels | القطاع وفئة المرور التي يجب أن يتم إطلاق الإعلان لها. | Mainstream/non-mainstream High activity Mainstream/non-mainstream Medium activity Mainstream/non-mainstream Low activity | لتحديد عدة فئات نشاط، قم بتقديمها بفواصل. لاحظ، يمكنك تحديد فئة واحدة فقط للمرور - رئيسية أو غير رئيسية. هذا هو المعلمة المطلوبة في الطلب. |
type | نوع حملة إعلانية | CPM, CPC | يرجى ملاحظة، حالياً يمكنك تحديد نوع الحملة CPM فقط. هذا هو المعلمة المطلوبة في الطلب. |
name | اسم حملة الإعلان. | Popunder_API | يجب أن يكون اسم الحملة فريدًا وغير مكررًا مع أسماء الحملات التي تم إنشاؤها بالفعل. هذا هو المعلمة المطلوبة في الطلب. |
url | رابط عرض العرض حيث يجب إرسال المرور. | يمكنك تحديد رابط واحد فقط. هذا هو المعلمة المطلوبة في الطلب. | |
active | حدد حالة الحملة المنشأة: true - تشغيل، false - إيقاف. | True, false | عند تحديد حالة الحملة كـ True (تشغيل)، ستصبح الحملة نشطة فقط بعد المراجعة. |
targeting | الإعدادات المستهدفة المطلوبة لحملة الإعلان. | geo browser os device mobilecarrier iprange osversions App | يتم تمرير هذه المعلمات ككائن. يتم تحديد كل معلمة استهداف جديدة مع فاصلة. |
مثال الطلب:
لإنشاء حملة إعلانية بالمعلمات التالية:
تنسيق الإعلان - الظهور المنبثق على الهواتف المحمولة
السعر - 1.53 دولار
تحديد تكرار الظهور - 2 عرض في كل 12 ساعة للحملة
القنوات - النشاط العالي الرئيسي والنشاط المتوسط
النوع - CPM (لتنسيق الإعلان "الظهور المنبثق" يمكنك تحديد CPM فقط)
الاسم - Popunder_API
الرابط - https://mywebsite.com.
نشط - صحيح
التوجيه - الموقع الجغرافي: الولايات المتحدة، المملكة المتحدة، ألمانيا؛ المتصفح: Chrome، Safari؛ الجهاز - الهاتف المحمول
يرجى ملاحظة أنه إذا كان رابطك يحتوي على رمز '&'، فيجب عليك ترميزه إلى تنسيق مُشفر للرابط. وإلا، قد تتلقى خطأ في الاستجابة لطلب تغيير الرابط.
على سبيل المثال، الرابط
https://mywebsite.com/?token={{ctoken}}&zone={{zone_id}}يجب تحديده كما يلي
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
لترميز رابطك إلى تنسيق مُشفر للرابط، يمكنك استخدام الأداة.
عليك كتابة طلبك في الشكل التالي:
curl -X POST --data '{"format":"Popunder mobile","channels":["Mainstream High Activity", "Mainstream Medium Activity"],"type":"CPM","rate":1.53,"name":"Popunder_API","url":"https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D","active":true,"capTotal":2,"capResetAfter":12,"capForCampaign":"campaign","targeting":{"geo":{"operator":"in","operand":["US","UK","DE"]},"browser":{"operator":"in","operand":["Chrome","Safary"]},"device":{"operator":"in","operand":["Mobile/smartphone"]}}}' https://hilltopads.com/api/v1/advertiser/campaign?key=nXzgO3Bc