تخط وانتقل إلى المحتوى الرئيسي
جميع المجموعاتأبي
تحديث حملة إعلانية
تحديث حملة إعلانية

كيفية تحديث حملة إعلانية باستخدام واجهة برمجة التطبيقات؟

HilltopAds avatar
بقلم: HilltopAds
تم إجراء هذا التحديث منذ أكثر من أسبوع

الطريقة: 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

هل أجاب هذا عن سؤالك؟