Phương thức: POST /api/v1/advertiser/campaign
Mô tả: Bạn có thể tạo một chiến dịch quảng cáo qua API cho tài khoản quảng cáo HilltopAds của bạn.
Vui lòng lưu ý rằng phương thức này chỉ có sẵn cho các định dạng Popunder di động và Popunder máy tính để bàn.
Tham số:
tên | mô tả | ví dụ | bình luận |
key | Một mã API duy nhất mà bạn có thể tạo trong phần API của tài khoản HilltopAds của bạn | nXzgO3Bc | Đây là tham số bắt buộc trong yêu cầu. |
format | Định dạng quảng cáo cho chiến dịch cần được tạo. | Popunder di động | Bạn chỉ có thể chỉ định một định dạng quảng cáo. Đây là tham số bắt buộc trong yêu cầu. |
rate | Giá cho 1000 hiển thị (CPM). | 1.53 | Tất cả các giá (tỷ lệ) được chỉ định trong yêu cầu mà không có tiền tệ, nhưng sẽ được đặt trong USD trong kết quả. Đây là tham số bắt buộc trong yêu cầu. |
capTotal | Tần suất hiển thị tối đa. Tham số này cho biết số lần một quảng cáo được hiển thị. | 2 | Bạn chỉ có thể chỉ định một số. |
capResetAfter | Tần suất hiển thị tối đa. Tham số này cho biết thời gian hiển thị quảng cáo. | 12 | Bạn chỉ có thể chỉ định một số. |
capForCampaign | Tần suất hiển thị tối đa. Tham số này cho biết xem quy tắc áp dụng cho chiến dịch hoặc banner. | chiến dịch | Đối với định dạng Popunder, bạn chỉ có thể chỉ định chiến dịch. |
channels | Đoạn và danh mục lưu lượng mà quảng cáo cần được khởi chạy. | Chính thống / không chính thống Hoạt động cao Chính thống / không chính thống Hoạt động trung bình Chính thống / không chính thống Hoạt động thấp | Để chỉ định nhiều đoạn hoạt động, liệt kê chúng bằng dấu phẩy. Lưu ý, bạn chỉ có thể chỉ định một danh mục lưu lượng - chính thống hoặc không chính thống. Đây là tham số bắt buộc trong yêu cầu. |
type | Loại chiến dịch quảng cáo | CPM, CPC | Vui lòng lưu ý, hiện tại bạn chỉ có thể chỉ định Loại chiến dịch CPM. Đây là tham số bắt buộc trong yêu cầu. |
name | Tên của chiến dịch quảng cáo. | Popunder_API | Tên của chiến dịch phải là duy nhất và không lặp lại với các tên chiến dịch đã tạo trước đó. Đây là tham số bắt buộc trong yêu cầu. |
url | Liên kết URL cần gửi lưu lượng. | Bạn chỉ có thể chỉ định một liên kết. Đây là tham số bắt buộc trong yêu cầu. | |
active | Xác định trạng thái của chiến dịch đã tạo: true - BẬT, false - TẮT. | Đúng, sai | Khi chỉ định trạng thái chiến dịch là True (BẬT), chiến dịch sẽ trở nên hoạt động chỉ sau khi được kiểm duyệt. |
targeting | Cài đặt định tuyến bắt buộc cho chiến dịch quảng cáo. | geo browser os device mobilecarrier iprange osversions App | Những tham số này được chuyển dưới dạng một đối tượng. Mỗi thông số định tuyến mới được chỉ định bằng dấu phẩy. |
Ví dụ yêu cầu:
Để tạo một chiến dịch quảng cáo với các tham số sau:
Định dạng quảng cáo - Popunder di động
Tỷ lệ - $1.53
Tần suất hiển thị tối đa - 2 hiển thị mỗi 12 giờ cho chiến dịch
Kênh - hoạt động chính thống cao và hoạt động trung bình
Loại - CPM (đối với định dạng quảng cáo Popunder, bạn chỉ có thể chỉ định CPM)
Tên - Popunder_API
URL - https://mywebsite.com
Hoạt động - Đúng
Định tuyến - Địa lý: Mỹ, Anh, Đức; Trình duyệt: Chrome, Safary; Thiết bị - di động
Vui lòng lưu ý rằng nếu liên kết của bạn chứa ký tự '&', bạn cần mã hóa nó thành định dạng URL-encoded. Nếu không, bạn có thể nhận được lỗi trong phản hồi cho yêu cầu thay đổi liên kết.
Ví dụ, liên kết
https://mywebsite.com/?token={{ctoken}}&zone={{zone_id}}cần được chỉ định như là
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
Để mã hóa liên kết của bạn thành định dạng URL-encoded, bạn có thể sử dụng công cụ.
Bạn cần viết một yêu cầu theo định dạng sau:
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