开始之前
报价 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
付款
方法是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]。