Làm thế nào để tạo một chiến dịch quảng cáo bằng cách sử dụng API?
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. |
limitImpressionsTotal | Xác định Tổng ấn tượng giới Hạn | 200000 | Bạn có thể xác định, chỉ có một số. |
limitImpressionsDaily | Xác định hàng Ngày ấn tượng giới Hạn | 20000 | Bạn có thể xác định, chỉ có một số. Các phút. hàng ngày ấn tượng giới hạn là 15.000. |
limitBudgetTotal | Xác định Tổng Ngân sách giới Hạn | 2000 | Bạn có thể xác định, chỉ có một số. |
limitBudgetDaily | Xác định những giới Hạn Ngân sách hàng Ngày | 50 | Bạn có thể xác định, chỉ có một số. Các phút. hàng ngày ngân sách giới hạn là 20$. |
filters | Bạn có thể cho phép/không cho phép Proxy và Tin giao thông bộ lọc. | Proxy Hãy | Các thông số được thông qua như một đối tượng. |
targeting | Cần nhắm mục tiêu cài đặt cho các chiến dịch quảng cáo.
| địa lý duyệt hệ điều hành thiết bị mobilecarrier iprange osversions Ứng dụng | Các thông số đều trôi qua như một đối tượng. Mỗi mới nhắm mục tiêu số quy định với một dấu phẩy. |
uniformDistributionDaily | Chọn cách chiến dịch nên được giới hạn cả. | ASAP Evenly | ASAP – đạt được chỉ định chiến dịch giới hạn càng nhanh càng tốt |
Nhắm mục tiêu đối tượng
Tên | Ví dụ | Mô tả |
địa lý | CHÚNG tôi GB AU | Nhập mã yêu nước/nước, tách ra bằng dấu phẩy. |
duyệt | Crôm Internet explorer Safari |
|
hệ điều hành | Các iOS |
|
thiết bị | điện thoại máy tính bảng |
|
mobilecarrier | AU~vodafone |
|
iprange | 127.0.0.1 |
|
osversions | iOS 15 Giành chiến thắng, 7 |
Tất cả sẵn phiên bản |
Ứng dụng |
|
Nhắm mục tiêu đối tượng
Tên | Ví dụ |
Proxy | Cho phép Không cho phép Chỉ |
Hãy | Cho phép Không cho phép Chỉ |
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://api.hilltopads.com/v1/advertiser/campaign?key=nXzgO3BcKhai thác toàn bộ tiềm năng của API mạng quảng cáo HilltopAds!