跳转到主要内容
创建广告活动

如何使用 API 创建广告活动?

HilltopAds avatar
作者:HilltopAds
一周前更新

方法:POST /api/v1/advertiser/campaign

说明:您可以通过 API 为您的 HilltopAds 广告账户创建广告活动。

请注意,此方法仅适用于 Popunder mobilePopunder 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

  • 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

这是否解答了您的问题?