كيف يمكن إنشاء حملة إعلانية باستخدام API؟
الطريقة: 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 (تشغيل)، ستصبح الحملة نشطة فقط بعد المراجعة. |
limitImpressionsTotal | تحديد إجمالي الانطباعات الحد | 200000 | يمكنك تحديد رقم واحد فقط. |
limitImpressionsDaily | تحديد اليومية الانطباعات الحد | 20000 | يمكنك تحديد رقم واحد فقط. دقيقة. يوميا الانطباعات حد 15,000. |
limitBudgetTotal | تحديد الميزانية الكلية الحد | 2000 | يمكنك تحديد رقم واحد فقط. |
limitBudgetDaily | تحديد الميزانية اليومية حد | 50 | يمكنك تحديد رقم واحد فقط. دقيقة. الميزانية اليومية الحد الأقصى هو 20 دولار. |
filters | يمكنك السماح/عدم السماح وكيل ويب المرور المرشحات. | Proxy WebView | هذه المعلمة يتم تمرير كائن. |
targeting | مطلوب استهداف إعدادات الحملة الإعلانية.
| geo browser os device mobilecarrier iprange osversions App | هذه المعايير يتم تمرير كائن. كل جديد يستهدف تحديد معلمة بفاصلة. |
uniformDistributioDaily | اختيار كيفية الحملة حدود ينبغي الوصول إليها. | ASAP Evenly | ASAP – الوصول إلى تحديد حملة حدود بأسرع وقت ممكن |
استهداف كائن
اسم | على سبيل المثال | الوصف |
geo | US GB AU | أدخل رمز من حرفين المطلوبة البلد/البلدان مفصولة بفواصل. |
browser | Chrome FireFox Safari |
|
os | Android iOS |
|
device | المحمول/الهاتف الذكي قرص |
|
mobilecarrier | الاتحاد الافريقي~فودافون |
|
iprange | 127.0.0.1 |
|
osversions | iOS 15 Win 7 |
جميع الإصدارات المتوفرة |
App |
|
استهداف كائن
اسم | على سبيل المثال |
Proxy | تسمح عدم السماح فقط |
WebView | تسمح عدم السماح فقط |
مثال الطلب:
لإنشاء حملة إعلانية بالمعلمات التالية:
تنسيق الإعلان - الظهور المنبثق على الهواتف المحمولة
السعر - 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://api.hilltopads.com/v1/advertiser/campaign?key=nXzgO3Bcاكتشف الإمكانات الكاملة لواجهة برمجة التطبيقات (API) الخاصة بشبكة HilltopAds الإعلانية!