Metode: PUT /api/v1/advertiser/campaign/{id}
Deskripsi: Anda dapat memperbarui kampanye iklan yang dibuat melalui API untuk akun HilltopAds Anda.
Harap diperhatikan, 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. |
campaignID | ID kampanye iklan yang akan diperbarui
| 123456 | Anda hanya dapat menentukan ID dari satu kampanye iklan. Ini adalah parameter yang diperlukan dalam permintaan. |
format | Format iklan yang akan diperbarui dalam kampanye | 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 perlu diperbarui iklannya. | 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 diperbarui: 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 memperbarui parameter berikut dalam kampanye iklan yang dibuat dengan ID 123456:
Rate - hingga $ 2,53
Pembatasan frekuensi - hingga 1 tampilan per 24 jam untuk kampanye
URL - ke https://mywebsit2.com
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 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