Lewati ke konten utama

Membuat kampanye iklan

Semua tentang metode API yang dapat Anda gunakan untuk membuat kampanye iklan.

HilltopAds avatar
Ditulis oleh HilltopAds
Diperbarui lebih dari satu minggu yang lalu

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
Evenly - secara bertahap mencapai batas yang ditentukan sepanjang hari / selama seluruh periode


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

Facebook

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

  • 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!

Apakah pertanyaan Anda terjawab?