如何通过使用 API 创建广告活动?
方法:POST /api/v1/advertiser/campaign
说明:您可以通过 API 为您的 HilltopAds 广告账户创建广告活动。
请注意,此方法仅适用于 Popunder mobile 和 Popunder desktop 格式。
参数:
名字 | 描述 | 范例 | 评论 |
key | 您可在 HilltopAds 账户的 API 部分生成一个唯一的 API 密钥 | nXzgO3Bc | 这是请求中的必填参数。 |
format | 需要创建广告活动的广告形式。 | Popunder 移动电话 | 您只能指定一种广告格式。 这是请求中的必填参数。 |
rate | 1000 印次的价格 (CPM)。 | 1.53 | 所有价格(汇率)都在请求中指定,不含货币,但在结果中将设置为美元。 这是请求中的必填参数。 |
capTotal | 印象频率上限。该参数表示广告的显示次数。 | 2 | 只能指定一个数字。 |
capResetAfter | 印象频率上限。该参数表示广告的播放时间。 | 12 | 只能指定一个数字。 |
capForCampaign | 印象频率上限。该参数表示规则适用于广告系列还是广告条。 | 竞选 | 对于 Popunder 格式,您只能指定 活动。 |
channels | 需要发布广告的细分市场和流量类别。 | 主流/非主流 活动量大 主流/非主流 中等活动 主流/非主流 活动少 | 要指定多个活动分段,请用逗号将它们列出。请注意,您只能指定一个流量类别--主流或非主流。 这是请求中的必填参数。 |
type | 广告活动类型 | CPM, CPC | 请注意,目前您只能指定 CPM 广告系列类型。 这是请求中的必填参数。 |
name | 广告活动名称。 | Popunder_API | 活动名称必须是唯一的,不能与已创建的活动名称重复。 这是请求中的必填参数。 |
url | 提供需要发送流量的 URL 链接。 | 您只能指定一个链接。 这是请求中的必填参数。 | |
active | 指定创建活动的状态:true - 开启,false - 关闭。 | 真,假 | 当指定营销活动状态为 True (ON) 时,营销活动只有在审核后才会激活。 |
limitImpressionsTotal | 指定的总限制的印象 | 200000 | 你只能指定一个号码。 |
limitImpressionsDaily | 指定的每日印象的限制 | 20000 | 你只能指定一个号码。 该分钟。 每日印象限是15 000人。 |
limitBudgetTotal | 指定的总的预算限制 | 2000 | 你只能指定一个号码。 |
limitBudgetDaily | 指定的每日预算限制 | 50 | 你只能指定一个号码。 该分钟。 日预算限制为20亿美元。 |
filters | 你可以允许/不允许代理和WebView通过滤器。 | 代理 WebView | 这些参数是通过作为对象。 |
targeting | 需要针对设置广告宣传活动。
| 地理 浏览器 os 装置 mobilecarrier 关 osversions 应用程序 | 这些参数是通过作为对象。 每一个新的针对指定参数与一个逗号。 |
uniformDistributionDaily | 选择如何运动的限制应该能达到。 | ASAP Evenly | ASAP 到达指定活动的限制尽可能快地 |
针对的对象
名称 | 例 | 描述 |
地理 | 我们 GB AU | 输入的双字母代码所需要的国家/国家,中间用逗号分隔。 |
浏览器 | 铬 FireFox Safari |
|
os | 安卓 iOS |
|
装置 | 移动/智能手机 平板电脑 |
|
mobilecarrier | AU~vodafone |
|
关 | 127.0.0.1 |
|
osversions | iOS15 赢得7 |
所有可用的版本 |
应用程序 |
|
针对的对象
名称 | 例 |
代理 | 允许 不允许 只 |
WebView | 允许 不允许 只 |
请求示例:
使用以下参数创建广告系列:
广告格式 - Popunder 移动版
费率 - 1.53 美元
封盖频率 - 每 12 小时 2 次展示活动
渠道 - 主流高活性 и 中活性
Type - CPM(对于 Popunder 广告格式,您可以只指定 CPM)。
Name - Popunder_API
URL - https://mywebsite.com。
Active - 真
Targeting - GEO:美国、英国、德国;浏览器:Chrome, Safary; 设备 - 移动
请注意,如果您的链接包含"& "符号,您需要将其编码为 URL 编码格式。否则,您可能会在链接更改请求的响应中收到错误信息。
例如,链接
https://mywebsite.com/?token={{ctoken}}&zone={{zone_id}}
应指定为
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
要将链接编码为 URL 编码格式,可以使用 工具。
您需要按照以下格式撰写申请:
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
发掘 HilltopAds 广告网络 API 的全部潜力!