方法:PUT /api/v1/advertiser/campaign/{id}
说明:您可以通过 HilltopAds 账户的 API 更新已创建的广告系列。
请注意,此方法仅适用于Popunder 手机和Popunder 桌面格式。
参数:
名字 | 描述 | 范例 | 评论 |
type | 您可在 HilltopAds 账户的 API 部分生成一个唯一的 API 密钥 | nXzgO3Bc | 这是请求中的必填参数。 |
campaignID | 要更新的广告活动 ID
| 123456 | 您只能指定一个广告系列的 ID。 这是请求中的必填参数。 |
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) 时,营销活动只有在审核后才会激活。 |
targeting | 广告系列所需的定位设置。 | 地理 浏览器 os 装置 移动运营商 IPrange 版本说明 应用程序 | 这些参数以对象形式传递。每个新目标参数都用逗号指定。 |
请求示例:
在创建的 ID 为 123456 的广告系列中更新以下参数:
费率 - 至 2.53 美元
频率盖印--活动中每 24 小时显示 1 次
URL - 转至 https://mywebsit2.com
请注意,如果您的链接包含"& "符号,您需要将其编码为 URL 编码格式。否则,您可能会在链接更改请求的响应中收到错误信息。
例如,链接
https://mywebsite.com/?token={{ctoken}}&zone={{zone_id}}
应指定为
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
要将链接编码为 URL 编码格式,可以使用 工具。
您需要按照以下格式撰写申请:
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