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. |
targeting | Pengaturan penargetan yang diperlukan untuk kampanye iklan.
| geo browser os perangkat mobilecarrier iprange penyimpangan Aplikasi | Parameter-parameter ini diteruskan sebagai objek. Setiap parameter penargetan baru ditentukan dengan koma. |
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://hilltopads.com/api/v1/advertiser/campaign?key=nXzgO3Bc