الطريقة: PUT /api/v1/advertiser/campaign/{id}
الوصف: يمكنك تحديث حملة إعلانية مُنشأة عبر واجهة برمجة التطبيقات الخاصة بحساب HilltopAds الخاص بك.
يرجى ملاحظة أن هذه الطريقة متاحة فقط لتنسيقات Popunder mobile وPopunder desktop.
المعلمات:
اسم | وصف | مثال | تعليق |
key | مفتاح API فريد يمكنك توليده في قسم API من حساب HilltopAds الخاص بك. | nXzgO3Bc | هذا هو المعلمة المطلوبة في الطلب. |
campaignID | معرف الحملة الإعلانية التي تريد تحديثها | 123456 | يمكنك تحديد معرف حملة إعلانية واحدة فقط. هذا هو المعلمة المطلوبة في الطلب. |
format | شكل الإعلان لتحديثه في الحملة | Popunder mobile | يمكنك تحديد شكل إعلان واحد فقط. هذا هو المعلمة المطلوبة في الطلب. |
rate | السعر لكل 1000 مشاهدة (CPM). | 1.53 | يتم تحديد جميع الأسعار (المعدل) في الطلب بدون عملة، ولكن سيتم تعيينها بالدولار الأمريكي في النتيجة. هذا هو المعلمة المطلوبة في الطلب. |
capTotal | حد تردد الظهور. تشير هذه المعلمة إلى عدد مرات ظهور الإعلان. | 2 | يمكنك تحديد رقم واحد فقط. |
capResetAfter | حد تردد الظهور. تشير هذه المعلمة إلى مدة عرض الإعلان. | 12 | يمكنك تحديد رقم واحد فقط. |
capForCampaign | حد تردد الظهور. تشير هذه المعلمة إلى ما إذا كانت القاعدة تنطبق على الحملة أم على اللافتة. | campaign | بالنسبة لتنسيق Popunder، يمكنك تحديد حملة فقط. |
channels | شريحة وفئة المرور التي تحتاج الإعلانات إلى تحديثها. | Mainstream/non-mainstream High activity Mainstream/non-mainstream Medium activity Mainstream/non-mainstream Low activity | لتحديد عدة شرائح نشاط، قم بسرد الشرائح بفواصل. يرجى ملاحظة، يمكنك تحديد فئة مرور واحدة فقط - mainstream أو non-mainstream. هذا هو المعلمة المطلوبة في الطلب. |
type | نوع حملة الإعلان | CPM, CPC | يرجى ملاحظة، حاليًا يمكنك تحديد نوع الحملة CPM فقط. هذا هو المعلمة المطلوبة في الطلب. |
name | اسم حملة الإعلان. | Popunder_API | يجب أن يكون اسم الحملة فريدًا وغير مكرر مع أسماء الحملات المنشأة بالفعل. هذا هو المعلمة المطلوبة في الطلب. |
url | رابط عرض URL حيث يجب إرسال المرور. | يمكنك تحديد رابط واحد فقط. هذا هو المعلمة المطلوبة في الطلب. | |
active | حدد حالة الحملة المحدثة: true - ON، false - OFF | True, false | عند تحديد حالة الحملة كـ True (ON)، ستصبح الحملة نشطة فقط بعد المراجعة. |
targeting | الإعدادات المستهدفة المطلوبة لحملة الإعلان. | geo browser os device mobilecarrier iprange osversions App | تمرير هذه المعلمات ككائن. يتم تحديد كل معلمة استهداف جديدة بفاصلة. |
مثال الطلب:
لتحديث المعلمات التالية في حملة الإعلانات المُنشأة بالمعرف 123456:
المعدل - إلى 2.53 دولار
تردد الظهور - إلى عرض واحد كل 24 ساعة للحمل
عنوان URL - إلى https://mywebsit2.com
يرجى ملاحظة أنه إذا كان رابطك يحتوي على رمز '&'، يجب عليك ترميزه إلى صيغة URL-encoded. في خلاف ذلك، قد تتلقى خطأ في الاستجابة لطلب تغيير الرابط.
على سبيل المثال، الرابط:
https://mywebsite.com/?token={{ctoken}}&zone={{zone_id}}
يجب تحديده كما يلي:
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
لترميز رابطك إلى صيغة URL-encoded، يمكنك استخدام الأداة.
عليك كتابة الطلب بالتنسيق التالي:
curl -X PUT --data '{"rate":"2.53","capTotal":1,"capResetAfter":24,"capForCampaign":"campaign","url":"https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D"}' https://hilltopads.com/api/v1/advertiser/campaign/123456?key=nXzgO3Bc