主要作用:便于你自动批量拉取广告主的Offers
▲在开始之前
如果你是第一次使用Smart Puller,请先在Customization -> API 创建你的api key。
▲使用教程
1.创建广告主(若Advertisers列表已存在该广告主,可直接进行第二步)
2.创建Source(拉取Offer)
A)点击Tools→Smart Puller→Source→右上角Create
B)进入Create Source界面,填写所需对接的广告主的平台的相关信息和对接参数。
参考文档:不同平台的对接格式
Advertiser | 选择所需拉取offer的广告主ID |
Source Name | 请求广告主系统的名称(自定义) |
Source Type | 广告主所使用的系统平台 |
API Key(Token) / API Endpoint | 广告主那边提供过来 |
User Name(Network ID)/Affiliate ID | 广告主那边提供过来 |
Tracking Parameters | 添加到追踪链接所要查询追踪的链接参数,替换广告主的参数为我们的系统参数,如 clickid={click_id},=号左边为广告主的参数格式,=号右边为我们系统的参数格式。 |
Replace Offer Name | 可改为自定义的offer名称 |
C)Import Rules for New Offers(拉取Offers的条件设置)
Price Type | 计价类型,包括有RPS,RPA,RPI,RPA+RPS,RPM;可多选 |
Payout Value | 支出值(Payout处于该设定范围内的Offers将被同步到Source Offer list) |
Platform | 流量平台(所选流量平台的Offers将被同步到Source Offer list) |
Location | 国家/地区(所选国家/地区的Offers将被同步到Source Offer list) |
Currency | 货币类型(所选类型货币的Offers将被同步到Source Offer list) |
D)创建Source后,点击该Source名称进入详情,点击Test API测试是否可以成功拉取到该广告主的Offers。
▲常见问题(关于Source)
如果拉取失败,会跳转新页面显示具体原因,例如提示“API Key Wrong”,应与广告主确认是否其提供的API是否正确。
若广告主确认API无误,则使用报错页面的这段URL进行测试。
如果拉取成功,进入Source Offers查看。
3. Source Offers(用于查看已经从广告主拉到的offers)
点击Tools→Smart Puller→Source Offers
▲常见问题(关于Source)
若广告主告知已经审批了Offer A,B,C等等,但Source列表无显示:
A)以2-C)的步骤来确认API是否正确;
B)Source状态是否为“Ready”状态(如下图1),如果显示“Invalid”(如下图2),则拉取失败,可如2-D)第一个步骤所说,点击Test API查看具体错误原因;
图1↑
图2↑
C)由于Source Offers库的数据是整点自动更新一次 (首次拉取立刻更新,不需要等到整点),有可能已成功拉取单子但尚未显示出来。因此可先查看该Source创建的具体时间,从而判断是否已到或超过应当更新的时间(譬如source上一次更新是15:00,那么要到16:00后才会进行第二次更新);
D)若不想等自动更新,可在Source→选中某Source→Details里点Update,进行手动更新。
4.创建Campaign(将Offers 同步进我们系统的Offer list)
A)点击Tools→Smart Puller→Campaigns→右上角Create
B)进入Create Campaign的详情界面,填写该Campaign的相关信息
Campaign Name | 自定义名称,可与广告主同名,方便区分和记忆 |
Campaign Status | Campaign的状态 Active:该Campaign处于激活状态,可以拉取Source的单子Paused:该Campaign处于状暂停状态,无法拉取Source的单子 |
Offer Approval | Offers是否需要批准,包括私有的,公开的,需要批准的
Public:该Offer为公开状态,所有用户可见 Require approval: 该Offer需要审批后才对外可见 Private:该Offer为私密状态,可单独审批给某个用户可见 |
Offer status | 所拉取的Offers的状态,分别有默认、激活、暂停、待定中4种。
Default:所拉取的offers默认为在广告主的offer list中原始状态 Active:所拉取的offers在我们系统offer list中标记其为激活状态 Paused:所拉取的offers在我们系统offer list中标记其为暂停状态 Pending:所拉取的offers在我们系统offer list中标记其为待定状态 |
Margin | 利润;支出的过程,设置利润的百分比,计算公式为:payout=revenue*(1-x%),x为设置的margin值。 |
Field | First Sync:指该offer在拉取单子时第一次同步广告主offer的信息状态,往后不随广告主offer信息状态的改变而改变
Always:总是跟随广告主offer信息状态的改变 Disabled:系统默认选项,disabled某个选项则代表不拉取某个字段的信息到我们系统 |
C)Import Rules for New Offers(同步Offers的条件设置)
Price Type | 计价类型,包括有RPS,RPA,RPI,RPA+RPS,RPM;可多选 |
Payout Value | 支出值(Payout处于该设定范围内的Offers将被同步到Source Offer list) |
Platform | 流量平台(所选流量平台的Offers将被同步到Source Offer list) |
Location | 国家/地区(所选国家/地区的Offers将被同步到Source Offer list) |
Currency | 货币类型(所选类型货币的Offers将被同步到Source Offer list) |
Offer Limit | 限制该Campaign每次同步的offer数量 |
▲注意事项
A)关于Source选项:勾选某个Source后,会直接默认同步它的所有Offers到该Campaign,可单选/多选/全选列表上的Source,但不能针对某个Source单选/多选其名下的Offers。
B)关于Offers选项:勾选哪些Offers,则直接同步哪些Offers到该Campaign,可单选/多选/全选列表上的Offers。
▲常见问题(关于Campaign)
若创建Campaign后,Campaign列表数据不更新:
A)确认查该Campaign状态是否为“Active”;
B)由于Campaign的数据是整半点自动更新一次,有可能数据尚未来得及显示出来。因此可先查看该Campaign创建的具体时间,从而判断是否已到或超过应当更新的时间(譬如15:36创建的Campaign,到16:30后留意是否有数据更新);
C)若不想等自动更新,可点击该Campaign后的同步按钮(15分钟可操作一次),进行手动更新;
D)检查该Campaign有无设置过滤条件,如有,不满足条件的Offers则无法同步进该Campaign;
E)每次最多可更新1000个Offers;如果Campaign A一直无更新,可检查列表确认是否其他Campaign的更新数据已占满1000个名额。
▲收费情况
1.Source类别共有两种,分别是Public和Private。
2.Public类别下的sources供您免费使用;如您需使用Private类别下的Sources,则可支付$39/个Private Source的开启费用以便进行使用。