วิธี: POST /api/v1/advertiser/campaign
คำอธิบาย: คุณสามารถสร้างแคมเปญโฆษณาผ่าน API สำหรับบัญชีโฆษณา HilltopAds ของคุณ
โปรดทราบว่าวิธีนี้มีให้บริการเฉพาะสำหรับรูปแบบ "Popunder mobile and Popunder desktop"
พารามิเตอร์:
ชื่อ | คำอธิบาย | ตัวอย่าง | หมายเหตุ |
key | คีย์ API ที่ไม่ซ้ำกันซึ่งคุณสามารถสร้างในส่วน API ของบัญชี HilltopAds ของคุณ | nXzgO3Bc | นี่เป็นพารามิเตอร์ที่จำเป็นในคำขอ |
format | รูปแบบโฆษณาสำหรับแคมเปญที่ต้องการสร้าง | Popunder mobile | คุณสามารถระบุรูปแบบโฆษณาได้เพียงหนึ่งรูปแบบเท่านั้น นี่เป็นพารามิเตอร์ที่จำเป็นในคำขอ |
rate | ราคาสำหรับ 1000 การแสดง (CPM) | 1.53 | ราคาทั้งหมด (อัตรา) ระบุในคำขอโดยไม่มีสกุลเงิน แต่จะถูกตั้งค่าใน USD ในผลลัพธ์ นี่เป็นพารามิเตอร์ที่จำเป็นในคำขอ |
capTotal | แคปที่บ่งบอกถึงจำนวนครั้งที่โฆษณาถูกแสดง | 2 | คุณสามารถระบุได้เพียงหนึ่งตัวเลข |
capResetAfter | แคปที่บ่งบอกถึงเวลาที่จะแสดงโฆษณา | 12 | คุณสามารถระบุได้เพียงหนึ่งตัวเลข |
capForCampaign | แคปที่บ่งบอกถึงว่ากฎนี้ใช้กับแคมเปญหรือแบนเนอร์ | แคมเปญ | สำหรับรูปแบบ Popunder คุณสามารถระบุเพียง แคมเปญ |
channels | ส่วนและหมวดหมู่การจราจรที่ต้องการเริ่มโฆษณา | เมนสตรีม/นอนเมนสตรีม กิจกรรมสูง/กิจกรรมต่ำ เมนสตรีม/นอนเมนสตรีม กิจกรรมกลาง เมนสตรีม/นอนเมนสตรีม กิจกรรมต่ำ | เพื่อระบุกลุ่มกิจกรรมหลายรายการ ให้ระบุด้วยเครื่องหมายจุลภาค โปรดทราบว่าคุณสามารถระบุเพียงหนึ่งหมวดหมู่การจราจร - mainstream หรือ non-mainstream เท่านั้น นี่เป็นพารามิเตอร์ที่จำเป็นในคำขอ |
type | ประเภทของแคมเปญโฆษณา | CPM, CPC | โปรดทราบว่าในปัจจุบันคุณสามารถระบุเฉพาะ ประเภทแคมเปญ CPM เท่านั้น นี่เป็นพารามิเตอร์ที่จำเป็นในคำขอ |
name | ชื่อของแคมเปญโฆษณา
| Popunder_API | ชื่อแคมเปญต้องเป็นเอกลักษณ์และไม่ซ้ำกับชื่อแคมเปญที่สร้างไว้แล้ว นี่เป็นพารามิเตอร์ที่จำเป็นในคำขอ |
url | ลิงก์ URL ข้อเสนอที่ต้องการส่งการจราจร
| คุณสามารถระบุเพียงหนึ่งลิงก์ นี่เป็นพารามิเตอร์ที่จำเป็นในคำขอ | |
active | ระบุสถานะของแคมเปญที่สร้าง: true - เปิด, false - ปิด
| จริง, เท็จ | เมื่อระบุสถานะแคมเปญเป็น True (เปิด) แคมเปญจะเปิดใช้งานได้เมื่อผ่านการตรวจสอบ |
limitImpressionsTotal | สำหรับกำหนดทั้งหมดน่าประทับใจน่ามอจำกัด | 200000 | คุณสามารถกำหนดมีเพียงหมายเลขเดียว |
limitImpressionsDaily | สำหรับกำหนดวันทำงานน่าประทับใจน่ามอจำกัด | 20000 | คุณสามารถกำหนดมีเพียงหมายเลขเดียว ที่มิน วันทำงานน่าประทับใจน่ามอจำกัดคือ 15,000 ดอลลา. |
limitBudgetTotal | สำหรับกำหนดทั้งหมดบประมาณจำกัด | 2000 | คุณสามารถกำหนดมีเพียงหมายเลขเดียว |
limitBudgetDaily | สำหรับกำหนดวันทำงานงบประมาณจำกัด | 50 | คุณสามารถกำหนดมีเพียงหมายเลขเดียว ที่มิน วันทำงานงบประมาณจำกัดคือเงิน 20. |
filters | คุณสามารถอนุญาตให้/ไม่อนุญาตของพร็อกซีและ WebView การจราจรตัวกรอง. | ของพร็อกซี WebView | พารามิเตอร์พวกนี้คือผ่านเหมือนกับวัตถุอย่างนึง |
targeting | ต้องการพุ่งเป้าไปที่การตั้งค่าสำหรับสื่อไม่สนเรื่องหาเสียง
| ใต้ดิน เบราว์เซอร์ o อุปกรณ์ mobilecarrier iprange osversions แอพ | พวกค่าพารามิเตอร์เป็นผ่านไปเหมือนกับวัตถุอย่างนึง แต่ละคนใหม่ลังพุ่งเป้าไปที่พารามิเตอร์ถูกกำหนดกับคอมม่า |
uniformDistributionDaily | เลือกวิธีการหาเสียงที่จำกัดควรจะเข้าถึงได้ | ASAP Evenly | ASAP –ติดต่อที่กำหนดการหาเสียงขีดจำกัดให้เร็วที่สุดเท่าที่จะทำได้ |
เป้าหมายที่วัตถุ
ชื่อ | ตัวอย่างเช่น | รายละเอียด |
ใต้ดิน | พวกเรา กิกะไบต์ ตรงกั | ป้อนสองคน-รหัสจดหมายของที่ต้องประเทศ/ประเทศโดยแยกแต่ละตัวด้วยช่องว่า. |
เบราว์เซอร์ | Chrome ไฟร์ฟอกซ์ name ซาฟารี |
|
o | Android iOS |
|
อุปกรณ์ | เคลื่อน/\n smartphone แผ่นจารึก |
|
mobilecarrier | ตรงกั~vodafone |
|
iprange | 127.0.0.1 |
|
osversions | iOS 15 ชนะ 7 |
เอารุ่นที่มีอยู่
|
แอพ |
|
เป้าหมายที่วัตถุ
ชื่อ | ตัวอย่างเช่น |
ของพร็อกซี | อนุญาต ไม่อนุญาต เพีย |
WebView | อนุญาต ไม่อนุญาต เพีย |
ตัวอย่างคำขอ:
เพื่อสร้างแคมเปญโฆษณาด้วยพารามิเตอร์ต่อไปนี้:
รูปแบบโฆษณา - Popunder โมบายล์
อัตรา - $1.53
ความถี่การแสดง - 2 การแสดงต่อ 12 ชั่วโมงสำหรับแคมเปญ
ช่อง - mainstream กิจกรรมสูง และกิจกรรมกลาง
ประเภท - CPM (สำหรับรูปแบบโฆษณา Popunder คุณสามารถระบุได้เฉพาะ CPM เท่านั้น)
ชื่อ - Popunder_API
URL - https://mywebsite.com.
ใช้งาน - True
เป้าหมาย - GEO: US, UK, DE; Browser: Chrome, Safary; อุปกรณ์ - โมบายล์
โปรดทราบว่าหากลิงก์ของคุณมีสัญลักษณ์ '&' คุณต้องเข้ารหัสเป็นรูปแบบ URL-encoded มิฉะนั้นคุณอาจได้รับข้อผิดพลาดในการตอบกลับของคำขอการเปลี่ยนแปลงลิงก์
ตัวอย่างเช่น ลิงก์
https://mywebsite.com/?token={{ctoken}}&zone={{zone_id}}ควรระบุเป็น
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
เพื่อเข้ารหัสลิงก์ของคุณเป็นรูปแบบ URL-encoded คุณสามารถใช้ เครื่องมือ ได้
คุณต้องเขียนคำขอในรูปแบบต่อไปนี้:
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ปลดล็อกศักยภาพสูงสุดของ API เครือข่ายโฆษณา HilltopAds!