Bagaimana cara membuat kampanye iklan menggunakan API?
Metode: POST /api/v1/ pengiklan/kampanye
Deskripsi: Anda dapat membuat kampanye iklan melalui API untuk akun iklan HilltopAds Anda.
Harap diperhatikan bahwa metode ini hanya tersedia untuk format Popunder mobile dan Popunder desktop.
Parameter:
nama | Deskripsi | contoh | komentar |
key | Kunci API unik yang dapat Anda hasilkan di bagian API di akun HilltopAds Anda | nXzgO3Bc | Ini adalah parameter yang diperlukan dalam permintaan. |
format | Format iklan yang perlu dibuat untuk kampanye tersebut. | Ponsel popunder | Anda hanya dapat menentukan satu format iklan. Ini adalah parameter yang diperlukan dalam permintaan. |
rate | Harga untuk 1000 tayangan (CPM). | 1.53 | Semua harga (kurs) ditentukan dalam permintaan tanpa mata uang, tetapi akan ditetapkan dalam USD pada hasilnya. Ini adalah parameter yang diperlukan dalam permintaan. |
capTotal | Batas frekuensi tayangan. Parameter ini menunjukkan berapa kali iklan ditampilkan. | 2 | Anda hanya dapat menentukan satu nomor. |
capResetSetelah | Batas frekuensi tayangan. Parameter ini menunjukkan berapa lama untuk menampilkan iklan. | 12 | Anda hanya dapat menentukan satu nomor. |
capForCampaign | Batas frekuensi tayangan. Parameter ini menunjukkan apakah aturan berlaku untuk kampanye atau spanduk. | kampanye | Untuk format Popunder, Anda hanya dapat menentukan kampanye. |
channels | Segmen dan kategori lalu lintas yang akan ditayangkan iklan. | Arus utama/non-arus utama Aktivitas tinggi Aktivitas utama/non-utama Aktivitas menengah Arus utama/non-arus utama Aktivitas rendah | Untuk menentukan beberapa segmen aktivitas, daftarkan dengan tanda koma. Catatan, Anda hanya dapat menentukan satu kategori lalu lintas - arus utama atau non-arus utama. Ini adalah parameter yang diperlukan dalam permintaan. |
type | Jenis kampanye iklan | CPM, BPK | Harap diperhatikan, saat ini Anda hanya dapat menentukan jenis kampanye CPM. Ini adalah parameter yang diperlukan dalam permintaan. |
name | Nama kampanye iklan. | Popunder_API | Nama kampanye harus unik dan tidak diulang dengan nama kampanye yang sudah dibuat. Ini adalah parameter yang diperlukan dalam permintaan. |
url | Tawarkan tautan URL di mana lalu lintas perlu dikirim. | Anda hanya dapat menentukan satu tautan. Ini adalah parameter yang diperlukan dalam permintaan. | |
active | Tentukan status kampanye yang dibuat: benar - AKTIF, salah - MATI. | Benar, salah | Saat menetapkan status kampanye sebagai Benar (AKTIF), kampanye hanya akan aktif setelah moderasi. |
limitImpressionsTotal | Tentukan Batas Total Tayangan | 200000 | Anda hanya dapat menentukan satu nomor. |
limitImpressionsDaily | Tentukan Batas Tayangan Harian | 20000 | Anda hanya dapat menentukan satu nomor. Min. batas tayangan harian adalah 15.000. |
limitBudgetTotal | Tentukan Batas Total Anggaran | 2000 | Anda hanya dapat menentukan satu nomor. |
limitBudgetDaily | Tentukan Batas Anggaran Harian | 50 | Anda hanya dapat menentukan satu nomor. Min. batas anggaran harian adalah $20. |
filters | Anda dapat mengizinkan / melarang filter lalu lintas Proxy dan tampilan web. | Proksi WebView | Parameter ini dilewatkan sebagai objek. |
targeting | Pengaturan penargetan yang diperlukan untuk kampanye iklan.
| geo browser os perangkat mobilecarrier iprange osversi Aplikasi | Parameter ini diteruskan sebagai objek. Setiap parameter penargetan baru ditentukan dengan koma. |
Distribusi seragam setiap hari | Pilih bagaimana batas kampanye harus dicapai. | ASAP Evenly | Asap-mencapai batas kampanye yang ditentukan secepat mungkinsegera |
Objek penargetan
Nama | Contoh | Deskripsi |
geo | KAMI GB AU | Masukkan kode dua huruf dari negara/negara yang disyaratkan, dipisahkan dengan koma. |
browser | Chrome FireFox Safari |
|
os | Android iOS |
|
perangkat | mobil / smartphone tablet |
|
mobilecarrier | AU ~ vodafone |
|
iprange | 127.0.0.1 |
|
osversi | iOS 15 Menang 7 |
Semua versi yang tersedia |
Aplikasi |
|
Objek penargetan
Nama | Contoh |
Proksi | Izinkan Larang Hanya |
WebView | Izinkan Larang Hanya |
Contoh Permintaan:
Untuk membuat kampanye iklan dengan parameter berikut:
Format iklan - Popunder mobile
Tarif - $ 1,53
Pembatasan frekuensi - 2 tampilan per 12 jam untuk kampanye
Saluran - arus utama aktivitas tinggi и aktivitas sedang
Jenis - CPM (untuk format iklan Popunder, Anda hanya dapat menentukan CPM)
Nama - Popunder_API
URL - https://mywebsite.com.
Aktif - Benar
Penargetan - GEO: AS, Inggris, DE; Browser: Chrome, Safary; Perangkat - seluler
Harap diperhatikan bahwa jika tautan Anda mengandung simbol '&', Anda harus mengodekannya ke format yang dikodekan URL. Jika tidak, Anda mungkin akan menerima kesalahan dalam respons terhadap permintaan perubahan tautan.
Misalnya, tautan
https://mywebsite.com/?token={{ctoken}}&zone={{zone_id}}
harus ditentukan sebagai
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
Untuk mengkodekan tautan Anda ke format yang dikodekan URL, Anda dapat menggunakan alat ini.
Anda perlu menulis permintaan dalam format berikut:
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
Maksimalkan potensi penuh dari API jaringan iklan HilltopAds!