方法: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) 时,营销活动只有在审核后才会激活。 |
trageting | 广告系列所需的定位设置。
| 地理 浏览器 os 装置 移动运营商 IPrange 版本说明 应用程序 | 这些参数以对象形式传递。每个新目标参数都用逗号指定。 |
请求示例:
使用以下参数创建广告系列:
广告格式 - 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://hilltopads.com/api/v1/advertiser/campaign?key=nXzgO3Bc