Phương pháp: PUT /api/v1/advertiser/campaign/{id}
Mô tả: Bạn có thể cập nhật một chiến dịch quảng cáo đã được tạo thông qua API cho tài khoản HilltopAds của bạn.
Vui lòng lưu ý, phương pháp này chỉ có sẵn cho các định dạng Popunder mobile và Popunder desktop.
Tham số:
tên | mô tả | ví dụ | bình luận |
key | Một khóa 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. |
campaignID | ID của chiến dịch quảng cáo cần được cập nhật
| 123456 | Bạn chỉ có thể chỉ định ID của một chiến dịch quảng cáo. Đây là tham số bắt buộc trong yêu cầu. |
format | Định dạng quảng cáo cần được cập nhật trong chiến dịch | Popunder mobile | 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 lần hiển thị (CPM). | 1.53 | Tất cả các giá (tỷ lệ) được chỉ định trong yêu cầu không có tiền tệ, nhưng sẽ được thiết lập trong USD trong kết quả. Đây là tham số bắt buộc trong yêu cầu. |
capTotal | Thùng nhận diện tần số hiển thị. Tham số này chỉ ra số lần quảng cáo được hiển thị. | 2 | Bạn chỉ có thể chỉ định một số. |
capResetAfter | Thùng nhận diện tần số hiển thị. Tham số này chỉ ra thời gian hiển thị quảng cáo. | 12 | Bạn chỉ có thể chỉ định một số. |
capForCampaign | Thùng nhận diện tần số hiển thị. Tham số này chỉ ra liệu quy tắc áp dụng cho chiến dịch hay banner. | chiến dịch | Đối với định dạng Popunder, bạn chỉ có thể chỉ định «chiến dịch». |
channels | Phân đoạn và hạng mục lưu lượng mà quảng cáo cần được cập nhật. | Chủ yếu / không chủ yếu Hoạt động cao Chủ yếu / không chủ yếu Hoạt động Trung bình Chủ yếu / không chủ yếu Hoạt động Thấp | Để chỉ định nhiều phân đoạn hoạt động, liệt kê chúng với dấu phẩy. Lưu ý, bạn chỉ có thể chỉ định một hạng mục lưu lượng - mainstream hoặc non-mainstream. Đâ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 chiến dịch phải là duy nhất và không được lặp lại với tên các chiến dịch đã được tạo. Đây là tham số bắt buộc trong yêu cầu. |
url | Liên kết URL cung cấp nơi lưu lượng cần được gửi. | 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 | Chỉ định trạng thái của chiến dịch đã được cập nhật: 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 duyệt.. |
targeting | Cài đặt phân định mục tiêu bắt buộc cho chiến dịch quảng cáo. | địa lý trình duyệt hệ điều hành thiết bị nhà mạng di động dải địa chỉ IP phiên bản hệ điều hành Ứng dụng | Các tham số này được chuyển dưới dạng một đối tượng. Mỗi tham số phân định mục tiêu mới được chỉ định bằng một dấu phẩy. |
Ví dụ yêu cầu:
Để cập nhật các tham số sau trong chiến dịch quảng cáo đã được tạo với ID 123456:
Tỷ lệ - thành $2.53
Tần suất hiển thị - thành 1 lần hiển thị mỗi 24 giờ cho chiến dịch
URL - thành https://mywebsit2.com
Vui lòng lưu ý rằng nếu liên kết của bạn chứa ký hiệu '&' , bạn cần mã hóa nó sang định dạng URL-encoded. Nếu không, bạn có thể nhận được một lỗi trong phản hồi của yêu cầu thay đổi liên kết.
Ví dụ, liên kết
https://mywebsite.com/?token={{ctoken}}&zone={{zone_id}}phải được chỉ định như sau:
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
Để mã hóa liên kết của bạn sang đị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 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