跳转到主要内容
所有收藏
优惠的应用程序接口（管理员）
优惠的应用程序接口（管理员）
Natalya Yefimenko avatar
作者：Natalya Yefimenko
超过 8 个月前更新

开始之前

报价 API

Affise API 为您提供了许多处理优惠的方法：您可以获取信息或添加/更改/删除 信息。通过 API，您可以管理您的优惠，从启用联属会员到添加一个或多个上限规则。在本文中，您将找到最常用的 API 请求（方法）示例，以及 cURL 示例和响应示例。

优惠列表

使用此方法可根据您在 API 请求中指明的属性获取优惠列表。

方法如下GET /3.0/offers。

获取激活状态的报价的请求：

https://api-rocketcompany.affise.com/3.0/offers?api-key=4sdf87fsdfd8723lkjhrn324&status[]=active

添加要约

使用此方法可在管理面板中添加一个提议。在 API 文档中，您可以看到一般参数以及数组类型的参数：

  • 付款

  • 登陆页面

  • 上限

  • 佣金等级

  • 目标群体

    • 附加跟踪 URL

    • 操作系统结构

  • HTML 创意

  • 报价表

所有这些类型的数据都有必填参数：

  • 每种类型有一个主参数

  • 每个数组中的必选参数（在 API 文档中用 * 标记

每种数据类型的主参数列表：

  • 付款：用于支付

  • 登陆： 用于登陆页面和登陆前页面

  • 上限：用于上限

  • commission_tiers：佣金等级

  • targeting （定位）：用于定位组

  • schedule（日程表）：用于报价日程表

  • creativesHtml：用于 HTML 创意

🔎创建报价的必填参数有

  • 标题

  • 广告商

  • url

  • 付款

如果您不知道要添加哪些值（例如，国家的 ISO 代码），请使用此处和此处的方法，这将有助于获得可用值列表。

方法是POST /3.0/admin/offer

cURL 请求用于添加具有以下属性的报价：

  • 活动状态。

  • 隐私级别。

  • 选定的 CPI 复选框。

  • 备注。

  • 一个针对法国、德国和意大利的通用目标群体，适用于 Android >= 6.0.0。

  • 针对相同国家/地区的一种通用支付方式，以美元为单位的固定支付类型。

  • 一个上限规则，1000 次转换，时间范围 = 月，目标 = 全部，联属会员 = 全部。

  • 两个登陆页面。

curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/admin/offer \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --data 'title=New Offer' \ --data advertiser=62fcd7ae7a3ccd7eacd7e4eb \ --data 'url=http://new-tracking-link.network.com?clickid={clickid}' \ --data status=active \ --data privacy=private \ --data is_cpi=1 \ --data 'notes=It is the latest offer' \ --data 'targeting[0][country][allow][0]=FR' \ --data 'targeting[0][country][allow][1]=DE' \ --data 'targeting[0][country][allow][2]=IT' \ --data 'targeting[0][os][allow][0][name]=Android' \ --data 'targeting[0][os][allow][0][comparison]=GTE' \ --data 'targeting[0][os][allow][0][version]=6.0.0' \ --data 'payments[0][countries][0]=FR' \ --data 'payments[0][countries][1]=DE' \ --data 'payments[0][countries][2]=IT' \ --data 'payments[0][currency]=USD' \ --data 'payments[0][type]=fixed' \ --data 'caps[0][period]=month' \ - --data 'caps[0][type]=conversions' \ --data 'caps[0][goal_type]=all' \ --data 'caps[0][affiliate_type]=all' \ --data 'landings[0][title]=Dating online' \ --data 'landings[0][url]=http：//new-tracking-link.network.com?clickid={clickid}&sub1=online' \ --data 'landings[0][url_preview]=http://new-tracking-link.network.com/online' \ --data 'landings[1][title]=Dating offline' \ --data 'landings[1][url]=http://new-tracking-link.network.com?clickid={clickid}&sub1=offline' \ --data 'landings[1][url_preview]=http://new-tracking-link.network.com/offline'

⚠️ 确保符合数据数组类型的所有要求，包括括号和数字。

添加带有徽标或创意的报价

使用此方法添加带有徽标或创意的报价。除了前面提到的必选参数外，您还可以添加以下参数：

  • 创意文件

  • 创意版本

  • 创意下载

  • 创意 HTML

  • 创意资产

  • 创意文件标题

  • creativeUrltitles

  • 创意下载标题

  • 徽标

⚠️ 如果您通过 API 手动创建要约，并希望添加徽标或创意文件/下载，请确保使用以下头内容类型： multipart/form- data。

请求可能如下所示：

您可以查看如何添加带有徽标的文件的演示：

创建包含徽标和创意的报价的 cURL 请求：

curl --location --request POST 'https://api-rocketcompany.affise.com/3.0/admin/offer' \--header 'Content-Type: application/x-www-form-urlencoded' \--header 'Content-Type: multipart/form-data' \--header 'api-key：bf09c801ff9b95b14ac8e17d6e4904b6' \--form 'title=OFFER WITH LOGO AND CREATIVES' \--form 'advertiser=5e39279bac611cda7e5765ab' \--form 'url=https://track.gjane.com/hc/click?afclick={clickid}&afpid={pid}&afoffer={offer_id}' \--form 'logo=@/C:/Users/37525/Downloads/api.png' \--form 'creativeFiles[0]=@/C:/Users/37525/Downloads/api.png' \--form 'creativeUrls[1]=https://google.drive' \--form 'creativeDownloads=https://google.drive/download' \

编辑报价

使用此方法编辑要约：全部设置或部分要约。我们建议在使用此方法前阅读有关编辑数组类型数据的文章。

方法是POST /3.0/admin/offer/{ID}

cURL 请求用于编辑同一要约中的目标群组，作为添加要约的示例。在示例中，以下内容已更改：

  • 法国、德国和意大利改为冰岛和爱尔兰。

  • 操作系统版本更改为 7.0.0。

  • 启用了反欺诈代理工具。

curl --request POST --url https://api-rocketcompany.affise.com/3.0/admin/offer/1441594 \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type： --data 'targeting[0][country][allow][0]=IS' \ --data 'targeting[0][country][allow][1]=IE' \ --data 'targeting[0][block_proxy]=1' \ --data 'targeting[0][os][allow][0][name]=Android' \ --data 'targeting[0][os][allow][0][comparison]=GTE' \ --data 'targeting[0][os][allow][0][version]=7.0.0' \ --data =

⚠️ 确保符合数据数组类型的所有要求，包括括号和数字。

启用附属机构

使用此方法可让您的联属会员使用优惠。该方法只有在提议的隐私级别为 "Premoderation "或 "Private "时才适用。

方法是POST /3.0/offer/enable-affiliate。

启用联盟 #2 的 cURL 请求：

curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/offer/enable-affiliate \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --data offer_id=1441594 \ --data pid=2

禁用联属会员

使用此方法可让您的联属会员使用优惠。该方法适用于所有隐私级别的提议。

方法如下POST /3.0/offer/enable-affiliate.

禁用联属会员的 cURL 请求 #2：

curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/offer/disable-affiliate \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --data offer_id=1441594 \ --data pid=2

禁用/启用联属会员列表

使用此方法可获取可以或不可以使用特定提议的联属会员列表。

方法是GET /3.1/offers/{ID}/privacy.

请求：

https://api-rocketcompany.affise.com/3.1/offers/1441594/privacy?api-key=4sdf87fsdfd8723lkjhrn324

更新优惠状态

使用该方法可批量更改要约状态。

方法是POST /3.0/admin/offer/mass-update.

将三个提议的状态更改为暂停的 cURL 请求：

curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/admin/offer/mass-update \ --header 'api-：4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --data 'offer_id[0]=1441594' \ --data 'offer_id[1]=1441528' \ --data 'offer_id[2]=1441527' \ --data status=suspended

如有任何问题，请通过电子邮件联系 Affise 客户支持团队：[email protected]。

相关文章
账单 API（管理员）
用于统计的应用程序接口（管理员）
通过应用程序接口编辑数据
用于报价和统计数据的应用程序接口（联属会员）
集成应用程序接口（联属公司）
这是否解答了您的问题？