Skip to main content

开发者应用程序接口

通过平台 API，可以自动执行管理面板中的所有功能。

1.广告商可以自动完成哪些工作？
  • 广告系列/组、变体、优惠和广告格式
  • 锁定/锁定目标选项、类别
  • 目标
  • 提取统计数据，包括屏蔽广告的用户数据
  • 每日预算、账户资金、付款类型
  • 着陆页面名称、URL 和流量共享算法
2.出版商可以自动完成哪些工作？
  • 广告格式和广告区域
  • 网站、URL 验证
  • 屏蔽广告类型和产品类别
  • 提取所有统计数据，包括屏蔽广告的用户数据
  • 每种广告格式/地域的竞价价格、定价模式
  • 付款类型
3.如何使用应用程序接口
  • 应用程序接口快速、易用
  • 只需选择一个参数并按下 试用 按钮，即可自动生成代码
4.下载技术文档

如何使用平台应用程序接口​

我们刚刚将平台 API 更新到第 2 版。最新版本允许您自动执行管理面板内的所有功能。您可以将 API 用于简单的流程，如自动执行重复性任务以节省时间，也可以用于更复杂的项目，如即时更改横幅创意。

特点​

出版商和广告商都可以使用大量的功能。以下是可实现自动化的功能概述：

广告商​

  • 个人/群组广告系列、变体、优惠、广告格式。
  • 锁定/屏蔽锁定选项、类别、分日。
  • 目标
  • 提取统计数据，包括广告屏蔽用户数据。
  • 每日预算、账户资金、付款类型。
  • 登陆页面名称、URL 和流量共享算法。

出版商​

  • 广告格式和广告区域。
  • 网站、URL 校验。
  • 屏蔽广告类型和产品类别。
  • 提取所有统计数据，包括广告屏蔽用户数据。
  • 每种广告格式/地域的竞价价格、定价模式。
  • 付款类型。
开始之前​

API 界面显示组标题列表。点击一个组，所有可用选项就会下拉。

list api

HTTP 动词​

应用程序接口支持以下 HTTP 动词子集。请注意，并非所有功能都支持所有动词。

API uses

让我们开始吧！

设置​

要访问受限的 API 请求，必须设置会话令牌。要设置令牌，您必须拥有一个有效账户。

API 令牌创建可在我的资料菜单下进行。选择 API 标记。

my profile

点击 新 API 令牌。

api tokens

键入令牌名称，本教程中我们称之为 "testToken"，然后点击保存。

令牌 id 已创建。

token id

登录应用程序接口​

在应用程序接口界面，点击屏幕右上方的登录按钮，输入用户名和密码或提供一个应用程序接口令牌。点击发送，一个登录请求将被发送到 API，以获取一个有效的会话令牌。该令牌将用于验证您在会话期间提出的所有 API 请求。

api login

api login

如何向应用程序接口提出请求​

让我们以 "活动 "组为例，点击它，该组就会展开，列出可用的请求：

单击要自动执行的请求，在本例中，我们将使用 CID 1923724 请求数据：

get campaign

点击 获取广告系列，展开窗口。在该字段中输入活动 ID 号：

campaign id

然后点击立即试用按钮。响应体将自动生成代码。

response body

响应代码为 200 表示可以使用。

如何暂停活动​

下面是另一个例子。首先从广告系列组中选择正确的功能：

campaign pause

点击暂停一个或多个营销活动。打开后，点击示例值，然后点击黄色框，这将自动把 json 结构粘贴到正文框中。

pause

现在的当前值是零，因此现在将零改为您要暂停的 CID。然后点击试用按钮，生成所需的代码。

campaign id

如何更新营销活动的定价​

选择正确的功能：

campaign id

点击更新活动，打开窗口。在广告系列 id 字段中添加 CID，然后单击 "示例值"，单击黄色框，将 json 结构复制到正文框中。

这段代码包含几个不同的功能，但我们需要的是活动定价代码，因此请删除代码中不需要的部分，将活动定价代码留在方框中，如下所示：

campaign id

现在，我们需要更改正文框中的两样东西，即模型(下面是与定价模型相关的值列表)。


CampaignPricing {
model (integer, optional): Campaign pricing model (1: CPC, 2: CPM, 3: CPA, 4: Smart CPM, 5: CPV) = [‘1’, ‘2’, ‘3’, ‘4’, ‘5’],
price (number, optional): Campaign price
}

我们将继续使用 CPC，因此我们将模型保留为 1

现在，我们需要将价格从 0 改为我们想要的价格。我们将把价格改为 200，这意味着新价格将是 200 美分或 2 欧元。

campaign id

然后只需点击试用按钮即可生成代码。简单！

正如您所看到的，应用程序接口(API)包含了大量可实现自动化的功能，唯一的限制就是您的想象力，以释放自动化的力量。

最后，请务必订阅我们的 API 新闻通讯，您可以在 API 界面底部找到该通讯，从而获得最新消息和更新。