เมธอด: PUT /api/v1/advertiser/campaign/{id}
คำอธิบาย: คุณสามารถอัปเดตแคมเปญโฆษณาที่สร้างไว้ผ่าน API สำหรับบัญชี HilltopAds ของคุณ
โปรดทราบว่าวิธีนี้มีให้บริการเฉพาะสำหรับรูปแบบ Popunder mobile และ Popunder desktop เท่านั้น
พารามิเตอร์:
ชื่อ | คำอธิบาย | ตัวอย่าง | หมายเหตุ |
key | คีย์ API ที่ไม่ซ้ำกันที่คุณสามารถสร้างได้ในส่วน API ของบัญชี HilltopAds ของคุณ | nXzgO3Bc | นี่คือพารามิเตอร์ที่จำเป็นในคำขอ |
campaignID | ID ของแคมเปญโฆษณาที่จะอัปเดต
| 123456 | คุณสามารถระบุ ID ของแคมเปญโฆษณาได้เพียงแค่หนึ่งรายการ นี่คือพารามิเตอร์ที่จำเป็นในคำขอ |
format | รูปแบบโฆษณาที่จะอัปเดตในแคมเปญ | Popunder mobile | คุณสามารถระบุรูปแบบโฆษณาได้เพียงหนึ่งรูปแบบเท่านั้น นี่คือพารามิเตอร์ที่จำเป็นในคำขอ |
rate | ราคาสำหรับ 1000 การแสดง (CPM) | 1.53 | ราคาทั้งหมด (อัตรา) ถูกระบุในคำขอโดยไม่มีสกุลเงิน แต่จะถูกตั้งค่าใน USD ในผลลัพธ์ นี่คือพารามิเตอร์ที่จำเป็นในคำขอ |
capTotal | การจำกัดความถี่ในการแสดงผล พารามิเตอร์นี้ระบุจำนวนครั้งที่โฆษณาถูกแสดง | 2 | คุณสามารถระบุเพียงหนึ่งจำนวน |
capResetAfter | การจำกัดความถี่ในการแสดงผล พารามิเตอร์นี้ระบุระยะเวลาในการแสดงโฆษณา | 12 | คุณสามารถระบุเพียงหนึ่งจำนวน |
capForCampaign | การจำกัดความถี่ในการแสดงผล พารามิเตอร์นี้ระบุว่ากฎนี้เป็นไปต่อแคมเปญหรือแบนเนอร์ | แคมเปญ | สำหรับรูปแบบ Popunder คุณสามารถระบุได้เพียง แคมเปญ เท่านั้น |
channels | ช่วงและหมวดหมู่การจราจรที่ต้องการให้โฆษณาอัปเดต | Mainstream/non-mainstream High activity Mainstream/non-mainstream Medium activity Mainstream/non-mainstream Low activity | เพื่อระบุช่วงกิจกรรมหลายรายการให้ระบุด้วยเครื่องหมายจุลภาค โปรดทราบว่าคุณสามารถระบุเพียงหนึ่งหมวดหมู่การจราจรเท่านั้น - mainstream หรือ non-mainstream นี่คือพารามิเตอร์ที่จำเป็นในคำขอ |
type | ประเภทของแคมเปญโฆษณา | CPM, CPC | โปรดทราบว่าในปัจจุบันคุณสามารถระบุ ประเภทแคมเปญ CPM เท่านั้น นี่คือพารามิเตอร์ที่จำเป็นในคำขอ |
name | ชื่อของแคมเปญโฆษณา | Popunder_API | ชื่อแคมเปญต้องเป็นเอกลักษณ์และไม่ซ้ำกับชื่อของแคมเปญที่สร้างไว้แล้ว นี่คือพารามิเตอร์ที่จำเป็นในคำขอ |
url | ลิงก์ URL เสนอที่ต้องการส่งการจราจรไปยัง | คุณสามารถระบุเพียงหนึ่งลิงก์ นี่คือพารามิเตอร์ที่จำเป็นในคำขอ | |
active | ระบุสถานะของแคมเปญที่อัปเดต: จริง - เปิด, เท็จ - ปิด | จริง, เท็จ; | เมื่อระบุสถานะของแคมเปญเป็น True (เปิด) แคมเปญจะเปิดใช้งานเมื่อผ่านการพิจารณา |
targeting | การตั้งค่าการเป้าหมายที่จำเป็นสำหรับแคมเปญโฆษณา | ภูมิศาสตร์; เบราว์เซอร์; ระบบปฏิบัติการ; อุปกรณ์; ผู้ให้บริการโทรศัพท์มือถือ; ช่วงไอพี; รุ่นของระบบปฏิบัติการ; แอป | พารามิเตอร์เหล่านี้ถูกส่งเป็นอ็อบเจกต์ แต่ละพารามิเตอร์การเป้าหมายใหม่ถูกระบุด้วยเครื่องหมายจุลภาค |
ตัวอย่างคำขอ:
เพื่ออัปเดตพารามิเตอร์ต่อไปนี้ในแคมเปญโฆษณาที่สร้างขึ้นด้วย ID 123456:
อัตรา - เป็น $2.53
ความถี่การแสดง - เป็น 1 การแสดงต่อ 24 ชั่วโมงสำหรับแคมเปญ
URL - เป็น https://mywebsit2.com
โปรดทราบว่าหากลิงก์ของคุณมีสัญลักษณ์ '&' คุณต้องเข้ารหัสมันในรูปแบบ URL-encoded มิฉะนั้นคุณอาจได้รับข้อผิดพลาดในการตอบสนองต่อคำขอการเปลี่ยนแปลงลิงก์
ตัวอย่างเช่น, ลิงก์
https://mywebsite.com/?token={{ctoken}}&zone={{zone_id}}ควรระบุเป็น
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
เพื่อเข้ารหัสลิงก์ของคุณในรูปแบบ URL-encoded, คุณสามารถใช้ เครื่องมือ ได้ คุณต้องเขียนคำขอในรูปแบบต่อไปนี้:
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