跳转到主要内容
更新广告活动

如何使用 API 更新广告系列?

HilltopAds avatar
作者:HilltopAds
超过 7 个月前更新

方法: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://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

这是否解答了您的问题?