# 序言 本文档的版权归Hugoffers官网所有，本文档及其描述的内容受有关法律的版权保护，对本文档内容的任何形式的非法复制，泄露或散布，将导致相应的法律责任。 **Hugoffers简介** **1、全面的操作** Hugoffers是一个为广告主、渠道和网盟平台提供实时管理、跟踪、分析等服务，并且优化它们在线广告活动的联属网络营销平台。 **2、丰富的功能** Offer：支持一键快速创建Offer、一键复制Offer、Offer多维度动态筛选授权屏蔽等 Report：超过30方面的实时统计数据、比较统计数据等 广告主：内置500+API广告主模板、一键拉取广告主offer等 渠道：支持多维度动态筛选授权Offer，例如Top Offers、Top ECPC Offers等 优化：支持Smartlinks、TTI IP防欺诈分析优化、转化率（CR）自动优化等 账单：支持自动生成账单、自动分析同步上下游数据、Invoice线上签字盖章、分析整理账单数据等 基础支持：邮件支持系统、转化IP白名单、渠道系统自定义等 **3、Hugoffers特色** Hugoffers目前集成了国内外500+广告主API，API拉取时自动测试Offer跳转链接并且动态给渠道授权Offer **4、Hugoffers坚持** 总的来说Hugoffers系统是在众多网盟SasS产品中拥有友好的页面交互体验、功能完善并且能实现客户精细化运营需求的一款产品。想了解更多详情请访问[官网](https://www.hugoffers.com/)信息。 # 如何注册Hugoffers试用账号？ 您可以通过以下方式快速注册Hugoffers： 访问我们的官网，点击免费试用，填写账户相关信息； 我们会在信息审核通过后立即为您激活帐户。 或直接点击链接注册:，我们提供30天免费试用期： ![](/files/-MZHlwhZodZPo8jQSCTP) # 中文说明文档 简要说明文档仅针对于有一定网盟经验并且熟悉网盟平台的同学，如初次接触网盟平台请参考详细说明文档，如对文档有疑问或者建议请注明Hugoffers平台使用建议发送邮件至。 # Hugoffers常用页面名词解释 | 名词 | 页面解释 | | --------------------- | ----------------------------------------------------------------------- | | Dashboard | 首页数据显示界面 | | Offers | 创建offer offer列表 offer授权(渠道后台申请) offer跳转次数界面 | | Reports | Overview总体数据报表 conversion转化数据报表 Event事件报表 质量报表 每日报表 优化子渠道报表 | | Affiliate | 渠道信息页面，包括设置渠道Postback | | Advertiser | 广告主页面 设置广告主Tracking 和Postback | | Ad Managers | 系统管理员界面 包括新增系统使用人员列表和权限模板设置 | | Rules | 根据运营需求创建的一些规则 例如流量导入、暂停、Label标签规则、Group Permission规则 | | Integration | API Out: 给渠道生成API Feed url 筛选单子等 API IN: API广告主拉取offer设置 给渠道批量开offer界面 | | Fraud Analysis | 作弊分析 IP重复率和TTI分析界面 | | Tools | 工具页面 包括星标offer、Smartlink、设置App黑名单、测试跳转和测试回传、现有Label显示页面 | | Company | 公司信息 付款方式 推荐奖励 系统花费 | | Billing | 广告主 渠道历史账单渠道付款方式 广告主对账分析界面 | | Setting | 基础设置界面 包含公司logo、默认时区、转化ip白名单、邮箱支持设置 | | Message | 提醒界面 包括渠道账单确认、新注册渠道提醒、渠道申请offer提醒 | | Support | 技术支持页面 | | GO TO AFFILIATE PANEL | 通往渠道系统页面 | # Hugoffers简要说明文档 使用Hugoffers系统对接API广告主和渠道的一般步骤为： 登陆账号->[新增系统使用人员账号](https://www.yuque.com/hugoffers/support/create-admanager)->[创建广告主，配置tracking参数](https://www.yuque.com/hugoffers/support/create-advertisers)->[广告主的API配置](https://www.yuque.com/hugoffers/support/api-in-integration)->[创建渠道，配置渠道postback链接](https://www.yuque.com/hugoffers/support/create-affiliate)->[与渠道对接的API配置](https://www.yuque.com/hugoffers/support/api-out-integration)->[给渠道授权Offer](https://www.yuque.com/hugoffers/support/authorize-offers-to-affiliate)->[和上下游测试对接](https://www.yuque.com/hugoffers/support/testing-with-adv-and-aff)->后续的运营 # Ad Managers界面新增使用系统人员 在Ad Managers菜单下有两个子菜单，作用分别是设置系统使用人员权限和权限模板设置 **Ad Managers List**\ 设置系统使用人员角色，分别有管理员角色-Administrator、广告主角色-AM、渠道角色-PM、销售角色-Sales、财务角色-Finance。每个角色的系统权限模板不一样(可以在Auth Template-Edit-Customer处更改角色权限模板)。 ![添加使用系统人员](/files/-Lqz8CcvqesMDXKA8BzW) **Hugoffers AM/PM数据权限判定说明** | 菜单 | Administrator | AM | PM | AM\&PM | Finance\&Sales | | ----------------- | :-----------: | :---------------: | :--------------: | ------------------------- | :------------: | | Dashboard | ALL | 该AM管理的广告主和Offer数据 | 该PM管理的渠道和Offer数据 | 同时判定AM\&PM账户权限 | ALL | | OfferList | ALL | 该AM管理的广告主的Offer数据 | ALL | 该AM的广告主的Offer数据 | ALL | | Advertiser | ALL | 该AM管理的广告主 | ALL | 该AM管理的广告主 | ALL | | Affiliate | ALL | ALL | 该PM管理的渠道账户 | 该PM管理的渠道账户 | ALL | | Overview report | ALL | 该AM管理广告主的数据 | 该PM管理的渠道的offer数据 | 同时判定AM/PM账户权限，默认显示AM的账户数据 | ALL | | Conversion report | ALL | 该AM管理广告主的数据 | 该PM管理的渠道的offer数据 | 同时判定AM/PM账户权限，默认显示AM的账户数据 | ALL | | Adv Billing | ALL | 该AM管理的广告主账单 | 所有 | 该AM管理的广告主账单 | ALL | | Aff Billing | ALL | ALL | 该PM的渠道的账单 | 该PM的渠道的账单 | ALL | | API IN/API OUT | ALL | 该AM的广告主的API-IN | 该PM管理的API-OUT | 同时判定AM/PM账户权限 | ALL | \ **Auth Template**\ 系统权限模板设定，可以在Edit-Customer处自定义系统各个角色权限模板。 ![自定义权限模板](/files/-Lqz_zTO-VeRbjLDBpXJ) # Advertiser页面创建广告主设置好Tracking链接模板 在**Advertisers**界面创建广告主信息时最重要的一步是填对Tracking信息，Hugoffers集成了接近500家广告主的Tracking模板，可以在Advertiser tracking template这里搜索。 当然由于广告主系统存在经常更新的情况建议对照广告主最新文档自主添加，只需要与Hugoffers参数一一对应即可。Postback信息会在填完参数之后自动生成。 ![将广告主参数与Hugoffers参数一一对应](/files/-LqzcPOHcUobaIOY2al_) # Integration页面新建广告主的API并配置好参数 在**Integration API-IN Integration** 新建广告主的API链接。 填参数的时候可以对应广告主给的API链接依次填入即可，**如广告主API单页限制了数量并且Url Template中无page=，则可在其中一个参数后面加入\&page={page\[1-10]}，如有page参数，则page参数填入{page\[1-10]}代表拉取广告主1到10页offer。填入后将result链接放入浏览器中查看是否有offer信息(如填写了{page\[1-10]}则浏览器无法解析但是Hugoffers系统会做拉取)，之后15分钟系统会将offer拉入到offer list中**。如果有需要特殊请求头的链接需要协助对接请联系Hugoffers产品或运营人员。 ![将广告主给的API链接与模板链接参数一一对应 result为最终链接](/files/-Lqzgnl9GnWRlgAOw0zQ) # 在Affiliate界面新建渠道并配置好渠道给的postback链接 在 **Affiliate** 界面新建渠道并配置好渠道给的Postback。\ 注意：Hugoffers对接渠道时对应渠道的点击参数为 **aff\_sub，**请正确替换参数否则会导致渠道接收不到回传。 ![填入渠道给的Postback并替换点击及其他参数](/files/-Lr77tPilD04htvv223b) # 在Integration页面给渠道生成API链接 在 **Integration API-Out Integration** 处找到刚刚新建的渠道，点击 **Operate-Edit-Generate Token-Submit** 即可生成给渠道的API链接。 ![生成给渠道的API链接](/files/-Lr798Lsb_n2CpYzQ6fR) # 给渠道授权Offer Hugoffers给渠道配置Offer方式有3种： **1、API IN配置渠道** 此配置只针对于API Offer，在 **Integration API-IN Integration** 中选择对应API广告主，在 **Edit - Permission** 处即可添加对应渠道。API IN详细配置说明请[参考](https://www.yuque.com/hugoffers/support/mcl2rc) ![API IN处配置渠道](/files/-Lr7CcirXuAYaIpnq_Dr) **2、单个Offer配置渠道** 在API拉取offer或者手动创建offer之后点进offer详情里 **Access** 处配置渠道，Access Status默认为Inherit即继承 **Integration API-IN Integration-Permission** 中的渠道，将它改成 **Private** 或者 **Need Approval** 即可添加渠道。 ![单个Offer配置渠道](/files/-Lr7C-8Mmg5e0z0o6Z8n) **3、Group Permission配置渠道** Group Permission功能非常强大，此处仅介绍如何使用Group Permission配置渠道。在 **Home-Rules-Group Permission-Add** 处配置渠道 ![编辑Group Permission配置渠道](/files/-Lr7EVzngSUojFhAwfDG) 也可以在Offer list中筛选或者选中某些Offer将其配置渠道。 具体操作为 **Home-Offers-Offer List** 处双击选中Offer或者筛选出某些Offer进行渠道配置或者屏蔽。 ![双击选中Offer或者筛选Offer进行操作](/files/-Lr7Fsn87Yo9SYbu6skP) ![Control Type可做授权和屏蔽操作](/files/-Lr7G94tN7zRDuJWC0vo) # 广告主渠道对接测试 **注意：广告主渠道测试都需要在正确设置Postback之后进行！！！** \ **一、自己作为渠道让广告主测试回传** 1.配置好广告主的tracking url fomate和post back信息参数 2.需要广告主提供测试offer 3.在**Home-Offers-Offer List**找到offer，在Offer details中将左下角 **Test mode** 改为 **Yes** （在此状态下，系统不会判定国家和平台）如果没有就添加对应的offer，开一个测试渠道（也可以自己创建个专门测试的渠道），之后点击 **Generate Tracking URL - Test Link** 将链接提供给广告主。 ![将Test Mode改为Yes](/files/-Lr7J2E12_MvJsDjmQPd) ![生成测试链接并给到广告主](/files/-Lr7Jin64T1ZY-XxaqUs) 4.等待广告主测试成功后，检查**Home-Reports-Conversion Report** 处查询是否接收到广告主回传，如果接收到，表示测试成功，可以正式推广。 如果未接收到： 1.看一下跳转是否正常 2.看参数配置是否正常，尤其是click id 3.看postback配置是否正常（自己提供的是否正确，以及广告主配置是否正确） 4.等待一段时间，可能会有延迟。延迟比较久的可能会有10分钟左右。 5.换一个offer，再按上面的流程再做一次测试 6.如果还是不成功，可以少量上量测试。 **二、作为广告主，给自己的渠道测试回传** 1.配置渠道postback链接（注意[参数替换](https://www.yuque.com/hugoffers/support/parameters-for-integration)） 2.告知渠道用哪个offer测试，并给他开这个offer的权限，让渠道提供测试链接 3.点击Tools/tracking test中的Conversion Test，输入offer的ID，点击空白处会自动拉取到平台、国家。在URL中输入渠道提供的测试链接。点击Search，生成跳转信息。点击send postback，底部将会出现是否success的字样（error：0 即没有错误）。 ![给渠道发送模拟回传](/files/-Lr7Mrw4j9oR-WetBzWh) 4.显示conversion Received 5.到Conversion Report中等待conversion report的数据 6.如果有了数据（如果pending需要置为Approved），向渠道确认有没有收到postback 如果没有收到： 1.看看我们系统渠道的postback参数有没有配对 2.等待一些时间，大约5-10分钟再查看一下 3.用conversion test 工具重新测试一遍 4.如果还是不能成功，联系我们的技术人员，协助测试。 # Hugoffers高阶运营技巧简要版 Hugoffers拥有众多精细化运营功能。比如Tracking跳转测试、Label标签、流量导向、自动管理流量、Smartlink流量，还有对IP CTTI进行作弊分析、自定义上传子渠道或包名参数、控制CTTI回传等。 # Tracking跳转测试 Hugoffers能对Offer的跳转进行测试，API的Offer需要在 **Integration API-IN Integration** 处将 **Execute Tracking Test** 改为 **Yes**,下面测试周期Only Once代表所有Offer只测试一次，下次API拉取不做测试，Once a day/week代表周期为天/周之后会重新测试。 ![API IN打开测试功能](/files/-Lr8MVu3dtFeEILr_ffI) 手动Offer可点击详情中 **Tracking URL** **Test** 即可。所有测试的Offer可在 **Offer list** 或者 **Tracking Test result** (右上角可选择测试时间段)处查看详情。**Success** 代表能正常跳转至应用商店，**Fail** 代表跳转失败，**Wrong APP** 代表跳转至错误的APP应用商店，**No Third Part** 代表能正常跳转至APP应用商店但是没有经过第三方分析平台如Appsflyer、Adjust。 测试之后可以在 **Home-Rules-Label Rule** 处新建一个以Offer维度动态的标签。之后在Group Permission选择对应Offer标签即可动态授权给渠道。 ![新建跳转成功2-5次的Offer标签](/files/-Lr8PzKBHzETa5CPqZJe) # Label标签功能 创建Label标签能更好对流量进行精细化运营。 **1、广告主/渠道标签** 在 **Advertisers/Affiliates** 界面可以对广告主/渠道设置Label标签。 ![设置广告主/渠道标签](/files/-Lr8RRXrhw4CUcWajdWP) **2、单个Offer标签** 在Offer详情处可以对Offer进行单个设置Offer标签。 ![设置单个Offer标签](/files/-Lr8Rt2gOuE7kkRH21xx) **3、动态标签** 在 **Label Rule** 处可以设置多个动态标签。 ![Label Rule设置动态标签](/files/-Lr8S45aw9aLH9lCXDl3) **创建完之后可以在Group Permission中选择对应标签进行流量管理。** ![Group Permission管理标签](/files/-Lr8TNjAMU9uTTVmKhhO) # 流量导入功能 在 **Traffic Redirect Rule** 中系统内置 **\[System Auto]Blacklist pub** 代表自动拉取API广告主的黑名单子渠道并将流量导入到默认ID为0的Offer(如未设置Smartlink)。流量导入示例 ![将广告主1和2 包名为com.test的流量全部导入到Offer ID 123](/files/-Lr8UsxZvpxKCSOn0ctP) # 流量暂停功能 Hugoffers能自动的管理流量。例如对系统内所有Offer在一个小时内点击大于1000无转化，自动的对流量进行操作，具体的操作有发送邮件通知、关闭offer、拉黑渠道、拉黑子渠道。以下为操作示例 ![系统内所有一小时1000点击无转化或转化大于5%拉黑渠道](/files/-Lr8W3fBxzBqLZt67Cjg) # Smartlink流量设置 对于渠道方送无效点击如国家平台不匹配、Offer暂停、黑名单子渠道流量可以通过Smartlink继续利用。以下为操作示例 ![创建Smartlink](/files/-Lr8XQHyjo64hfFCzAmp) ![将需要Smartlink流量的Offer从Add Offers中添加](/files/-Lr8XftPF40GNnS0mJBO) # TTI及IP防作弊分析 **CTTI** 代表终端流量从点击Tracking链接到安装应用程序的时间。Hugoffers目前能对渠道发送的点击进行 **IP** 和 **TTI** 分析，分别在 **Home-Fraud Analysis-IP/TTI Analysis** 页面。 1、**Grossing IP** 代表总IP量，**Unique IP** 代表去重之后的IP量，**Repeat Count** 代表重复比例。 ![IP分析页面](/files/-LrNiZ7_i4uqEL3El4vY) 2、TTI分析页面可显示各个渠道TTI分布比例。 ![各个渠道TTI分布比例](/files/-LrNjqa3a8E-ePLnpQz9) # 系统基础设置及邮箱支持 **一、General Settings**
![](/files/-Lr8ZT-FDCTvItoQj93C) Network ID：子渠道的域名，不可修改。 Customer Application Domain：客户自己的域名（处于注册时的默认状态），不可修改。 Network Timezone：客户所处的时区（处于注册时的默认状态），可以修改。 修改之后会同步到如下位置：![](https://downloads.intercomcdn.com/i/o/109452877/3b5de9d8cf295a4f8e9bdb79/1.png) Company Logo：公司Logo 未上传时，系统默认显示注册时的公司名称。 上传图片支持格式‘png’、‘jpg’、‘jpeg’、‘bmp’四种格式，大小限制50M。 需要更新Logo时，上传新Logo，系统会直接覆盖并替换原Logo。 Customize Title：自定义标题\ \ **二、Affiliate Panel Settings** ![](/files/-Lr8ZeboDJphR30EkK9_) Terms\&Conditions：决定Publisher Sign Up页面的Terms的有无。 未上传时，系统显示默认的Terms\&Conditions。 上传文件仅支持PDF格式，大小限制在50M。 需要替换新文件时，上传新文件，系统会直接覆盖原文件，并生效。 具体位置如下：在渠道的登录界面，点击Affiliate Sign Up。 Affiliate privacy Policy：客户自己的隐私政策（处于注册时的默认状态），支持上传和下载功能。 未上传时，系统显示默认的Privacy Policy。 上传文件仅支持PDF格式，大小限制在50M。 需要替换新文件时，上传新文件，系统会直接覆盖原文件，并生效。 上传修改之后，系统内所有的Privacy Policy会相对应的发生改变。\ \ Affiliate Sign Up Status：设置了两种情况，可以选择Active和Require Approval模式。 默认是Require Approval模式。 ![](https://downloads.intercomcdn.com/i/o/109454951/16e50d1fccb35d15dea4f9d5/3.png) Active模式下，渠道注册系统时，自动生效； Require Approval模式下，渠道注册后需要审核通过后才能使用。 Questions For Affiliate Sign Up：用户可以自定义Affiliate Sign Up 的问题。 ![](/files/-Lr8ZtOTPcwOu41tX78d) **三、Tracking Settings** ![](/files/-Lr8ZzCDXIEtD-3NX47i) Default Tracking Domain：Click 域名，不可以修改。 Network Global Postback URL：全局的回传URL，不可以修改。 Default KPI：对于API的单子，无KPI时显示默认KPI。 Custom Postback Server IP List：广告主的Postback Server IP。 以列表的形式显示，可以进行添加，修改和删除的操作。 Conversions out of Allowed Countries：对国家进行设置，接受非允许国家的转化，提供Pending和Approved两种模式。默认Pending。 Conversions Over Cap：对于超cap的转化，提供Pending和Approved两种模式。 **四、Support Email Settings**
![](/files/-Lr8_4frjYnHRIXwcwOg) SMTP Domain/IP Address ：填写SMTP信息 Port：端口号 SMTP User Name：邮箱地址 SMTP User Password：邮箱密码 “From” Email Name：邮件中显示的邮箱名称，一般是公司名称。 “From” Email Address：只展示，信息和SMTP User Name相同。不可修改 Test SMTP Server：测试按钮，填写上述信息后，点击按钮，会发送测试邮件，测试通过后才能保存。 以下为腾讯企业邮箱示例SMTP Domain/Port ![](/files/-Lr8_byvp8gGeSbcdbly) **如为腾讯企业邮箱**\ **SMTP Domain:smtp.exmail.qq.com**\ **Port:465** \ **如为阿里企业邮箱**\ **SMTP Domain:smtp.mxhichina.com**\ **Port:465** **五、Advance Setting** ![Advanced 设置界面](/files/-Lr8_DLg9fyHRPRWjBOj) 勾选Country Test Mode为将系统内所有Offer移除国家定向，勾选Platform Test Mode为将系统内所有Offer移除平台定向。Hugoffers默认会将非Offer设定国家和平台的流量屏蔽。 Automatic Block Server Traffic为自动屏蔽服务器发送的点击流量。 # Hugoffers国内idfa归因对接流程 ### 1、对接广告主 1、对接广告主Tracking参数，参考如下：（需要配置参数：idfa、ip、callback）\ 示例链接：[http://test.hugoffers.com/q?offerid=123456\&ip={ip}\&idfa={idfa}\&callback={CALLBACK|urlencode}](http://%2A%2A%2A.com/q?offerid=123456\&ip=%7Bip%7D\&idfa=%7Bidfa%7D\&callback=%7BCALLBACK%7Curlencode%7D)\ 2、Callback配置\ 第一步：在Advertisers-Detail-Postback Setting处拿到Postback URL前半部分例如\ 第二步：将上述链接在[转码网站](http://tool.chinaz.com/tools/urlencode.aspx) UrlEncode编码得到http%3a%2f%2ftest1.hopb0.com%2fnotify%2f110158%2f%3fclick\_id%3d\ 第三步：拼接上述编码后的链接即在后面加上{click\_id}，示例拼接后的链接为 http%3a%2f%2ftest1.hopb0.com%2fnotify%2f110158%2f%3fclick\_id%3d{click\_id}\ 第四步：拼接整个Offer tracking示例\ http\://\*\*\*.com/q?offerid=123456\&ip={ip}\&idfa={idfa}\&callback=http%3a%2f%2ftest1.hopb0.com%2fnotify%2f110158%2f%3fclick\_id%3d{click\_id} 此时得到的tracking链接即为推广链接。给到下游媒体的推广链接为[https://test.hotrk0.com/offer?offer\_id=221\&aff\_id=1\&aff\_sub=\[click\_id\]\&aff\_pub=\[source\]\&advertising\_id=\[advertising\_id\]\&idfa=\[idfa\]](https://test.hotrk0.com/offer?offer_id=221\&aff_id=1\&aff_sub=%5Bclick_id%5D\&aff_pub=%5Bsource%5D\&advertising_id=%5Badvertising_id%5D\&idfa=%5Bidfa%5D) **如果上游为异步对接**，只需在tracking链接前面加上get: 以下为示例链接\ get:[http://\*\*\*.com/q?offerid=123456\&ip={ip}\&idfa={idfa}\&callback=](http://%2A%2A%2A.com/q?offerid=123456\&ip=%7Bip%7D\&idfa=%7Bidfa%7D\&callback=%7BCALLBACK%7Curlencode%7D)http%3a%2f%2ftest1.hopb0.com%2fnotify%2f110158%2f%3fclick\_id%3d{click\_id} ### 2、对接渠道 1、渠道Tracking配置\ 正常配置Tracking，添加idfa参数及Postback。**渠道如果需要在Tracking中配置Callback回传**，参考如下：\ [https://test.hotrk0.com/offer?offer\_id=221\&aff\_id=1\&idfa={idfa}\&ip={ip}\&aff\_sub=callback](https://test.hotrk0.com/offer?offer_id=221\&aff_id=1\&aff_sub=aazz\&idfa=%7Bidfa%7D\&ip=%7Bip%7D\&aff_sub2=%7Bcallback) | urlencode，之后在渠道Postback Format中写入**decode:{aff\_sub}**即可。例如 [https://test.hotrk0.com/offer?offer\_id=5\&aff\_id=6\&idfa={idfa}\&ip={ip}\&aff\_sub=http%3a%2f%2f39.104.70.46%3a8085%2fmailuo%2fapi%2fcallback.json%3fclickId%3d](https://test.hotrk0.com/offer?offer_id=5\&aff_id=6\&aff_sub=aazz\&idfa=%7Bidfa%7D\&ip=%7Bip%7D\&aff_sub2=http%3a%2f%2f39.104.70.46%3a8085%2fmailuo%2fapi%2fcallback.json%3fclickId%3d) 2、如果渠道为异步对接只需在**Affilites Controller**处勾选**Disable Check Platform Disable Check Country**即可，**但是如果上游有做国家和平台的限定也需要和上游沟通将国家和平台限定去除！！！**
### 测试 1、广告主测试\ 拿到对接广告主时给下游媒体的推广链接 [https://test.hotrk0.com/offer?offer\_id=221\&aff\_id=1\&aff\_sub=\[click\_id\]\&aff\_pub=\[source\]\&advertising\_id=\[advertising\_id\]\&idfa=\[idfa\]](https://test.hotrk0.com/offer?offer_id=221\&aff_id=1\&aff_sub=%5Bclick_id%5D\&aff_pub=%5Bsource%5D\&advertising_id=%5Badvertising_id%5D\&idfa=%5Bidfa%5D) 替换idfa（最好使用未安装过推广App的iPhone点下面这条链接测试安装）和其他参数，例如\ ![在Offer详情处拿到Test link测试](/files/-LrgBwRc6fxpc_mgIeL6) 点击安装之后和上游确认是否有收到对应idfa点击及安装数据，并且在conversion report处检查是否有收到上游回传的激活数据。 2、渠道测试\ 让渠道替换给他们下游媒体的推广链接参数后测试安装激活，激活后和最上游确认是否有接收相应激活数据并且在系统conversion report处检查是否有接收上游转化数据并确认是否有回传给下游媒体。 # Hugoffers详细说明文档 * 广告主篇[^1] * [渠道篇](/zhong-wen-shuo-ming-wen-dang/hugoffers-xiang-xi-shuo-ming-wen-dang/qu-dao-pian) * [offer篇](/zhong-wen-shuo-ming-wen-dang/hugoffers-xiang-xi-shuo-ming-wen-dang/offer-pian) * [高阶运营篇](/zhong-wen-shuo-ming-wen-dang/hugoffers-xiang-xi-shuo-ming-wen-dang/gao-jie-yun-ying-pian) * [系统内其他设置相关说明及常见QA](/zhong-wen-shuo-ming-wen-dang/hugoffers-xiang-xi-shuo-ming-wen-dang/untitled-1) [^1]: # 广告主篇 # 创建广告主说明文档 首先在导航栏点击Add Advertiser 添加广告主，完善信息。 **Account Details** ![](https://downloads.intercomcdn.com/i/o/85415188/0881684a5254846cf10faa6a/image.png) 第一部分填写是广告主的基础信息，这里的Email Address是我们后续开发出的广告主平台的登录系统账号，password是广告主登录广告主平台的密码。保存后的信息随时可以modify进行更改。 ![](https://downloads.intercomcdn.com/i/o/85415342/73a659dc870114ec2e33afd3/image.png) 这里的Administrator指的是管理这个广告主的管理员是谁（可选Ad Manager） ![](https://downloads.intercomcdn.com/i/o/85415461/a5da51b1455166085dd3cccf/image.png) 在Advertiser中有Mail List选项，可以每个选项填多个邮箱，逗号隔开，即可在mail setting发邮件时可以给某一个mail list发送。 ![](https://downloads.intercomcdn.com/i/o/85415520/d229ac2fbd40e968f6127ade/image.png) **Tracking Format** 你需要向你的广告主要他们的tracking格式，将他们给的tracking截取出来参数部分，将后面中括号的参数替换成[HugOffers的系统对应参数](https://intercom.help/hugoffers/tech-and-integrations/tracking-and-postback-format)即可 参考广告主文档，例子：adv\_click\_id={click\_id}\&pub\_id={aff\_pub}
![](https://downloads.intercomcdn.com/i/o/146203900/b69e999337101b44368b7490/image.png) 点击submit保存成功。 postback在tracking保存时会自动生成，将它交给广告主。 **Operate** 右边的 Operate 是对广告主进行的操作。\ 点击Report可以看到这个广告主的报告。\ 在Modify在可以更改广告主信息。\ Offers可以看到这个广告主下的所有单子。\ 点击Account Block 可以停掉这个账户，这样广告主也不能够登陆了。\ 点击Offer Block 可以将这个广告主的所有offer关停。\ 点击Reset Password 可以重置他的密码。 ![](https://downloads.intercomcdn.com/i/o/97711655/0170878d1e315d1d6bd53029/image.png) 广告主：花钱做广告的一方 使用Hugoffers系统对接广告主的顺序： 新建广告主账号 如果是s2s手动对接的广告主在[手动创建offer](https://www.yuque.com/hugoffers/support/create-manual-offers)时选择对应的广告主即可\ 如果是API对接的广告主则需要在[API IN Integration](https://www.yuque.com/hugoffers/support/integration-with-adv)中进行API的配置
**首先,在导航栏点击Advertiser-Add添加广告主，完善信息。** **Account Details** 第一部分填写是广告主的基础信息，这里的Email Address是广告主平台的登录系统账号，password是广告主登录广告主平台的密码。保存后的信息随时可以modify进行更改。 **Administrator** 这里的Administrator指的是管理这个广告主的管理员是谁（可选Ad Manager） **Other** 在Advertiser中有Mail List选项，可以每个选项填多个邮箱，逗号隔开，即可在mail setting发邮件时可以给某一个mail list发送。 **Tracking Format**
你需要向你的广告主要他们的tracking格式或者参数说明文档，将他们给的tracking截取出来参数部分，将后面中括号的参数替换成[HugOffers的系统对应参数](https://www.yuque.com/hugoffers/support/parameters-for-integration)即可 参考广告主文档，例：\&adv\_click\_id={click\_id}\&pub\_id={aff\_pub} 点击submit保存成功。 postback在tracking保存时会自动生成，将它交给广告主。 若需要广告主给我们回传event，可以将event postback url一并提供，**若需要接收更多数据例如拒绝原因子原因等，可以用data3\~data10接收** **Operate** 右边的 Operate 是对广告主进行的操作。 点击Report可以看到这个广告主的报告。 在Modify在可以更改广告主信息。 Offers可以看到这个广告主下的所有单子。 点击Account Block 可以停掉这个账户，这样广告主也不能够登陆了。 点击Offer Block 可以将这个广告主的所有offer关停。 点击Reset Password 可以重置他的密码。 注意：若在Advertiser界面点击 “Account Block”，HugOffers系统将会自动把对应的API状态置为Inactive。注释：如果你在Advertiser界面点击 “Account Block”，HugOffers系统将会自动把对应的API状态置为Inactive。 # 常见的第三方平台对接-Appsflyer、Adjust **写在前面：** 第三方平台是指行业里为广告主（app拥有者）提供一系列跟踪，归因，统计，分析，防作弊等的技术平台，多数是付费的技术支持服务。 #### 一、对接Appsflyer 在 **Advertiser** 中 **Click URL Format** 处保存下列参数配置： clickid={click\_id}\&af\_siteid={aff\_id}\&android\_id={android\_id}\&advertising\_id={advertising\_id}\&idfa={idfa}\&af\_click\_lookback=7d\&af\_ip={ip}\&af\_ua={user\_agent}\&af\_lang={aff\_lang}\&af\_sub\_siteid={aff\_pub}\&af\_ad\_id={offer\_id}\&af\_adset\_id={tid} 如下图：![](https://cdn.nlark.com/yuque/0/2022/png/32830607/1670833760137-c75c79c3-d017-444f-b57e-8620d7ba14ab.png) 需提供给Appsflyer工作人员的信息： **点击替换格式** clickid={click\_id}\&af\_ad\_id={offer\_id}\&af\_sub\_siteid={aff\_pub}\&af\_siteid={aff\_id}\&android\_id={android\_id}\&advertising\_id={advertising\_id}\&idfa={idfa}\&af\_click\_lookback=7d\&af\_adset\_id={tid}\&af\_ip={ip}\&af\_ua={user\_agent}\&af\_lang={aff\_lang}（标红参数为ios单子参数，非广告主要求可以不用配置） **回传格式** Install Postback: [http://{cid}.hopb1.com/notify/global/?click\_id={clickid}](http://%7Bcid%7D.hopb0.com/notify/global/?click_id=%7Bclickid%7D)\&aff\_id={af\_siteid}\&offer\_id={af\_ad\_id}\&aff\_pub={af\_sub\_siteid}\&tid={af\_adset\_id} Event Postback: [http://{cid}.hopb1.com/event/global/?click\_id={clickid}\&event={event\_name}\&data={event\_value}](http://%7Bcid%7D.hopb0.com/event/global/?click_id=%7Bclickid%7D\&event=%7Bevent_name%7D\&data=%7Bevent_value%7D)\&aff\_id={af\_siteid}\&offer\_id={af\_ad\_id}\&aff\_pub={af\_sub\_siteid}\&tid={af\_adset\_id}

***

#### 二、对接Adjust Adjust是允许客户把回传配置在tracking里面，所以非常灵活。也就是客户迁移到我们系统，可以完全不用跟adjust再次对接，就可以直接推广adjust的tracking。
一般流程如下： 1.广告主提供给您推广产品的跟踪链接和事件token（CPI事件中token非必要）。 2.在 页面生成tracking。在 **Enter your links** 处输入Adjust给的tracking link短链，在 **Your Callbacks-Install** 处输入该广告主对应的Postback URL. 3.复制在**Generated URLs** 处中生成的URL，添加其他参数（见常用参数配置问题③），配置在offer中。
示例： 广告主提供的链接：[https://app.adjust.com/wgq0t16](https://app.adjust.com/qqm3e)
*** #### 输入对应广告主的Postback URL \ 在adjust的install通用格式： **http\://{youdomain.hopb1.com}/notify/global/?click\_id={click\_id}**\ 注意：无论广告主点击id是否为{click\_id}，此处都配置为click\_id={click\_id} \ **示例：**\ 广告主install处postback： \ 在adjust页面 Generated URLs 处自动生成对应的参数为：install\_callback=http%3A%2F%2Ftest.hopb1.com%2Fnotify%2Fglobal%2F%3Fclick\_id%3D{click\_id} 要接收应用内事件，需要广告主提供事件token及event名称，截图示例中token为7p21gq，event名称为abc的callback配置。\ 在adjust的Event postback通用格式：\ **http\://{youdomain.hopb1.com}/event/global/?click\_id={click\_id}\&event=广告主给到的事件名称(如register)**\ \ **示例：** 广告主给到信息token为7p21gq，event名称为abc\ 则在token处填写7p21gq\ 在callback处填写的pb为： 在adjust页面 Generated URLs 处自动生成对应的参数为：\ \&event\_callback\_7p21gq=http%3A%2F%2Ftest.hopb1.com%2Fevent%2Fglobal%2F%3Fclick\_id%3D{click\_id}%26event%3Dabc \ ![](https://cdn.nlark.com/yuque/0/2024/png/32830607/1726224766470-3817d941-9542-4484-85e4-9359f5f0a32a.png) 举例：
复制生成的URL，填写到Offer Details-Tracking URL部分。 #### Adjust常用参数问题： ①出现campaign=campaign name，该参数为自定义信息，一般是常量 ②postback链接中最好配置click\_id={click\_id} 。 ③**参数：**\&adgroup={aff\_pub}\&gps\_adid={advertising\_id}\&idfa={idfa}\&language={aff\_lang}\&user\_agent={user\_agent}\&ip\_address={ip} **注意：不要忘记配置**，否则adjust无法获得子渠道等信息**。（标黄参数非广告主要求可不配置）** **配置方法1：可以在tracking里面生成，**![](https://cdn.nlark.com/yuque/0/2023/png/32830607/1687344171317-5c202d90-c74a-4fb5-af49-f7e39b48e6ae.png) **配置方法2：可以直接配置在adv tracking parameter** 完成上面两个配置就可以正常的接收安装回传和事件回传了。如果是非CPI付费offer，则参考event事件的相关文档说明。 # 非Click id归因回调对接 对于ios14更新后广告主无法回调click id、idfa等参数的情况，Hugoffers支持非Click id归因回调对接方式，**该方式与原本的回调方式兼容。** **实际运营操作注意：** **一、Tracking link配置** 需要向广告主/appsflyer上传offer\_id、aff\_id、aff\_pub、tid四个参数 | Tracking Parameters | Type | Description | Remark | | ------------------- | ------ | ------------------------------------------------------------------------------------------ | :------: | | offer\_id | String | ID of offer. | required | | aff\_id | String | ID of publisher. | required | | aff\_pub | String | Sub source id/sub id | required | | tid | String | The parameter automatically generated by Hugoffers.（Do not use the value uploaded by aff.） | required | ps：**tid** 为hugoffers自动生成参数，不能使用下游上传的值。\ 与appflayer对接时需另外配置参数，例如：\ \&af\_siteid={aff\_pub}\&af\_sub\_siteid={aff\_id}\&af\_ad\_id={offer\_id}\&af\_adset\_id={tid} **二、回传链接配置** 使用非Click id归因回调对接方式，请勾选 Home-Advertiser页面对应广告主账号的Controller模块 **Conversion Without ClickId** 选项 因为广告主无法回传click id，回传链接中需要传递offer\_id、aff\_id、aff\_pub、tid四个参数（必传），缺一不可，系统根据回传的这四个值 ，找到本系统内部clickid，执行回传流程。 此时给到广告主的postback url示例： id/?click\_id={广告主点击参数}\&offer\_id={广告主系统offerid参数}\&aff\_id={广告主系统渠道id参数}\&aff\_pub={广告主系统子渠道参数}\&tid={广告主系统高隐私模式参数} 给到使用appsflyer的广告主postback url示例： Install Postback: http\://{cid}.hopb0.com/notify/global/?click\_id={clickid}\&aff\_pub={af\_siteid}\&offer\_id={af\_ad\_id}\&aff\_id={af\_sub\_siteid}\&tid={af\_adset\_id} Event Postback: http\://{cid}.hopb0.com/event/global/?click\_id={clickid}&\&aff\_pub={af\_siteid}\&offer\_id={af\_ad\_id}\&aff\_id={af\_sub\_siteid}\&tid={af\_adset\_id}\&event={event\_name}\&data={event\_value} 即配置给到广告主的postback/callback链接中需要配置这4个参数。上一篇 **常见的第三方平台对接-Appsflyer、Adjust** 下一篇 **创建手动offer** * # 创建手动offer #### 注意： 1. 创建手动offer前需要确保已经[创建好对应的广告主](https://www.yuque.com/hugoffers/support/How-to-create-an-advertiser)。 2. 向广告主获取到offer基本信息：应用包名app id（页面推广不做要求）、追踪链接（Tracking link/click url)、offer的国家geo、单价payin、预算cap信息。 #### 创建步骤： 选择offer创建模式->填写offer信息->核对关键信息，进行后续测试
**1.选择offer创建模式：** \ 点击导航栏Offers-Create Offer，有三种offer模式可选： ![](https://cdn.nlark.com/yuque/0/2021/png/2501264/1619502890649-f720071e-3011-497d-9cb9-22a0cca2d7c6.png) Quickly Create Offer：快速创建offer，适用app offer，只需填写较少信息，需填写应用包名，可较快创建offer。\ App Promotion：app推广，适用app offer，需填写详细信息，需填写应用包名。\ Web Promotion：页面推广，适用页面推广，无需填写应用包名。 **2.填写offer信息** 以Quickly Create Offer为例，填写内容如下：\ ![](https://cdn.nlark.com/yuque/0/2021/png/2501264/1619504322723-575bd363-e8a5-40fc-966a-f76f1b7e1341.png) 填写完毕后点击finish create提交，进入offer详情页面 **3.核对关键信息，进行后续模拟测试**
在offer详情中查看tracking link、单价、国家是否正确，没有问题可以开始[与广告主进行回调模拟测试](https://www.yuque.com/hugoffers/support/testing-offer-postback) # 广告主API IN文档说明 HugOffers可以通过API集成实现自动化拉取offer，其中API-IN是针对广告主设置的api对接，目前系统内已经集合了500多家API对接模板供您使用。 与广告主进行API对接,需要相关信息，如API对接文档、完整的API url、参数说明等。 **添加API对接** 对于支持API的广告主，创建好广告主账号后，在导航栏 **Integration** 的 **API-IN Integration**页面点击 **Add** 创建对接并填写相应的信息。
**General** **API Name**：API模板名称,确认广告主平台后，可在API Name中搜索平台名或广告主名。如果没有，可联系Hugoffers技术团队进行添加。 **Advertiser：**选择对接的广告主，前提是在 Advertiser 已经[添加广告主](https://www.yuque.com/hugoffers/support/how-to-create-an-advertiser)。 **API Status**：API对接状态，默认为Active。 **Default Payout(%)\*：**默认payout百分比，在广告主单价基础上所有offer的给到渠道的单价百分比。在offer授权方式为inherit时生效。 **Default Daily Cap：**每日的预计转化数量，-1 意味着cap没有上限。 我们提供以下选项供你选择： * * Use\ , if not exist, use \ 使用广告主API的cap，如果广告主未设置cap，或者cap不存在，使用上面的Default Daily Cap。 * Ignore\ and use \ 忽略广告主API的cap，直接使用上面的Default Daily Cap。 * If \ equals 0, or not exist，use \ 如果API拉取的广告主的cap为0或者不存在，直接使用上面的Default Daily Cap。 **Goal Name：**需要选择类型，分为CPI\CPA\CPS\CPR\CPE **Insert Limit：**指的是API拉取的offer的最大值，可以进行限制。
**Generate Url** HugOffers会基于你选择的API模板自动生成Url Template，填入对应的参数（需要参考广告主的API文档），生成Result Urls。 ![](https://cdn.nlark.com/yuque/0/2021/png/2501264/1619508480147-dab03c06-e8c6-465f-86be-0fa1eca1172c.png)以affise\_partner 模板为例 注意：系统配置了**翻页功能**，若广告主API单页限制了数量，模板链接没有page等页码参数，可在其中一个参数后面加\&page={page\[1-10]}；如有page参数，则page参数填入{page\[1-10]}。{page\[1-10]}代表拉取广告主接口的第1-10页内容。（使用翻页功能的链接在浏览器无法打开，但是系统可拉取） **Permission** 在API-IN中Permission可以设置默认授权的渠道及cap、payout等相关信息。此处配置渠道即为该广告主的offer在拉取进系统时，就会默认授权给这些渠道。 Default Cap Percent 拥有最高权限，渠道的cap=Default Cap Percent\*Default Daily Cap ①，如果 Default Cap 广告主那里设置的是0，对应的渠道cap=Default Daily Cap ② **Filter** 可添加过滤条件，来筛选想要的维度的单子。筛选维度包括国家、平台、激励类型、app种类、单价（开区间，非包含）。 完成后点击Submit保存 **View：**列表中可以看到API对接的具体信息。 Counts：API上一次拉取到的单子的数量。 Last Execute Date：API上一次拉取的具体时间。 **Search**：支持按照API名、广告主、渠道、状态维度索API **Operate：**对已创建的API对接的操作选项。 Edit 可以修改这一条API的信息。 Inactive 和 active 可以关闭和开启 API. Delete 将会从表中删除该条API。 注：如果你在Advertiser界面点击 “Account Block”，HugOffers系统将会自动把对应的API-IN处对接状态置为Inactive。 # 广告主Event事件回传说明文档 Events是为了接收更多的应用内事件,丰富数据报表分析的维度,提供更多运营的数据支持,HugOffers为所有客户提供Events支持,其配置和使用说明如下. ### 1.接收广告主 events 配置格式: 与Global Conversions 配置类似,但events可以接收更多的信息,包括event名称,购买类事件购买金额,广告主动态分成金额,格式如下 [**http://{cid}.hopb0.com/event/adv**](http://%7Bcid%7D.hopb0.com/event/adv) **id/?click\_id={adv click id}\&event={event name}\&data={sale amount}\&data2={advertiser payout}** 备注:click id ,event 名字为必填项 如果已知是某个事件的回传,也可以直接配置成event=该事件名称,如purchase,registration等 EXAMPLE: [http://cheetahmobile.hopb0.com/event/110045/?click\_id={aff\_sub}\&event=registration](http://cheetahmobile.hopb0.com/event/110045/?click_id=%7Baff_sub%7D\&event=registration) ### 2.如何把event转成conversion进行计费统计并回传给渠道付费事件? 如果广告主已经正确配置了event回传,HugOffers系统也能正确的接收到,我们支持把event转化成conversion并回传给渠道.只需要在payin的地方event的地方把event名称跟接收到event名称保持一致即可. 如果有对应的转化产生,可以在conversion report查询到相应数据并且可以看到对应的event name,而events报表则不会有该原始event数据了. 备注:正常通过conversion接收的回传不需要配置,如果配置后会进行匹配,只有匹配一致才会产生回传,统计revenue和cost ### 3.Events report Events report 是记录每条系统收到的events数据,包括发生时间,ip,点击id,渠道id等等,并支持筛选导出. ### 4.Quality Report Quality report 为conversion报表和Events报表数据的整合并进一步计算得出一些统计结果.所以,如果没有events数据,quality report便不能获得准确的分析,如果支持了events回传,则可以在quality report进一步分析流量的质量表现. **Target Event Rate**:是统计该event名字的事件占conversion的比例 **Sales Amount**:通过event postback里面的data参数接收,货币为美金 **ROI**:为Sales Amount/(conversions\*payin)\*100%,为广告主投资回报率 **CAC**:为平均某个事件的获取成本,计算公式为:(Payin\*conversions)/events数量 **Options**:运营选中了渠道和子渠道之后,便会出现Options的选项,可以根据质量报告情况对子渠道进行Push或者Pause的操作,并对相应的渠道子渠道进行邮件通知.Pause操作会把对应的子渠道添加到黑名单,并对流量进行屏蔽. Tips: Events相关报告为运营人员提供了更多维度的数据支持,结合其他维度可以更全面的评估渠道的质量表现,所以在条件允许情况下尽量的跟广告主完成event回传的接收配置. # 渠道篇 # 渠道API对接文档 # 创建渠道说明文档 首先在导航栏点击Add Affiliate 添加渠道，完善信息。 ![](https://downloads.intercomcdn.com/i/o/85420089/ecd7dc5f7eaf541d6a64aacc/image.png) ![](https://downloads.intercomcdn.com/i/o/85420118/851b7ebecb855124b9573e0b/image.png) 第一部分填写是渠道的基础信息，这里的Email Address是我们渠道登录的系统（系统网址为：[域名.hugoffers.com](https://intercom.help/hugoffers/en/articles/2642240-%E6%B7%BB%E5%8A%A0%E6%B8%A0%E9%81%93)）的账号，password是渠道登录渠道平台的密码。保存后的信息随时可以modify进行更改。\ (带星号的为必填项) **Postback Format** 渠道会提供要他们的Postback格式，将他们给的postback里面，中括号里的参数替换成[HugOffers的系统对应参数](https://support.hugoffers.com/hugoffers-xiang-xi-shuo-ming-wen-dang/qu-dao-pian/guang-gao-zhu-qu-dao-can-shu-pei-zhi-shuo-ming)即可。
**Operate** 右边的 Operate 是对渠道可进行的操作。\ 点击Report可以看到这个渠道的报告。\ 在Modify在可以更改渠道信息。\ Offers可以看到这个渠道下的所有单子。\ 点击Account Block 可以停掉这个账户，这样渠道也不能够登陆了。\ 点击Offer Block 可以将这个渠道的所有offer关停。\ 点击Reset Password 可以重置他的密码。 第一部分填写是渠道的基础信息，这里的Email Address是我们渠道登录的系统（系统网址为：[域名.hugoffers.com](https://intercom.help/hugoffers/en/articles/2642240-%E6%B7%BB%E5%8A%A0%E6%B8%A0%E9%81%93)）的账号，password是渠道登录渠道平台的密码。保存后的信息随时可以modify进行更改。\ (带星号的为必填项) **Postback Format** 渠道会提供要他们的Postback格式，将他们给的postback里面，中括号里的参数替换成[HugOffers的系统对应参数](https://intercom.help/hugoffers/tech-and-integrations/tracking-and-postback-format)即可。
**Operate** 右边的 Operate 是对渠道可进行的操作。\ 点击Report可以看到这个渠道的报告。\ 在Modify在可以更改渠道信息。\ Offers可以看到这个渠道下的所有单子。\ 点击Account Block 可以停掉这个账户，这样渠道也不能够登陆了。\ 点击Offer Block 可以将这个渠道的所有offer关停。\ 点击Reset Password 可以重置他的密码。 # 渠道API Out说明文档 Hugoffers 对于渠道端提供了API-OUT功能。 当你在Affiliate界面添加了新的渠道，系统在API-OUT中会自动生成一条记录。你只需要配置一下信息，即可开启。
在你想要编辑的渠道API后面点击Edit选项，会看到以下表单 **Token**：点击Generate Token，系统将会自动随机生成独特标识。将此token交给渠道。注意，token生成后点击最下方的submit按钮才会保存。 **Offer Feed Url**：这个URL是让渠道拉单子的，你可以复制到自己的浏览器里回车来测试是否成功拉取到了单子的信息。每点一下Generate按钮，系统会自动随机生成一个token，token要交给渠道，填写进他们自己的系统中。token将填充进URL中。 **生成api** 当渠道在他们的系统发出请求后，如果你已经approve此api，HugOffers系统将会自动拉取到渠道的信息。 **Manage API** 你可以在列表中看到API的信息。 **Account Status**：指的是这个API-OUT的渠道状态 **API Out Status**：指的是这个渠道API的状态，包括Active和Block Active：意味着这个API是开启状态。 Block：意味着这个API是关闭的状态，在此状态下，渠道将不能通过API拉取单子的信息。 **Search** 你可以通过下列维度去搜索API-OUT
**Operate** 点击Inactive或者Active切换API开启或者关闭状态 点击Edit可以修改API信息 注释：如果你在Affiliate界面点击Account Block，系统会自动帮你把对应的API状态改为inactive。 提示: * 在生成token并提交API信息后，系统会自动发送API的详情和文档链（setting/document）到渠道的账户邮箱中。 * 你可以在开给渠道时，筛选国家、平台、单价等等。只过滤出这些条件的单子给渠道。 # 广告主渠道参数配置说明 **Affiliate/Publisher Tracking Parameters** 常用的参数有：\ \ **aff\_sub 表示渠道的唯一click id**\ **aff\_pub 表示渠道的子渠道id**\ **advertising\_id 表示 google advertising id**\ **idfa 表示iPhone的广告识别码idfa**\ **payout 表示conversion的收入**\ \ 完整参数表如下图 ![](https://downloads.intercomcdn.com/i/o/85425659/c740245691bc18cbb948e7ad/image.png) **Advertiser Tracking Parameters** 常用的有\ \ {click\_id} 表示传递给广告主的唯一的click id\ {aff\_id} 表示渠道id\ {aff\_pub} 表示渠道的子渠道id\ {advertising\_id} 表示google advertising id\ {idfa} 表示iphone的广告识别码 idfa\ {site\_id} 表示广告位的bundle id/app name/site name\ {data2} 表示广告主支付的payout\ {event} 表示event 名称\ \ 完整的参数表如下 ![](https://downloads.intercomcdn.com/i/o/85425990/5cf9ff8d94b2eef382ab955c/image.png) # 广告主渠道测试回传说明 **自己作为渠道让广告主测试回传** 1.配置好广告主的tracking url fomate和post back信息参数） 2..需要广告主提供测试offer 3.在自己系统找到offer，将offer的状态改为Test Mode（Offer details左下角可作更改，在此状态下，系统不会判定国家和平台）如果没有就添加对应的offer，开一个测试渠道（也可以自己创建个专门测试的渠道），generate 该渠道的tracking link，提供给广告主。 4.等待广告主测试成功后，检查conversion report是否接收到，如果接收到，表示测试成功，可以正式推广 \*\*如果未接收到，排查原因 1.看一下跳转是否正常 2.看参数配置是否正常，尤其是click id 3.看postback配置是否正常（自己提供的是否正确，以及广告主配置是否正确） 4.等待一段时间，可能会有延迟。延迟比较久的可能会有10分钟左右。 5.换一个offer，再按上面的流程再做一次测试 6.如果还是不成功，可以少量上量测试。 **作为广告主，给自己的渠道测试回传。** 1.配置渠道post back 2.告知渠道用哪个offer测试，并给他开这个offer的权限，让渠道提供测试链接 3.点击Tools/tracking test中的Conversion Test，输入offer的ID，点击空白处会自动拉取到平台、国家。在URL中输入渠道提供的测试链接。点击Search，生成跳转信息。点击send postback，底部将会出现是否success的字样（error：0 即没有错误）。 4.显示conversion Received 5.到Conversion Report中等待conversion report的数据 6.如果有了数据（如果pending需要置为Approved），向渠道确认有没有收到postback 如果没有收到： 1.看看我们系统渠道的postback参数有没有配对 2.等待一些时间，大约5-10分钟再查看一下 3.用conversion test 工具重新测试一遍 4.如果还是不能成功，联系我们的技术人员，协助测试。 # Offer篇 # Tracking Test功能说明 为了提高流量的转化率，运营人员常常需要通过tracking test对click url是否正常跳转到应用商店进行测试和统计分析，HugOffers为客户提供了Tracking test 相关功能。 **手动单个offer测试**\ \ 在Offer details 里面 Tracking Url旁边有一个便捷的测试按钮，点击之后系统会对该offer进行测试，并返回测试结果的重定向记录。
![](https://downloads.intercomcdn.com/i/o/86643625/e7905b818d5d29cf7a25ca2f/image.png) ![](https://downloads.intercomcdn.com/i/o/86643502/9fb0f4b73714d66810474ea2/image.png) **多次或者批量测试**\ \ 在广告主API IN配置页面有一个执行tracking test操作的选项，默认为空表示不测试，如果切换到test选项，系统会自动检测当前广告主API Feed里面的offer是否已经测试，如果没有测试，会自动测试一次并记录结果。每15分钟API更新一次，则更新一遍未测试offer的测试状态。
![](https://downloads.intercomcdn.com/i/o/86644511/10235f9aa484b12d4fe1e2c0/image.png) **测试结果统计分析**\ 功能路径 Offers/Tracking Test Results\ \ -支持按offer id，广告主，测试返回结果，跳转次数范围进行查询及统计筛选结果 ，点击测试结果details则显示测试结果原始记录。 ![](https://downloads.intercomcdn.com/i/o/86645827/08132a3a56c45068deb3703d/image.png) ![](https://downloads.intercomcdn.com/i/o/86646073/905240c9bad1d30def0c5b2c/image.png) ![](https://downloads.intercomcdn.com/i/o/86646548/cf6db716207149fca8c082c1/image.png) -测试状态有三种分别是：\ **Success**：表示该测试链接通过第三方正常跳转到google play或者appstore应用商店并且appid与推广appid一致\ **Wrong App**：表示该链接正常跳转到google play或者appstore应用商店，但是appid与推广的offer app id不一致\ **Failed**：表示无法通过第三方正常跳转到google play或者appstore应用商店 **在offer list对跳转次数，返回结果进行筛选** 方便运营对跳转次数，跳转结果进行筛选分析，进一步查看详情，导出excel，以及结合选中和filter结果进行批量修改offer status状态或者批量更新offer group permission等相关操作。 ![](https://downloads.intercomcdn.com/i/o/86648666/cfbc74bddd6ca8857266943c/image.png) **根据跳转次数添加自动标签**\ 功能路径 Rules/Label Rule\ \ 添加Label Rule-选择offer-选择Jump-设置Jump 范围-设置更新时间-设置自动化标签状态-Submit 提交成功 ![](https://downloads.intercomcdn.com/i/o/86649978/df00aa6086da54cd55c74885/image.png) ![](https://downloads.intercomcdn.com/i/o/86649810/b3f248c6669134ab39d86873/image.png) **Tips**\ -Tracking Test功能的原理是模拟用户点击tracking url，记录跳转结果进行分析，由于不同的广告平台对模拟的点击有各自的判定规则，所以测试结果无法达到完全的准确，仅供运营参考。 * 经常对某些广告平台的订单跳转进行测试以及统计分析，可以有效的评估该平台订单的推广的流量变现价值 * 如果有比较多失败的测试结果或者wrong app的结果，需要进一步排查原因，跟广告主及时进行沟通，避免流量的损失。 # Tracking错误代码说明 1.invalid aff\_id：无效的渠道 2.offer id invalid：无效的Offer ID或Offer 为暂停状态 3.offer not found：Offer跳转Smart Link失败，找不到对应的Offer 4.offer not found：Offer通过Traffic Redirect Rule跳转失败，没有找到对应的Offer 5.country mismatch：国家不匹配 6.tracking not exist：tracking不存在 7.platform mismatch：平台不匹配 8.offer over cap：点击对应的Offer超Cap # 高阶运营篇 # 标签功能使用说明 Hugoffers全方位支持自定义的标签功能，主要是为了通过标签对offer，广告主，和渠道进行分级，分类，分组标识，然后达到精细化管理以及高效运营的目的。\ \ 标签管理如下： **添加标签**：\ \ 在广告主账户/渠道/offer详情页里面，进行添加，删除\ \ 如果系统里已经添加过标签，则支持模糊搜索，直接添加。如果没有点右侧➕，先添加标签，再添加到该广告主标签列表里面。
![](https://downloads.intercomcdn.com/i/o/86621518/cca5d68c234daf67c9454196/image.png) ![](https://downloads.intercomcdn.com/i/o/86630701/3dd335d35bb9d10dd37c1de9/image.png) **查询标签**\ \ 在广告主列表，渠道列表，广告订单列表支持按标签进行模糊搜索查询以及筛选查询结果
![](https://downloads.intercomcdn.com/i/o/86630132/1fd9faa4b67d8b0dcb10e146/image.png) ![](https://downloads.intercomcdn.com/i/o/86631351/400b955c3b94ec71a15cf9bf/image.png) ![](https://downloads.intercomcdn.com/i/o/86631558/44283c00367a9a9bb1d3e9b4/image.png) **设置自动化标签**\ 功能路径 Rules/Label Rule\ \ 目前支持对符合某些规则的订单，广告主，渠道自动添加标签。标签命名根据设置的条件按格式命名，如topOffer\_revenue\_50\_1h\_today 表示该标签由系统按照top offer 当天收益前50进行标记，更新频率为每小时。 ![](https://downloads.intercomcdn.com/i/o/86632608/a2af6bc6f807705ffe29fd42/image.png) ![](https://downloads.intercomcdn.com/i/o/86632780/9ee9e02bb2cfa9f6b576d54a/image.png) 标签跟群组规则进行组合使用，达到对符合某些标签条件的offer，广告主对指定标签的渠道进行批量的权限管理。\ \ 功能路径 Rules/Group permission ![](https://downloads.intercomcdn.com/i/o/86634276/2a9020f2df0421e97e8d4b36/image.png) **标签进行统计分析及管理** **功能路径Tools/Label info** ![](https://downloads.intercomcdn.com/i/o/86632071/1ff87ef618b3d31ffa062a9b/image.png) ![](https://downloads.intercomcdn.com/i/o/86632272/e9fccd3e063b4998f270f5ac/image.png) ![](https://downloads.intercomcdn.com/i/o/86640378/7c79737331de6d5daef5efa7/image.png) **Tips** -标签使用过程中运营人员最好达成统一的管理标准，方便团队协作，如对渠道广告主的分级，标签名称的命名规则，同一个定义的标签用一个名字表示等； -为了提高便捷度和效率，在产品设计中会经常把标签和运营工具结合在一起使用，所以标签添加或者删除的时候可能会涉及到相关的操作被添加或者移除，需要谨慎操作。 # Group Permission使用说明 Group Permission是为了提高运营对广告订单的渠道权限进行灵活管理而设计的规则.判定规则及使用方法如下. 1\. Rules/group permission 可以直接在Rules/Group Permission添加规则,系统支持对多个维度进行添加,如offer id,appid,adv id,offer label,adv label ![](https://downloads.intercomcdn.com/i/o/89961231/d1858b22c8cfb578faf48937/image.png) 添加指定的值,多个值用逗号(,)隔开,然后进行权限操作,如有多个操作结果,如aff id同样用逗号隔开. ![](https://downloads.intercomcdn.com/i/o/89961398/b648fa9aa6cd2423dd8e9ff8/image.png) 备注:\ a. 同一个Group Permission可以并列添加多个维度的权限操作,也可以使用层级进行进行不同维度筛选,如adv id 100001的App id 为 com.zaful的offers进行批量权限管理.\ b. Order表示优先级,即Oder相对值较大的优先执行,如果有冲突,则仅执行Order较大的.如果没有冲突,只要状态为Active,符合规则条件的均会执行.\ c.同一个条件或者同一个结果支持多个值输入,不同的值用逗号(,) 隔开.
2\. Offer List-Operate\ \ 可以在offerlist,对筛选结果或者双击选中的offers进行批量权限操作,如图 ![](https://downloads.intercomcdn.com/i/o/89962146/6196492ba3c80b97db881c30/image.png) ![](https://downloads.intercomcdn.com/i/o/89962301/57954f63808a35b236f05272/image.png) 3\. Report-OverView Report-Operate\ ![](https://downloads.intercomcdn.com/i/o/89962334/35c3bc5a44496701618f8656/image.png) ![](https://downloads.intercomcdn.com/i/o/89962361/3ebfebf04db80cc5997ca84a/image.png) Tips:\ Group Permission是对符合某些规则的offer的渠道权限进行管理,其优势在于可以结合offer list,报表数据,标签等属性动态的便捷的管理offers 的权限,相对于offer details的access 单个offer权限管理,以及API IN 某个广告主的维度进行管理更加的灵活便捷.\ Group Permission还会结合[Pause Rule](https://intercom.help/hugoffers/en/articles/2556825-group-permission%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E) 对符合pause rule规则的渠道进行移除. # Traffic Pause Rule使用说明 HugOffers为客户提供自动监测CR转化率,对符合条件的offer或者渠道进行相应的自动化处理.具体适用方法和注意事项如下.\ \ **1.添加offer自动化暂停规则** ![](/files/-LsKYr6s6Tmf-P-hxj66) 支持按offer id,appid,adv id,aff id维度进行检测转化率,如果相应选项不需要进行判定,则用\*表示.\ Time Range表示检测的时间范围,单位为秒\ CR\[<=]表示小于等于该转化率会执行相应操作,该转化率没有百分号,所以需用小数点表示.\ CR\[>]表示转化率大于指定值会执行相应操作.\ Handler操作结果:\ （1）Send Mail:向触发此条件数据的Administrator发送邮件。 （2）Block Offer:对满足判定选项的Offer 执行 Block操作,该Offer状态会变为Block-Auto。 （3）Full Cap Offer:对满足判定选项的Offer 执行 Full Cap操作，如果此Offer的In Type=API，则此Offer 第二天会自动更新为Active状态。 （4）Send Mail and Pause Offer:对满足判定选项的Offer 执行Pause操作，如果此Offer的In Type=API，则此Offer 第二天会自动更新为Active状态；并且会向触发此条件的账号的Administrator发送邮件。 （5) Block Affiliate:对满足判定选项的Affiliate执行Block（关闭权限）操作，记录在Group Permission功能\[System Auto]Pause Affiliate By Pause Rule中。\ \ Create Date:该规则创建时间\ Status:该规则当前状态\ Operate:双击可以对规则进行修改,修改后需保存或者取消.\ 在operate中有Results，可以看到被这个规则停掉的具体详情，具体展示的信息是根据不同的Handler触发显示不同的数据。而且规则改变，触发此规则的历史记录也不会消失，客户可以搜索查看数据信息。 ![](https://downloads.intercomcdn.com/i/o/124344004/b4270c9686e48944daa3c9d5/0) Handler为Send Mail：显示触发规则的Offer和发送邮件的邮箱信息。 Handler为Block Offer：显示触发规则的Offer信息。 Handler为Full Cap Offer：显示触发规则的Offer信息。 Handler为Send Mail and Pause Offer:显示触发规则的Offer 和发送邮件的邮箱信息。 Handler为Block Affiliate：显示触发规则的Offer，和关闭权限的渠道信息。 Traffic Pause Rule使用举例说明 如下规则表示对系统所有offer每60秒点击达到6000的offer,如果其转化率等于0或者转化率大于10%,则该offer状态会置为block
![](https://downloads.intercomcdn.com/i/o/132166461/a58d604ba23514a97e4e4e69/image.png) 如下规则表示对于aff id为100的offer,在3600秒即每1小时,点击量达到10000,点击率低于等于0.1%或者转化率大于5%,则会把aff id 为100的渠道权限进行屏蔽.\
![](https://downloads.intercomcdn.com/i/o/132166692/7662ccd7aa7f6f3fd5e88a54/image.png) **2. 常见使用场景和运营tips**\ a. 需要对整体的转化率进行把控,但不建议对全部offer生效,最好针对某些广告主或者某些渠道设置相应的规则,以免影响到正常的offer.\ b. 点击量最好设置的比较大,时间范围设置的不宜过短或者过长,设置之后对结果进行跟进,根据实际的数据表现调整设置的点击阀值或者转化率范围.\ c. 如果是预防大点击则点击率需设置的较低,如果是预防高转化,则转化率设置的较高,可以对于不同的场景分拆成多个traffic pause rule.\ # Traffic Redirect Rule使用说明 HugOffers为客户提供流量自定义重定向规则配置,支持按广告主,渠道,订单,包名等维度进行配置,把符合筛选条件的流量重定向到指定的订单.具体使用方法如下.\ 1.系统自动屏蔽子渠道\ HugOffers 支持通过广告主API参数接收被屏蔽的子渠道,自动进行流量重定向处理.某些集成的广告主API支持传递屏蔽的子渠道参数,则系统会自动创建一个Traffic Redirect Rule,命名为 \[System Auto]Blacklist pub,接收广告主传递的信息,提取offer id,渠道id,子渠道ID,将符合条件的的子渠道流量重定向到default smartlink. ![](https://downloads.intercomcdn.com/i/o/91350348/b9a71b3a381eec1a56b1e41e/image.png) Tips:该功能默认打开,如需关闭,请将该规则状态置为Inactive即可,则系统不会对这些子渠道进行任何操作,即正常跳转. ![](https://downloads.intercomcdn.com/i/o/91350594/e54bc252cfce6d4b1ac8a749/image.png) 如果没有smartlink,该状态为Active的话,系统会拒绝符合条件的子渠道,但是并不会进行重定向.\ 2.创建traffic redirect rule 使用说明如下图
![](https://downloads.intercomcdn.com/i/o/91351454/de7f944ed7c864b05d95ad94/image.png) Rule Name:对该条规则进行命名,方便识别和记忆.\ Status:Active表示该规则生效,Inactive表示该规则不生效.默认操作为Active.\ Order:执行顺序.当多个traffic redirect Rule条件和执行结果冲突时,仅执行order较大者.\ Save:每次修改操作完后均需要保存.\ Conditions:重定向条件,支持按offer id,app id,adv id,country,aff id,aff pub的维度添加一个或多个筛选条件.\ white Aff Pub为执行结果,表示对符合筛选条件下的流量的指定子渠道添加百名单,即非白名单子渠道全部被重定向到指定的offer id.\ Redirect Offer id:指重定向后的offer id,即符合条件的流量会被重定向到该offer id.\ Value是指所选条件的值.\ Weight是指权重,当同一个筛选结果有两个或以上结果时,通过权重各自占比来进行分配.分配比例为相对值,例如若有两个值A,B,分配权重为A/(A+B),B/(A+B)\ Operate:操作结果保存或者取消\ 3.重定向规则适用常见运营场景如下\ a. 屏蔽某些子渠道的流量,如黑名单,白名单.\ b. 错误流量重定向,如smartlink,需先创建smartlink,再把流量重定向到smartlink即可.\ c.多个同国家同appid的offer之间流量进行聚合到某个指定的offerid.可先选中appid,输入appid,再选中国家,输入两位国家代码,再redirect到指定的offer.则全平台所有该国家该app的流量都会被重定向到指定的offer.\ d.其他需要对流量重定向的场景.\ 4\. 流量重定向注意事项\ a. 流量重定向不会改变渠道拉取到的offer详情,cap,单价等,所以如果有转化产生,渠道的收益会按重定向offer id来源的payout,cap进行统计成本,而广告主端的收益来源于redirect to的offer id,所以,使用该功能时,注意前后offer id的payin,payout,一般情况下,建议redirect to offer id的payin需高于原offer id的payout,否则可能会有亏损的风险.\ b.重定向后,如需查看响应offer的数据,可在响应报表勾选offer id from,输入原offer id,某人的数据是重定向后的offer id的数据. ![](https://downloads.intercomcdn.com/i/o/91425549/ba49b8a428f89527e0e4e22f/image.png) c.如果重定向后的offer id 状态为pause相关状态,则流量会有被浪费的风险,Error clicks 会提示offer id redirect invalid,因此运营人员在无需此功能时需把相应的规则置为Inactive或者删除. # Smartlink使用说明 Hugoffers系统有Smartlink功能，目的是为了最大限度的利用一些错误流量（单子暂停渠道还在送量、渠道送的点击国家平台不匹配）。Smartlink能自动将这部分错误流量导入正确的国家平台单子里。 ![](https://downloads.intercomcdn.com/i/o/144563381/a8a7af630696955f481a5150/image.png) 之后将需要这部分流量的单子添加进去就行。
![](https://downloads.intercomcdn.com/i/o/144563945/1b34e9369d100822a05d8c23/image.png) Smartlink还能跑上游的Smartlink单子，只需要将上游的单子加入到smartlink就行。 \ 关于上游Smartlink单子单价的设定也可以设置成百分比。**需在广告主Postback中加上广告主单价参数，例如**[**http://test.hopb0.com/notify/110040/?click\_id={click\_id}\&data2={广告主单价参数}**](http://test.hopb0.com/notify/110040/?click_id=%7Bclick_id%7D\&data2=%7B%E5%B9%BF%E5%91%8A%E4%B8%BB%E5%8D%95%E4%BB%B7%E5%8F%82%E6%95%B0%7D)\ 在单子详情处选择Price Mode改成Revenue Share既可。
![](https://downloads.intercomcdn.com/i/o/144565605/b5f8a8be9bc48c4eb4a370b8/image.png) # Impression配置说明 HugOffers目前支持Impression Tracking 一、整体流程 渠道通过impression\_link发送请求，系统获取并记录参数信息，再向广告主发送请求。 (一)Impression Tracking URL 根据Offer类型的不同，系统仍支持两种方式获取Impression Tracking URL。 1.手工录入 在创建Offer时输入Impression Tracking URL。 ![](https://hugoffers-support.intercom-attachments-7.com/i/o/145889469/0e53a1c2e8382ada304ee682/0) 2\. 通过API获取 通过API的方式获取，**需要广告主的API中包含Impression Link**。 完成对接后，系统拉取到包含Impression Link的Offer信息，在Offer Detail页面的Tracking URL中可以找到并编辑Impression Tracking URL。 ![](https://hugoffers-support.intercom-attachments-7.com/i/o/145889474/77aeca8dfd2a31fcc59ddc84/0) (二)Advertiser Impression URL Format 和Click URL一样，Imperssion URL也可以获取除了渠道ID和Offer ID以外的其他信息，只需要加上相应的参数即可。 在Advertisers找到Tracking Format，勾选Impression，配置Impression URL Format，系统会自动拼接在Impression Tracking URL的末尾。 ![](https://hugoffers-support.intercom-attachments-7.com/i/o/145889483/1695e540c819b9e0e147a117/0) (三)Affiliate Impression Tracking Hugoffers给渠道的Impression URL格式通常为： [https://](http://user_cancel/){[c](http://user_cancel/)id}[.hoimp0.com/imp?offer\_id=](http://user_cancel/){offer\_id}\&aff\_id={aff\_id}\&aff\_sub={click\_id}\&aff\_pub={source}\&advertising\_id={advertising\_id}\&idfa={idfa} 渠道通过API拉取Offer时，Offer Feed Url中提供了impression\_link字段。 ![](https://hugoffers-support.intercom-attachments-7.com/i/o/145889488/4875af58901d990ff7530ee9/0) ![](https://hugoffers-support.intercom-attachments-7.com/i/o/145889490/cc878aa5beb31355c587604d/0) (四)Overview统计数据显示 ![](https://hugoffers-support.intercom-attachments-7.com/i/o/145889496/35b487116b67497273d4459e/0) **总结如下** Advertiser 1. 提供impression链接或者API 接口支持impression 字段； 2. 配置impression tracking format。 Affiliates 1）按照offer格式直接获取该offer impression链接，或通过HugOffers API参数impression\_link获取； 2）按URL格式传递需要的参数。如： 在跳转测试中返回success，即代表系统成功接收。 ![](https://hugoffers-support.intercom-attachments-7.com/i/o/145889502/66150f74349474c558b45dc1/0) ChangeLog 建立者：Suzie 建立时间：2019年6月12日 # 系统内其他设置相关说明及常见QA # Basic Setup使用说明 **一、General Settings**
![](/files/-Lr8ZT-FDCTvItoQj93C) Network ID：子渠道的域名，不可修改。 Customer Application Domain：客户自己的域名（处于注册时的默认状态），不可修改。 Network Timezone：客户所处的时区（处于注册时的默认状态），可以修改。 修改之后会同步到如下位置： ![](https://downloads.intercomcdn.com/i/o/109452877/3b5de9d8cf295a4f8e9bdb79/1.png) Company Logo：公司Logo 未上传时，系统默认显示注册时的公司名称。 上传图片支持格式‘png’、‘jpg’、‘jpeg’、‘bmp’四种格式，大小限制50M。 需要更新Logo时，上传新Logo，系统会直接覆盖并替换原Logo。 Customize Title：自定义标题\ \ **二、Affiliate Panel Settings** ![](/files/-Lr8ZeboDJphR30EkK9_) Terms\&Conditions：决定Publisher Sign Up页面的Terms的有无。 未上传时，系统显示默认的Terms\&Conditions。 上传文件仅支持PDF格式，大小限制在50M。 需要替换新文件时，上传新文件，系统会直接覆盖原文件，并生效。 具体位置如下：在渠道的登录界面，点击Affiliate Sign Up。 Affiliate privacy Policy：客户自己的隐私政策（处于注册时的默认状态），支持上传和下载功能。 未上传时，系统显示默认的Privacy Policy。 上传文件仅支持PDF格式，大小限制在50M。 需要替换新文件时，上传新文件，系统会直接覆盖原文件，并生效。 上传修改之后，系统内所有的Privacy Policy会相对应的发生改变。\ \ Affiliate Sign Up Status：设置了两种情况，可以选择Active和Require Approval模式。 默认是Require Approval模式。 ![](https://downloads.intercomcdn.com/i/o/109454951/16e50d1fccb35d15dea4f9d5/3.png) Active模式下，渠道注册系统时，自动生效； Require Approval模式下，渠道注册后需要审核通过后才能使用。 Questions For Affiliate Sign Up：用户可以自定义Affiliate Sign Up 的问题。 ![](/files/-Lr8ZtOTPcwOu41tX78d) **三、Tracking Settings** ![](/files/-Lr8ZzCDXIEtD-3NX47i) Default Tracking Domain：Click 域名，不可以修改。 Network Global Postback URL：全局的回传URL，不可以修改。 Default KPI：对于API的单子，无KPI时显示默认KPI。 Custom Postback Server IP List：广告主的Postback Server IP。 以列表的形式显示，可以进行添加，修改和删除的操作。 Conversions out of Allowed Countries：对国家进行设置，接受非允许国家的转化，提供Pending和Approved两种模式。默认Pending。 Conversions Over Cap：对于超cap的转化，提供Pending和Approved两种模式。 **四、Support Email Settings**
![](/files/-Lr8_4frjYnHRIXwcwOg) SMTP Domain/IP Address ：填写SMTP信息 Port：端口号 SMTP User Name：邮箱地址 SMTP User Password：邮箱密码 “From” Email Name：邮件中显示的邮箱名称，一般是公司名称。 “From” Email Address：只展示，信息和SMTP User Name相同。不可修改 Test SMTP Server：测试按钮，填写上述信息后，点击按钮，会发送测试邮件，测试通过后才能保存。 以下为腾讯企业邮箱示例SMTP Domain/Port ![](/files/-Lr8_byvp8gGeSbcdbly) **如为腾讯企业邮箱**\ **SMTP Domain:smtp.exmail.qq.com**\ **Port:465** \ **如为阿里企业邮箱**\ **SMTP Domain:smtp.mxhichina.com**\ **Port:465** **五、Advance Setting** ![Advanced 设置界面](/files/-Lr8_DLg9fyHRPRWjBOj) 勾选Country Test Mode为将系统内所有Offer移除国家定向，勾选Platform Test Mode为将系统内所有Offer移除平台定向。Hugoffers默认会将非Offer设定国家和平台的流量屏蔽。 Automatic Block Server Traffic为自动屏蔽服务器发送的点击流量。 # Billing使用文档 与广告主结账\ 流程：**填写相关信息-->生成账单(Waiting Confirm)-->审阅并修改(Waiting pay)-->生成invoice 并发送-->广告主付款（Paid）-->处理逾期账单（OverDue）** **填写信息**\ 广告主与我们结算时，要保证在Company/Detail 中公司信息是填写正确的。Company/Payment Method 中可以添加信用卡和银行信息。（这些信息在生成invoice发票时会读取）
![](https://downloads.intercomcdn.com/i/o/100109199/3df66427581d771a91696860/image.png) ![](https://downloads.intercomcdn.com/i/o/100109614/bdf9add18cb74734391d84d1/image.png) ![](https://downloads.intercomcdn.com/i/o/100109672/eed10252fdd42afc8e428ceb/image.png) **生成账单**
![](https://downloads.intercomcdn.com/i/o/105429049/59a12676253da9b9511917e2/image.png) 创建账单时，系统中有Create Billing 和 Auto Billing Config。 **Create Billing**\ 点击创建billing，选择对应的广告主与日期，可以生成账单。**Create Billing**是针对于某一个广告主的手动创建，日期可以自行选择，点击Generate即可生成账单，此时可以调整数额，然后可以添加账单列，可以保存账单.\ \ Create Billing中，有Offer ID、Offer Name、Advertiser、Adv Offer ID、Total Conversion、Total Revenue（总收入）、Reduce（扣款）、Pending（未确认的金额）、Adjustment（调整的金额，优惠）、Final Revenue（**Final Revenue=Total Revenue-Reduce-pending+adjustment**） 、Remark（可以备注）和Operate **Auto Billing Config** 可以多选广告主并且可以一键生成，Min Amount可以限制最小金额，如果最后结算时广告主的Revenue未达到设定的最小金额，将不会创建。Auto Create Status可以开启（ON），用来之后自动定期生成账单，当Auto Create Status是ON状态时，下面选项是Auto Create Date。当Auto Create Status是OFF状态时，下面选项是Select Month，可以选取指定的月份。（若本月已经创建了账单，再次点击只会到下月生效）
![](https://downloads.intercomcdn.com/i/o/98386459/d0035117654bd18b2f49a6a0/image.png) ![](https://downloads.intercomcdn.com/i/o/98387739/81009230be7ac258ebaaf3e1/image.png) Select all 按钮可以一键全选。 \ \ **审阅并修改**\ 在顶部我们可以看到四个展示框，分别标明了等待确认（WAITING CONFIRM）、等待广告主支付（WAITING PAY）、已支付（PAID）、逾期金额（OVER DUE）。 ![](https://downloads.intercomcdn.com/i/o/98387921/50f72bcf7348d55cca121105/image.png) 我们可以根据账单的状态，广告主，日期三个维度点击右侧Search按钮进行筛选账单。 ![](https://downloads.intercomcdn.com/i/o/98414723/69eb6bd3b000720f12366b3a/image.png) 最上方可以进行search搜索，填入对应的值，即刻搜索 ![](https://downloads.intercomcdn.com/i/o/104048181/188cf19a6cc0c721b19ca11d/image.png) 最上方的Confirm All可以一键同意全部该广告主的账单信息（不可回退）\ 点击某一列的Edit，将会跳出关于这个offer的每个渠道的付费详情页Billing Affiliate Run Detail，点击Add Row将会添加一行为 -1 的数据列，这个数据列可以称为 “自己”.\ 在细分渠道的信息的界面，Validate Status指的是每一个渠道的账单信息是否被确认，Partial指的是默认为Pending，点击可以变为Confirm。点击Save Change则可保存信息。 ![](https://downloads.intercomcdn.com/i/o/98463601/ff265f2a50ba29f3e79f2f4f/image.png) 当这个offer只有部分渠道账单被确认了，则在这个offer会有Partial提示。 ![](https://downloads.intercomcdn.com/i/o/104040459/f73e35d641dd6e0bf8cdcdb2/image.png) 点击Modify Billing才生效。 **生成invoice发票**
![](https://downloads.intercomcdn.com/i/o/105214864/0d3be33cb691a395b4b30682/image.png) 点击Review，确认无误后可以点击Send Email，发到广告主的邮箱。 **广告主结账后** ![](https://downloads.intercomcdn.com/i/o/105400731/78f83e897420ef839e9c35d5/image.png) 确认付款后点击Done ![](https://downloads.intercomcdn.com/i/o/105400539/28e3930dd5c43486611577f3/image.png) **与渠道结账**\ 我们推荐先与广告主结账，这样可以直接同步广告主那里做出的修改。\ \ 流程：**填写相关信息-->生成账单(Waiting Send)-->审阅并修改-->发送等待渠道确认(Waiting Confirm)-->等待我们支付(Waiting Pay)-->我们付款（Paid）-->处理逾期账单（OverDue）**\ \ **完善信息**\ 我们与渠道结算时，要保证渠道已经事先在渠道系统 中填写正确了付款信息。这样在发票当中的信息可以正确显示。(登陆渠道系统后，在Account/My Account中编辑) ![](https://downloads.intercomcdn.com/i/o/100113908/d57a8edbb0f151fd7bf924fc/image.png) ![](https://downloads.intercomcdn.com/i/o/100113950/73f7af1f20114f26bc6fcb1e/image.png) **生成账单(Waiting Send)** 在顶部我们可以看到四个展示框，分别标明了等待发送账单（WAITING SEND）、等待渠道确认账单（WAITING CONFIRM）、等待我们支付（WAITING PAID）、已支付（PAID）、逾期金额（OVER DUE）。 ![](https://downloads.intercomcdn.com/i/o/98470851/666ffd0d30231a3066062408/image.png) **审阅并修改** 渠道的Billing中的Total Revenue=关于这个渠道的adv Final Revenue，这里渠道账单的Pending 会自动同步为广告主账单对应offer的Reduce，来保证不亏。 ![](https://downloads.intercomcdn.com/i/o/98469390/71ef7c166a32c7773cfb56c7/image.png) 这里的validate是指这个是否经过我们的确认，默认是CONFIRM,即经过了审核。\ 在remark上可以做注释。 # 常见QA之Offer篇 **Q：上游网盟的offer如何自动同步给下游** API IN或者设置Adv Aff Label功能可实现 **Q：暂停Offer在Group Permission中是否会影响给渠道下发offer的速度** 不会 **Q：Tracking Test Result界面是不是能整体看见单子的质量** 是的 可以和上游沟通完善单子质量 **Q：API拉取单子的Cap为0能正常推吗** 可以的，API单子Cap为0那给到下游的Cap默认是10W **手动创建单子Total Cap如何设置** Total Cap最好是Daily Cap\*30,会自动在推广30天后重置Total Cap **Q：Creatives的**Url如何填写 目前只支持在线图片的地址 **Q：Offer设置了Cap但是为什么渠道跑超了capcap** 原因是不同服务器直接有缓冲目前我们有2种模式 一种是比较精确的 目前还在调试中另一种是现在用的 有1分钟的缓冲时间 **Q：没有跳到第三方分析平台后续会有数据差异情况存在吗** 不会的 **Q：手动创建的单子如何控制投放时间 比如只投放一天** 可以在单子的Cap满了之后手动Block **Q：某个单子在Payout List里能看见Cap 但是无法编辑** 检查这个渠道是否有approve权限 **Q：手动创建的单子是否能测试跳转** 能 在Tracking旁边点击Test **Q：Offer List Operate操作如何勾选offer** 双击某个Offer **Q：手动创建单子如何在offer list删除** 目前系统不支持删除单子,可以手动Block **Q：手动创建单子Tracking是否需要修改参数** 假设广告主参数模板已经设置好了则不需要修改参数，系统会自动替换 **Q：Offer还有剩余的预算，但渠道收不到回传** 检查Total Cap是否满了，目前Monthly Cap统计的是Total Cap **Q：已经通过group permission批给渠道的offer如何Forbidden** 可以新建一个Order权重更高的forbidden **Q：campaign下线了之后，后续产生的转化还会给渠道回传吗** 会的 可以设置一个TTI 的Rules 从点击到产生转化的时间大于多少就不给渠道回传 **Q：手动创建单子时素材的尺寸要求是什么** 目前没有尺寸限制 **Q：创建offer时选择最小系统版本 会有过滤功能么** 不会 **Q：Offer list可以批量Block单子吗** 可以 operate筛选出的offer可以批量block **Q：有没有给几十个offer批量打标签的地方** offer标签目前有Jump和Top都是动态的 **Q：把之前Pause Rule的规则删除，系统会自动释放之前被规则限制的单子吗在Traffic Redirect rule系统会自动生成一条Pause rule的规则 需要将这条规则删除** **Q：API out按照ECPC排序是几天的**\ 近7天 **Q：提示你有几个单子需要approve**\ 在offer list下面的offer approve直接同意或者拒绝就OK \ \ **Q：拉取单子后 为什么offer name和preview link没有和API同步**\ 是根据APP ID 来拉取的 广告主开启了自动重命名，系统会自动根据app id拉取的APP Name加上系统、类型、国家命名\ \ **Q：单子详情Group permission怎么看是什么时候创建的**\ 用offer id 在group permission处搜索 create time可以看见 ![](https://downloads.intercomcdn.com/i/o/132377233/c8bde41a5b9b56ce70d80abe/%E6%8E%A8%E8%8D%90%E6%B3%A8%E5%86%8C%E7%94%A8%E6%88%B7.jpg) [点击了解更多返利详情](https://intercom.help/hugoffers/en/articles/3114882-customer-referral) # 常见QA之系统篇 **Q：Label Info与Label Rule的区别** Label Info只显示系统中所有Label的信息 **Q：CR触发规则Traffic Pause Rule未拉黑渠道** 可能设置时间区间过短 **Q：Order优先级** Order数值越高,优先级越高，假设一个权重为50的forbidden一个权重为40的approve 其中有冲突的话 例如forbidden了一个渠道 又approve了他 那就会以权重高的为准 **Q：在Overview报表中上游给的Cap是Remaining Cap+Total Conversion吗** 是的 **Q：导数据时提示请等待在哪里看** 右上角笑脸图标右侧可以 **Q：Need Approve与Private区别是什么** Need Approve 的单子所有的渠道能看到但是需要申请通过才能推 Private只能是Access开了的那几个渠道看到并且推 **Q：Cap run和Cap Today是什么意思** Cap Run是指目前跑的Cap，Cap Today是指Daily Cap **Q：EPC是指什么** 单次点击带来的收益即revenue/click **Q：测试回传z在哪里** Tools-Tracking Test-Conversion test **Q：扣量比例设置** 在Conversion Rule设置 Pending Percent为扣量比例 **Q：Inherit是什么意思** 是指API的offer继承API-IN 配置的权限 **Q：测试跳转是No Third Part是指** 是指没有跳转至第三方分析平台类似于异步跳转 **Q：手动将状态为Pause的单子置为Active，状态会不会随API变化** 会的 **Q：Block和Pause的区别** 对于API的单子 Pause是广告主那边暂停了 手动将单子Block之后单子状态不会随API更新自动active需要重新手动置为active **Q：某单子已设置CPE回传，Install转化数据在哪看** Event Report Event名称为空的为安装 **Q：Dailycap为-1是不是不限制cap的意思** 是的 但还是以API里的Cap为准(API-IN未勾选第二条) **Q：Event Report报表数据(Open)比ConversionReport数据（Install）多** 重复打开回传Event **Q：广告主要求上传App Name，但是目前传不了是否有方案解决** 目前能写死 **Q：Test Mode在哪里开** 在offer详情 左下角的位置 Test Mode(Ignore country targeting)设置为Yes **Q：给渠道发送账单失败**\ 需要在Home-Setting-Basic SetUp设置邮箱信息 SMTP Domain/IP Address Port:填写SMTP信息，SMTP User Name:用户名。SMTP User Password:密码。默认展示\*。“From” Email Name:公司名称。 **Q：API对接文档地址** **Q：aff\_pub这个参数是只能收到渠道ID还是所有层级的渠道ID都能收到** 都能收到，如果需要广告主只看到渠道ID，只传aff\_id这个参数 **Q：如果上游回传了event，平台是否能自动生成相应报表** 在Event Report可以查看 **Q：系统单子默认参数requirement\_traffic:都是 non-incent** 是的 **Q：未设置某一渠道跑特定单子 为什么还能送量** 在Group permission那里检查一下 **Q：给渠道传KPI的参数是什么** performance\_criteria **Q：API Daily cap和Default Daily cap是什么意思** API是广告主feed url 里的cap Default是手动设置的 **Q：Dashboard和Overview报表不一致** 目前dashboard报表的数据会和Overview报表存在小的差异可能是因为缓存造成的 **Q：手动暂停了active的单子，那15分钟更新后，这个offer的状态是active的还是pause的** 根据API 里面的情况更新 **Q：如何将一周内Top 100的单子开给某个渠道** 先Home-Rules-Label Rule设置一个offer label 然后在group permission中开渠道 **Q：转化是先给渠道发再记录在我们的报表上吗** 处理是同时的， 但后台看到的数据要稍微晚一点 **Q：Duplicated是什么** 是否接收重复clickid的回传 **Q：做traffic redirect rule时 redirect offer id是否必填** 最好填写smartlink中的单子 **Q：首页invalid offer id 上的click是怎么造成的** 1.一般是offer 状态停了，让渠道请求频率最好为15分钟每次\ 2.错误的量（非指定的国家和平台） **Q：是否支持系统拉取API黑白名单** 可以 需API IN config里配置相应参数 **Q：在offer中把Inherit渠道删除和把某个渠道forbidden有何区别** Forbidden有Order权重如果一个渠道被approve 了 同时又被forbidden了 那就以权重大的为准 **Q：Inherit和group permission的权重谁大** group permission有approve和forbidden 这个和approve没有冲突但是和forbidden有forbidden权重大 **Q：整体设置子渠道黑白名单如何设置** Rules-Traffic redirect rule
![](https://downloads.intercomcdn.com/i/o/132378165/622c758c71c91b680f3f1a07/%E6%8E%A8%E8%8D%90%E6%B3%A8%E5%86%8C%E7%94%A8%E6%88%B7.jpg) [点击了解更多返利详情](https://intercom.help/hugoffers/en/articles/3114882-customer-referral) # 常见QA之账单篇 **Q：月底为什么没法自动创建账单** \ 检查Adv Aff billing自动创建功能是否正常开启 **Q：给渠道扣款怎么操作**\ 可以在广告主的billing那里 把扣款金额填上 比如说这个单子全部被广告主扣了 那reduce就填广告主的扣款金额 系统会自动生成渠道的扣款金额 **Q：账单Reduce无法输入信息**\ 广告主账单生成得保存后点击Edit即可编辑
![](https://downloads.intercomcdn.com/i/o/132378014/fb3336a4005c5084bfff17f7/%E6%8E%A8%E8%8D%90%E6%B3%A8%E5%86%8C%E7%94%A8%E6%88%B7.jpg) [点击了解更多返利详情](https://intercom.help/hugoffers/en/articles/3114882-customer-referral) # 常见QA之渠道篇 **Q：渠道后台为什么不能看见Need Approve 单子** 检查是否未给渠道生成Toke API-Out是否有做过滤操作 **Q：GO TO AFFILIATE PANEL切换渠道号为什么看不到相应的渠道** 需要对应的渠道管理员才能进入 **Q：渠道问卷信息填写地址在哪** Cid.Hugoffers.com **Q：如何批量设置渠道Cap** API-IN可以设置渠道Cap数量及百分比 **渠道注册邮箱如何修改** 渠道界面Email Reset **Q：筛选某渠道单子后进行Block操作是针对单子Block还是针对渠道，如果想针对渠道怎么操作** 针对单子，针对渠道可以用Group Permission功能 **Q：对方作为渠道，能不能从本地请求我们的服务器** 可以跨域请求 **Q：渠道分多个广告位，能实现渠道再分Pub吗** 能，Aff\_pub参数为子渠道参数 **Q：想让渠道传Device id用什么参数** android\_id **Q：如何检查渠道有多少没有上传device id** 在conversion report筛选Device Info-Android id **Q：平台可以按照国家给渠道放单子吗** API-OUT里能筛选国家 **Q：在渠道的Offer库中点击pause 是对渠道pause还是offer**\ 对渠道 ![](https://downloads.intercomcdn.com/i/o/132377544/c8e462d76e89cf1146791667/%E6%8E%A8%E8%8D%90%E6%B3%A8%E5%86%8C%E7%94%A8%E6%88%B7.jpg) [点击了解更多返利详情](https://intercom.help/hugoffers/en/articles/3114882-customer-referral) # 常见QA之测试篇 **Q：下游测试需要Postback的点击参数在哪里看** 在conversion Report处勾选Aff\_sub参数 **Q：根据运营技巧创建测试offer测试不成功是什么原因** 目前测试offer的tracking存在问题建议拿稳定单子的Tracking链接替换 **Q：Testing link -conversion Test 可以测试订阅的单子吗** 订阅的单子测试的不准 很容易跳到smartlink里面去 **Q：单子跳转详情在哪里可以看到** 在Tracking Test Result处 **Q：测Offer的跳转连通率频率是多少** 开启了Test功能的广告主在拉取offer时会测试一次,失败会重复测试2次 **Q：单子跳转次数为什么没有测试** 检查API IN 上次拉取时间及Test功能是否开启 ![](https://downloads.intercomcdn.com/i/o/132377008/bafcfe97ffde597c4c8bceda/%E6%8E%A8%E8%8D%90%E6%B3%A8%E5%86%8C%E7%94%A8%E6%88%B7.jpg) [点击了解更多返利详情](https://intercom.help/hugoffers/en/articles/3114882-customer-referral) # 常见QA之权限篇 **Q：新加运营账户如何添加最高权限** 新建所有权限模板后添加 Ad Managers-Auth Template-System Customer勾选全部权限 **Q：Ad Manager能否在Dashboard处只看见相应的广告主渠道数据** 可以 Ad Managers-Ad Managers List-Modify Auth处勾选对应权限 **Q：Conversion Rule不生效** 需咨询产品运营人员开启权限 ![](https://downloads.intercomcdn.com/i/o/132376108/3d697b2c611bdb7d70865efb/%E6%8E%A8%E8%8D%90%E6%B3%A8%E5%86%8C%E7%94%A8%E6%88%B7.jpg) \ [点击了解更多返利详情](https://intercom.help/hugoffers/en/articles/3114882-customer-referral) # 常见QA之广告主篇 **Q：API广告主端如何设置IP白名单(比如offerslook fuseclick)** 输入0.0.0.0 **Q：广告主渠道Label如何配置** 在Adv Aff详情处 **Q：广告主子渠道黑名单设置用不用带s** 需要 **Q：Postback中的括号不一样有影响吗** \[]和{}没有区别 **Q：上游给了质量报告，怎么看是哪个渠道跑的** s前面代表渠道ID，后面代表渠道的渠道ID **Q：对接使用Hugoffers的客户API怎么选择** 选择Hugoffers **Q：广告主单子全部显示关闭** 先检查HomeIntegration-API-IN Integration-API Feed打开是否有单子 **Q：Appsflyer Adjust等第三方平台如何对接** 参考在线文档-常见的第三方平台对接流程 **Q：给广告主的Postback需要添加一个payout动态回调价格怎么添加** \&data2={payout} **Q：广告主的回调和渠道的回调都已经设置了payout，那后台记录的收入是添加offer时候添加的价格还是payout的价格** Price Mode为Fixed Payout，就是固定的；Revenue Share就是按广告主回传的和你设置的比例来计算的 **Q：双向合作的客户怎么互斥** 在group permission建立一个order权重较大的forbidden或者在API Out中Exclude Advertiser选中相应广告主 **Q：新建广告主为什么出现user\_agent参数** 是由于Google浏览器自动填充了用户名然后关联到了这个输入框 正常删除 **Q：Api-in显示time out是什么意思呢？**\ status 显示 over due是因为广告主API之前能正常拉取，但由于某些原因拉取超时 ![](https://downloads.intercomcdn.com/i/o/132377436/c262a30488f8baed2c7f0e4b/%E6%8E%A8%E8%8D%90%E6%B3%A8%E5%86%8C%E7%94%A8%E6%88%B7.jpg) [点击了解更多返利详情](https://intercom.help/hugoffers/en/articles/3114882-customer-referral) # Hugoffers Reference Guide # Baisc # Starting an Affiliate Program — Step-by-Step Guide **Who is this Guide for:** New Brands or Agencies building out their first affiliate program on Hugoffers. This guide will give you a rough guide on how to use Hugoffers. **1、When you register your system, you will receive an email from hugoffers and then receive your 30-days free trial.The details are** **Login Panel**: **Username**: **Password**: Your registered password **Your Publishers/Affiliates' Login Panel**: test.hugoffers.com **Advertiser Conversion Postback Prefix**: click id} **Advertiser Event Postback Prefix**: click id}\&event=event\_name **Tracking Format(Affiliate)**: click\_id}\&aff\_pub={affiliate pub id}\&advertising\_id={advertising\_id}\&idfa={idfa} **Impression Format(Affiliate)**: click\_id}\&aff\_pub={affiliate pub id}\&advertising\_id={advertising\_id}\&idfa={idfa} **API Offer Feed URL**: **2、Here is how it will look when you log into Hugoffers for the first time:** ![Hugoffers Dashbord Page](/files/-Lso_ufSNRy4sTRhocH5) **3、To add access to other team members for setup: Go to Home>Ad Managers>Ad Managers List>Add Account** ![Add User Account](/files/-Lsodb44mVJhzZUCTrUT) **4、You will need to set up your brand as an Advertiser: Home>Advertiser > Add** ![Add Advertiser](/files/-Lsoe6jMstWXa2JzIIiZ) The most important step in this step is to set up **Advertiser Tracking Format** and **Postback**. **Advertiser Tracking Format** If you set it like this, then this advertiser will have this format after all the offer (API\&Manual) tracking.For example, if the tracking you created manually is \*\* you created it, it will automatically become **.** ![Advertiser tracking format](/files/-Lsp9L0oq29UHwM0Jc1j) **Postback** **Postback** Will be automatically generated when you finish tracking format setting.And you can give it to Advertiser,It will be like ** click id}** ![Postback ](/files/-LspCIG_5x2khUL4ioIm) **5、 Set up your first offer: Offers>Create Offer** ![Create offer](/files/-LspEINldPJDtpXb-fjt) Some things to note: **App ID**：package name for Android or App id for iOS **Adv Offer ID**：The offer id for Advertiser,The same advertiser cannot have the same id **Advertiser**：Advertiser for this offer **Incent Type**：Traffic type **Preview Url**：The store URL, so the affiliate can quickly see which page the tracking link will be sending traffic towards **Tracking Url**：This is a link generated inside your offers that when clicked/tapped by a user, will start tracking them for a period of time. When that user completes the Conversion action, the advertisers system will detect that a conversion has happened, and then send that Conversion information to your Everflow reporting. The preferred setup for sending the successful conversion to your reporting is through a Postback **Cap\&Price** **Caps**：Caps are set inside of Offers, and are the maximum allowed actions per period of time. This is most commonly used to manage your advertiser budgets by doing the following setup: Setting Daily Conversion Cap to 100/Day. As soon as Hugoffers records the 100 conversions set by the cap, the link will deactivate (going to your Fail Traffic offers if you've set them up, or a blank page). This is an essential feature for keeping your budgets in line with your advertisers expectations. Please note: If you're working with strict budgets, make sure to be extra conservative in your Cap setup. When a cap is hit, the clicks stop reaching your offer, but the prior clicks delivered before hitting cap can still become conversions. Hitting caps stops future clicks from reaching the advertiser, but doesn't block the conversions themselves. **Payin**：What the advertiser is paying you for a successful conversion. **Default Payout**：What you're paying your Publishers for a successful conversion. **Country Groups**：You will put any requirements around what user traffic should be accepted to reach your website. If the user traffic doesn’t meet these requirements, it will either send that user to a dead page, or to your Fail Traffic setup (explained below) For example you only ship to US & UK, so you will set those targeting requirements to prevent any potential order fraud from other countries. **Restrictions**：You can put the KPI of this offer, KPIs are Key Performance Indicators based on Events and associated values. **Access**：Public will mean any of your affiliates can see the offer and sending traffic,private will only show to affiliate you’ve selected for the offer,Need Approval mean can see the offer by application passed. **Generate Tracking URL**：Generate affiliate tracking url or testing tracking url for advertiser. **6、API IN Integration** API IN Integration is Hugoffers's proprietary self-serve API integration solution. API IN Integration allows you full control over adding and customizing your integrations with demand partners.There are now more than [300 API Templates](https://www.hugoffers.com/support) on hugoffers and if you want to docking others just share their documents and its **Free**. ![API IN Integration Setting](/files/-Lu_oC0JduN0Yqd8ihVK) ![API IN Integration Setting](/files/-Lu_oMYqklRhalSggswL) ![API IN Integration Setting](/files/-Lu_oS6vtDqMp_glhj0t) **API Name：**The API Templates name on Hugoffers **Advertiser：**The advertiser for this API **API Status：**The status for this API **Default Payout：**All offers default payout for this advertisers **Default Daily Cap：**All offers daily cap for this advertisers **Global Name：**All offers conversion flow for this advertisers **Event Name：**Event name for this advertiser **Insert Limit：**All Offers Insert limit for this advertiser **Excute Interval：**API Update interval **Excute Tracking Test：**Testing offers tracking jumps **Url Template：**API Url templates **Result：**Final API url result **Parameters：**API Url Parameters,If the number of advertiser single pages is limited and there is no page = in the Url Template, you can add & page = {page \[1-10]} after one of the parameters. If there is a page parameter, fill the page parameter with {page \[1 -10]} pulls advertisers 1 to 10 pages offer. After filling in, put the result link into the browser to see if there is any offer information (if {page \[1-10]} is filled in, the browser cannot parse but the Hugoffers system will pull it), and the system will pull the offer after 15 minutes Into the offer list. **Permission：**Approve the whole advertiser's offer for affilitests/publishers **Filter：**Filter offers by conditions **7、Setting up your Affiliates/Publisher**
For signing up affiliates, you have two main options: 1. You can manually create the affiliate accounts for them 2. You can link potential affiliates to your affiliate signup form **a.** **Manual Affiliate Setups:** Affiliates > Add Complete all of their information and set the right postback. ![Affiliate postback](/files/-LspOIWkARFwfA6ztSBj) **b.** **Affiliate Sign Up Page** Send the registered address to the affiliate. You can find it on the Hugoffers registration email.Then approve it on the affiliate page. ![Affiliate registration page](/files/-LspQQAAUXNVTMpXEHrS) **8、Generate Affiliate API Feed url\&Tracking Links Setting** **Generate Affiliate API Feed url** Now that you have affiliates in your system they will need tracking links. They can either login to their affiliate dashboard to get the tracking links for the offers, or you can generate the API Url links for them. To generate their link: Integration > API-Out Integration > Select Affiliate > Edit > Generate Token > Click the Copy button > Submit: ![Affiliate API Feed Url](/files/-LspctaQk3I4L_6Z4rvr) **Tracking Links Setting** **Tracking Format** can set all offer tracking formats for your individual Affiliate. ![Set tracking format for your affiliate](/files/-LspUCeVUVTHXeamQw1C) **9、Conversion Testing for Advertiser and Affiliate** **Advertiser\&Affiliate Conversion testing needs to be done after Postback is set correctly! ! !** **Advertiser Conversion Test** In the Home-Offers-Offer List, find an advertiser's offer and click Offer to change the Test mode to Yes in the lower left corner. Then click Generate Tracking URL - Test Link give it to the advertiser. Then check if you receive an advertiser's return at the Home-Reports-Conversion Report. ![Change Test Mode To Yes](/files/-LspYLxUsMjH5nhfolIi) ![Generate Test Link](/files/-LspYXu3rs3GzhD5CCom) **Affiliate Conversion Test** Authorize the Offer to the affiliate and enter the Offer ID and the test link the affiliate give in the Home-Tools-Tests-Conversion Test. Then click send postback button and confirm with the affiliate whether to receive the conversion. ![Send test conversion](/files/-Lsp_5dNUXVpvIz9AeNr) # Add New User Account This tutorial explains how to add a new user account and configure permissions. **Navigate to User Management** Go to **Ad Managers > Ad Managers List > Add Account**. ![Add User Account](/files/-LsthLIUW1ETaQ-kzHaQ) #### **Define User Roles and Permissions** **Roles** determine a user’s access to platform sections. Available roles: * **Administrator**: Full system access. * **AM (Advertisers Manager)**: Manages advertisers and offers. * **PM (Publisher/Affiliate Manager)**: Manages affiliates and offers. * **Finance\&Sales**: Access to billing and sales reports. #### **Configure Data Permissions** The table below outlines permissions for each role across platform modules: | | Administrator | AM | PM | AM\&PM | Finance\&Sales | | ----------- | ------------- | ------------------------------- | ------------------------------ | ---------------------------------------------------------------- | -------------- | | Dashboard | All | Advertiser\&Offer for the AM | Advertiser\&Offer for the PM | Determine AM\&PM account permissions | All | | Advertiser | All | Advertiser for the AM | All | Advertiser for the AM | All | | Affiliate | All | All | Affiliate for the PM | Affiliate for the PM | All | | Report | All | Advertiser\&Offer for the AM | Advertiser\&Offer for the PM | Determine AM\&PM account permissions,AM is displayed by default | All | | Adv Billing | All | Advertiser‘s Billing for the AM | All | Advertiser‘s Billing for the AM | All | | Aff Billing | All | All | Affiliate‘s Billing for the PM | Affiliate‘s Billing for the PM | All | **Add Sub Accounts** 1. Click **Modify** on the manager’s account. 2. Select **Add Sub Account**. 3. Sub accounts inherit data permissions from their parent manager.

Add Sub Accounts

#### **Step 5: Set Up Auth Templates** 1. Go to **Ad Managers > Auth Template > Add > Customer**. 2. Customize permissions for roles (e.g., AM, PM, Finance\&Sales). 3. Save the template to apply standardized permissions. ![Custom permission template](/files/-LstjM8ITJJjE-xxXrTt) # Add New Advertiser This tutorial explains how to create an advertiser account and configure tracking parameters. #### **Step 1: Create an Advertiser** 1. Navigate to **Home > Advertisers > Add**. 2. Fill in basic information: * **Email**: Login account for the advertiser platform. * **Password**: Login password for the advertiser platform. ![Advertiser Account Details](/files/-LstmXOgiUh8p8ovavHQ) **Account Details：** The first part is the basic information of the advertiser. The Email Address here is the login system account of the advertiser platform that we developed later. The password is the password of the advertiser to log in to the advertiser platform. The saved information can be modified at any time. The Administrator here refers to who is the administrator who manages this advertiser (optional Ad Manager) ![Advertiser Account Manager](/files/-LstmvXMPJz_G6zkl9pt) **Mail List：**You can fill in multiple mailboxes for each option, separated by commas, you can send a mail list when mail settings. **Adv Labels：**Set a label for the advertiser, which can be used in Rules-Group Permission. ![Adv Labels and Mail List](/files/-Lstn5pjcSPA4rdmAH85) #### **Step 2: Configure Tracking Format** 1. **Parameter Replacement**: * Obtain the advertiser's tracking format/documentation. * Replace parameters with [HugOffers system equivalents](https://www.yuque.com/hugoffers/support/parameters-for-integration). * Example: * Advertiser format: \&adv\_click\_id={click\_id}\&pub\_id={aff\_pub} ![Advertiser tracking format](/files/-Lsp9L0oq29UHwM0Jc1j) **Postback：**Will be automatically generated when you finish tracking format setting.And you can give it to Advertiser,It will be like ** click id}** ![Advertiser Postback ](/files/-LspCIG_5x2khUL4ioIm) #### **Step 3: Manage Advertiser Operations** 1. **Operate Options**: * **Report**: View advertiser performance reports. * **Modify**: Update advertiser details. * **Offers**: Access all offers under this advertiser. * **Account Block**: Disable advertiser login. * **Offer Block**: Disable all offers for this advertiser. * **Reset Password**: Reset the advertiser's password. ![Operate](/files/-LstoNGlJjG7jodWmAYb) Note: If you click “Account Block” on the Advertiser interface, the HugOffers system will automatically set the corresponding API status to Inactive. # Advertiser API IN Guide HugOffers enables automated offer integration via API, where API-IN is designed for advertiser API connections. The system provides **500+ prebuilt API templates** for immediate use. To integrate with an advertiser's API, you need: * API documentation * Complete API URL * Parameter specifications ### **Adding an API Integration** For API-supported advertisers: 1. Create an advertiser account. 2. Navigate to **Integration > API-IN Integration**. 3. Click **Add** to create a new integration. #### **General Settings**
* **API Name**: Search for the advertiser/platform name. If unavailable, contact HugOffers support to add a template. * **Advertiser**: Select the advertiser (must be [pre-added](https://www.yuque.com/hugoffers/support/how-to-create-an-advertiser)). * **API Status**: Default is *Active*. * **Default Payout(%)**: Base payout percentage for all offers under this API (applies when offer authorization mode is *inherit*). * **Default Daily Cap**: Expected daily conversions. `-1` means no limit. **Daily Cap Options** a. **Use \**, if not exist, use \\ b. **Ignore \** and use \\ c. **If \ equals 0 or not exist**, use \ * **Goal Name**: Select type (CPI/CPA/CPS/CPR/CPE). * **Insert Limit**: Maximum number of offers to pull via API. #### **Generate URL** HugOffers auto-generates a **URL Template** based on the selected API. Fill in parameters (refer to the advertiser's API docs) to generate **Result URLs**.
**Note**: * Use `&page={page[1-10]}` if the API limits results per page but lacks pagination parameters. * `{page[1-10]` fetches pages 1-10 (links are system-only and not browser-testable). #### **Permissions** Configure default authorized affiliates, caps, and payout rules. Offers pulled via this API will auto-authorize these affiliates.
* **Default Cap Percent**: Highest priority. Affiliate cap = `Default Cap Percent × Default Daily Cap` ①. If the advertiser's cap is `0`, affiliate cap = `Default Daily Cap` ②.
#### **Filters** Add filters to screen offers by: * Country * Platform * Incentive type * App category * Payout (open intervals, non-inclusive).
Click **Submit** to save. #### **View & Manage Integrations** * **Counts**: Number of offers pulled in the last API fetch. * **Last Execute Date**: Timestamp of the last API pull. * **Search**: Filter by API name, advertiser, affiliate, or status. **Operate Options** * **Edit**: Modify API settings. * **Inactive/Active**: Toggle API status. * **Delete**: Remove the API integration. **Important**: Clicking "Account Block" on the Advertiser interface sets the API status to *Inactive*. # Offer Setup Guide This guide will walk you through the process for setting up your first Offers in the Hugoffers platform. **What is an offer?** An Offer is a product, product line, or app from which you would like to track performance and Partner earnings. **Step 1** Please note that your Customer Success Manager will walk you through the creation of your first Offer during your onboarding stage. To create a new Offer, *we recommend that you start by duplicating an existing successful Offer*. To duplicate an Offer, go to Offers - Offer list > Find an existing Offer - Scroll to right and click on the three vertical dots Create Similar. ![Create Similar Offer](/files/-Lt3mS3QCr1RiuavNdZA) **Step 2** When you duplicate an offer,You will start edit offer details ![Edit offer details](/files/-Lt3mtSkQd7xLy_geYPE) If you prefer to create an Offer from scratch instead of duplicating an existing Offer, click Offers > Create Offer. **Step 3** Complete each of the following steps to properly configure your Offer: ![Create Offer step by step](/files/-Lt3okwPZLBGBJ2GxFrL) **APP ID**：Package Name for Android \&App ID for iOS The App details will be automatically generated after click App Promotion > Go! **Adv Offer ID**：The same advertiser offer id cannot be the same **Targeting\&Carrier** Targeting is where you set requirements for which User’s Clicks should be accepted for the Offer. Clicks that don’t match with the traffic settings will show up as Invalid Clicks, and will be sent to Fail Traffic (if enabled), or to an empty page (if Fail Traffic is disabled). The Targeting rules are based on the user's Device and location, while Language is detected from the user's browser. In the TARGETING tab, you can define targeting rules, including *Device Characteristics* (Platform, Device Type, Browser, OS Version, Language) and *Geolocation* (Country, Region, City, Carrier). **Cap\&Payin** Set Name, Revenue Type, Amount, Payout Type, Amount, Fire Affiliate Postback, and any Events.For more details **Caps**：Sets limits on traffic volume according to your budgets or other necessary considerations. Any attempted traffic delivered after a cap has been reached, will become an Invalid Click and be sent to Fail Traffic (if enabled). **Payin**：Define your revenue and payout associated with both the base Conversion event (product purchase, App install, lead signup, etc.) and any associated Event's Conversion (Up-sell purchase, In-App Purchase, deposit, etc.) **Payout**：What will be paid to the Partner (Accounts Payable) **Tracking Url**：This is a link generated inside your offers that when clicked/tapped by a user, will start tracking them for a period of time. When that user completes the Conversion action, the advertisers system will detect that a conversion has happened, and then send that Conversion information to your Everflow reporting. The preferred setup for sending the successful conversion to your reporting is through a Postback, but desktop channels often still use cookie tracking. Recent changes by Apple, and other companies, have made cookie tracking much more difficult, which is why we always recommend postback setups when possible. **Traffic Requirement** Traffic Requirement provides advanced filtering by allowing you to set up rules for allowing or denying access to an Offer based on multiple received variables **Network**：Including 2G 3G 4G 5G Wifi **Incent**：For Incent, the user is receiving a reward in exchange for taking an action, such as downloading an app, or completing an Event conversion. Typically Incent traffic delivers much lower user quality than standard promotion methods. **Traffic Type**：Once an active channel is associated with an Offer, it will be visible in the Partner portal in the general details of an offer and as a filter. Examples of Partner Channels could be Email, Social, Banner, Pop-up, Incent, Adult, to name a few. **Creatives**：Upload creative files for send to your Partners for their promotions This option allows you to upload: Archive (Zip file with multiple creatives), images, videos, and emails. Max individual file size is 20 MB. **Setting** **Access Status**：Types of visibility **Need Approval** - Means you have been previously approved by the network to run that specific offer. **Public** - Means the network has made this offer public for all partners/affiliates to see. **Private**-Means will only show to affiliate you've selected for the offer. **Test Mode**：For conversion test with advertiser,you need to change it to Yes. Or Quickly Create Offer ![Quickly Create Offer](/files/-Lt3s-KM1PVhrknKFvYN)
# Add New Publishers/Affiliates This tutorial explains how to create an affiliate and configure postback links. #### **Step 1: Create an Affiliate** 1. Go to **Home > Affiliates > Add**. 2. Fill in mandatory fields (marked with \*): * **Email**: Login account for the affiliate platform (e.g.`domain.hugoffers.com`). * **Password**: Login password for the affiliate platform #### **Step 2: Configure Postback** 1. **Default Postback**: * Replace parameters in the affiliate's postback URL with [HugOffers equivalents](https://www.yuque.com/hugoffers/support/parameters-for-integration). * Example: * Affiliate format: `http://aaccdasd.test.com/pb?tid=[clktoken]` * System format: `http://aaccdasd.test.com/pb?tid={aff_sub}` 2. **Advanced Privacy Postback**: * Typically left blank unless explicitly required. **Step 3: Manage Affiliate Operations** 1. **Operate Options**: * **Report**: View affiliate performance reports. * **Modify**: Update affiliate details. * **Offers**: Access all offers under this affiliate. * **Account Block**: Disable affiliate login. * **Offer Block**: Disable all offers for this affiliate. * **Reset Password**: Reset the affiliate's password. **a.** **Manual Affiliate Setups:** Affiliates > Add ![Add Affiliates/Publishers](/files/-Lt98CVPOIOP8suyziCC) **Administrator**：Affiliate Manager **`Three Optional`** **`1、Automatic Block Server Traffic,When selecte this Affiliate will automatic block server traffic.`** **`2、Disable Check Platform,When check this will be ignore platform targeting for this affiliate tracking url.`** **`3、Disable Check Country,When check this will be ignore country targeting for this affiliate tracking url.`** **Aff Labels**：A label is a tag that you can add to any affiliate/publisher/partner, offer, and/or advertiser. This is meant to be a completely customizable system of tagging that is searchable. **Mail List**：Set up a email other than the registered one, such as the financial officer who receives the bill. Complete all of their information and **set the right postback final**. ![Affiliate postback](/files/-LspOIWkARFwfA6ztSBj) **b.** **Affiliate Sign Up Page** Send the registered address to the affiliate. You can find it on the Hugoffers registration email.Then approve it on the affiliate page. ![Affiliate registration page](/files/-LspQQAAUXNVTMpXEHrS) ![Operate Affiliates/Publishers](/files/-Lt9EBm4yuXvYGAsDweb) The Operate on the right is the action taken by the affiliate. **Details**：Affiliate Detail **Modify**：Change the Affiliate information. **Offers**：Offers can see all the orders under this affiliate. **Report**：Report for this affiliate. **Account Block**：Click on Account Block to stop this account can't log in. **Offers Block**：Block to turn off all offers for this affiliate. **Reset Password\&Email**： Reset Password\&Email for this affiliate. # Approving Offers for Publishers/Affiliates This tutorial explains three methods to authorize offers to affiliates. There are three ways to approving offers for Publishers/Affiliates. **1、API IN Integration** This configuration is only for the API Offer. Select the corresponding API advertiser in the **Integration API-IN Integration** and add the corresponding Publishers/Affiliates in the Edit - Permission. This type of operation will automatically pull all the offer auto-configuration Publishers/Affiliates. ![Volume authorization offers on API IN Integration](/files/-LtOW7JBGMIquPUIgpq0) **2、Single Offer Approving Publishers/Affiliates.** After the API pulls the offer into offer lists or manually creates the offer, click on the offer details to configure Publishers/Affiliates in the offer. The **Access** Status defaults to Inherit, which inherits the Publishers/Affiliates in the Integration API-IN Integration-Permission, and changes it to Private or Need Approval to add Publishers/Affiliates. ![Approving single offer for publishers/affiliates](/files/-LtOXKAeqVFBPqksvKC2) **3、Approving Publishers/Affiliates By Group Permission** Group Permission is very powerful, Here just show you how to Approving Publishers/Affiliates by using Group Permission. Home-Rules-Group Permission-Add ![Approving Publishers/Affiliates By Group Permission](/files/-LtOX__1isSgrdN3ujAM) You can also filter or select some Offer in the Offer list to Approving Publishers/Affiliates. To do this, double-click on Offer at Home-Offers-Offer List to select some Offers or filter some offers then Operate. ![Group Permission Operate On Offer List](/files/-LtOWnZbd_kyzHJYF45y) ![Allowed Or Forbidden Affiliates By Control Type](/files/-LtOX8LQHTWI3ZbKwt2_) In **Home > Offers > Offer List**: * Double-click to select offers or use filters. * Click **Batch Acquire/Remove Permission** for bulk actions.

select affiliates

# Integration Conversion Test Complete postback configuration before testing. **Advertiser\&Affiliate Conversion testing needs to be done after Postback is set correctly! ! !** #### **Part 1: Test as an Affiliate** 1. **Configure Tracking & Postback**: * Ensure the advertiser's tracking URL and postback parameters are correct. 2. **Enable Test Mode**: * In **Home > Offers > Offer List**, open an offer. * Set **Test Mode** to **Yes** (disables country/platform checks). 3. **Generate Test Link**: * Click **Generate Tracking URL - Test Link** and share it with the advertiser. 4. **Verify Conversion**: * Check **Home > Reports > Conversion Report** for received data. ![Change Test Mode To Yes](/files/-LspYLxUsMjH5nhfolIi) ![Generate Test Link](/files/-LspYXu3rs3GzhD5CCom) **If no conversion is received:** 1. Check if the URL redirection is functioning properly. 2. Verify parameter configurations, especially the `click_id`. 3. Ensure postback settings are correct (confirm your setup and the advertiser’s configuration). 4. Wait for potential delays (up to 10 minutes in some cases). 5. Retest with a different offer using the same process. 6. If issues persist, conduct a small-scale traffic test for troubleshooting. #### **Part 2: Test as an Advertiser** 1. **Configure Affiliate Postback**: * Replace parameters (e.g., `aff_sub`) in the affiliate's postback URL. 2. **Simulate Conversion**: * Go to **Tools > Conversion Test**. * Enter the **Offer ID** and test link provided by the affiliate. * Click **Send Postback** and confirm success (`error: 0`). ![Send test conversion](/files/-Lsp_5dNUXVpvIz9AeNr) **If no conversion is received:** 1. Verify that the postback parameters in our system channel are correctly configured. 2. Wait 5-10 minutes and check again (delays may occur). 3. Re-run the test using the **conversion test tool**. 4. If the issue persists, contact our technical support team for assistance. # Advertisers\&Publishers/Affiliates Tracking Parameters **Affiliate/Publisher Tracking Parameters**
**Commonly used parameters include:** * **`aff_sub`**: The affiliate’s unique click ID. * **`aff_pub`**: The sub-affiliate ID. * **`advertising_id`**: Google Advertising ID (GAID). * **`idfa`**: Identifier for Advertisers (IDFA) for iOS devices. * **`payout`**: Revenue generated from conversions.
ParametersTypeDescription
ParametersTypeDescription
offer_idStringID of Hugoffers's offer.
aff_pubStringSub source id/sub id
aff_subStringaffiliate/publisher click id
aff_langStringDevice two-character language code.
aff_sub2Stringaffiliate/publisher sub 2 Custom parameter
aff_sub3Stringaffiliate/publisher sub 3 Custom parameter
aff_sub4Stringaffiliate/publisher sub 4 Custom parameter
aff_sub5Stringaffiliate/publisher sub 5 Custom parameter
aff_sub6Stringaffiliate/publisher sub 6 Custom parameter
payoutStringAmount paid to publisher for conversion.
idfaStringApple's advertiser identifier with iOS 6+.
advertising_idStringGoogle's advertising identifier,gaid
ipStringIP address that made the click request.
android_idStringAndroid Device ID.
user_agentStringUser Agent In Header.
site_idStringapp id,package name,website url (App/Website)
os_versionStringos version
device_modelStringdevice model
osStringDevice Platform(Android/Iphone/Ipad)
event_nameStringEvent Name
**Advertiser Tracking Parameters** **Commonly used parameters include:** * **`{click_id}`**: Unique click ID passed to the advertiser. * **`{aff_id}`**: Affiliate ID. * **`{aff_pub}`**: Sub-affiliate ID. * **`{advertising_id}`**: Google Advertising ID (GAID). * **`{idfa}`**: Identifier for Advertisers (IDFA) for iOS devices. * **`{site_id}`**: Bundle ID, app name, or site name of the ad placement. * **`{data2}`**: Payout from the advertiser. * **`{event}`**: In-app event name.
ParametersTypeDescription
ParametersTypeDescription
offer_idStringID of offer.
click_idStringSub source id/sub id
idfaStringaffiliate/publisher click id
aadvertising_idStringDevice two-character language code.
site_idStringaffiliate/publisher sub 2 Custom parameter
aff_pubStringaffiliate/publisher sub 3 Custom parameter
android_idStringaffiliate/publisher sub 4 Custom parameter
aff_langStringaffiliate/publisher sub 5 Custom parameter
ipStringaffiliate/publisher sub 6 Custom parameter
user_agentStringAmount paid to publisher for conversion.
data2StringApple's advertiser identifier with iOS 6+.
eventStringGoogle's advertising identifier,gaid
os_versionStringIP address that made the click request.
device_modelStringAndroid Device ID.
caidStringUser Agent In Header.
oaidStringapp id,package name,website url (App/Website)
# Understanding Reporting **1、Overview** Once you’re set up with affiliates and running your offers successfully, you’ll want to utilize the reporting to keep track of performance. The report you’ll use the most is Reports> Overview. From here we will be using demo data. ![](/files/-LtbyQJ_B2Mj0KVZRgWZ) ![Overview Reporting](/files/-Ltbz1LczNAwMgS6D2dg) **Offer To ID**：The offer ID of clicks reaching **Offer**：Offer Name **Status**：Offer status,Active、Block、Pause **System**：Offer platform **GEO**：Offer Country Targeting **Payin**：Define your revenue **Remaining Cpas**：Remaining caps of offer **Total Clicks**：Amount of user reaching the offer **Total Conversions**：Conversion on your offer **CR**：Conversion Rate, this is good for seeing abnormal affiliate delivery. An extremely high CVR might suggestion they are using incentives. **Total EPC** ：Revenue per Click. Usually not relevant for your affiliate partners, but useful if you’re also tracking your own marketing channels. **Total Profit**：Total Revenue - Total Costs **2、Conversion report** If you need your data around conversions, that data is easiest to access and download under Reporting > Conversion Report. Filters allow you to break down this data by offer, affiliate, or any other key metric.When status are pending means don't send that postback we received to affiliates cause of some reason. ![Conversion Report](/files/-Ltc7VZQ44_j8l-tpCc1) **Status**：Status of postback result,Approved or Pending **Remark**：Reason of Pending Postback **Postback Result**：Message of affiliates postback,Success or ERROR **3、Event report** ![Event Report](/files/-LtcjNGnicOlxa_LVIwK) An event postback is used if the advertiser would like to pass more data back to your Hugoffers account after the initial conversion. This data could be anything such as registration, sale, retention, in-app purchase...etc. **Event**：Event name of offers **4、Quality Report** Statistical events and resulting revenue generation ROI analysis ![Quality Report](/files/-LtcjVIvCGZcSA-zhx2c) **5、Daily Report** The following tutorial will outline the steps in creating a dimensional report. To get to the page to create an advertiser report, simply go to **Reporting**, then **Every Day**. and also you can select send this report to advertiser\&affiliate every day after set email setting. ![Create Advertiser Daily Report](/files/-Ltcf_INeQNVZRacGCZq) Usually the reports will have data for that day shows important metrics such as clicks, total conversions, conversion rate, as well as payout/revenue metrics. The next feature worth mentioning is **Filters**. **Filters** allows you to narrow the data in the table by selecting certain metrics to be included in the report. ![Advertiser Daily Report](/files/-LtcfC-7KKcxiDxm2IGr) **6、Optimization Report** You can search some operations of offers,such as let some affiliates pub to push more or blacklist them. ![Operation Report](/files/-LtciXzkZgFdsRSsxPRT) # Smartlinks Smart Links provides a powerful tool to ensure that you’re sending your traffic to the best matching Offers. For your Offer’s **Fail Traffic** destination, Smart Links are the most effective setup. With Smart Links, you’re creating a bundled group of Offers that are reached through a single tracking link. Each User’s Click will be matched up with an Offer either through a downward list (Priority) or in a random rotation (Weight). Smart Links confirms that the Offer criteria would accept the User before delivering the Click, and if not it will deliver the User’s Click with a different matching bundled Offer. ![Create Smartlink](/files/-LtcpaDAFpUZE00L5ftI) **Smart link Name**：Name of smartlink **Status**：Status of smartlink **Protocol**：Protocol of smartlink **Administrator**：Administrator of smartlink **Test Mode**：Test mode option of smartlink **Advertiser**：Advertiser of smartlink **Access Status**：Offer access status **Affiliate**：Affiliates for smartlink **Weight**： Define a percentage of traffic to be sent to each Offer. ![Add offers to smartlink](/files/-Ltcqtnp5nB-lTapRbfq) ![Traffic weight for smartlink offers](/files/-Ltcr8Ac3sgYDUDwAKsv) # Labels Group Permission and Rules **1、Labels** Labels is a tag that you can add to any affiliate/publisher/partner, offer, and/or advertiser. This is meant to be a completely customizable system of tagging that is searchable. ![Set advertiser label](/files/-Ltd6UrrvvsEOWZX-huS) ![Set affiliate label](/files/-Ltd7f05b2L1Ppn581S4) ![Set single offer label](/files/-Ltd81BnkURhjsyzYqXz) For more dynamic labels about advertisers affiliates and offers,Click Rules->Label Rule->Add **Rule Name**：Top advertisers,Top affiliates,Top offers,Offer(dynamic jump ECPC CR) **Order By**：Order by revenue,jump,cr,ecpc **Date Range**：Past date **Update Interval**：Update Interval for this rule ![Dynamic Label Rule](/files/-LtdAd3x6eN7EFin9YJG) **2、Group Permission** You can choose advertiser/offer ID and labels or more conditions by secondary selection for approve and forbidden affiliates. If there is a conflict between approve and forbidden,Then the value of an Order is high weight. ![Group Permission ](/files/-Lth7A_4WFY7VQenlSJA) **3、Traffic Redirect Rule** You can choose advertiser/offer ID and labels or more conditions by secondary selection for redirect traffic to another offer. If there is a conflict between approve and forbidden,Then the value of an Order is high weight.If you want to see offer from ID traffic on Overview reporting you can check offer from ID. ![Traffic Redirect Rule](/files/-Lth9WOjYYiK4si3_rg2) 4、Traffic Pause Rule Traffic Pause Rule is powerful tool for automatic optimization control that pauses traffic based on KPI criteria and entirely defined by your rules and metrics. Traffic Pause Rule Notifications can be enabled for affiliates/publishers users, and includes an optional delay mechanism to allow Partners a chance to optimize before the traffic is paused.
![Traffic Pause Rule](/files/-LthDzxvU_nFcxZib5np) Offer ID,App ID,Adv ID,Aff ID **The input box blank means all.** **Minimum Trigger Click**：Total Clicks **Time Range**：Time interval **TTI**：Click time to install **CR Range**：Conversion Rate interval **Handler**：Some automated operations to affiliates and offers **Send Mail**：Automatic send email to affiliates **Block Offer**：Automatic block offer and you need active it by manual **Full cap offer**：Automatic cap full and will be active tomorrow morning **Send Mail and Block offer**：Automatic send email to affiliates and block offer **Block Affiliates**：Automatic block affiliates **Block Affiliates pub**：Automatic block affiliates pub ![Traffic Pause Rule Result](/files/-LthHPgoM8WO6LnOHMLM) **Result**：The Run History tab provides a list of each traffic pause rule activation and its associated results.You can also see it on traffic redirect rule. # Billing Settings Default billing settings can now be configured for Advertisers and Affiliates/Publishers. You can also update the billing settings per Advertiser and Affiliates/Publishers. **Advertiser Billing History** ![Auto Create Advertiser's Billing](/files/-LthtKwtQUAYxT20aVr6) **Min Amount：**Less than this bill amount will not be created. **Auto Create Status**：Auto Create billing or not. **Auto Create Date**：Date of auto create billing. ![Advertiser Billing History](/files/-LthxA5D8lgmd3XDAkYH) **Modify Billing**：Save billing **Add Billing Row**：Add another offer billing row **Validate All**：Validate all numbers **Delete Billing**：Delete billing **Total Revernue**：Total Revenue for offers **Reduce**：Reduce for offers **Pending**：Pending numbers for offers **Adjustment**：Difference numbers for offers **Validate Status**：offer numbers confirm status **Remark**：Reason for reduce **Operate**：Operate for offers **If you reduce a offer on advertiser's billing,then the affiliates/publishers billing will automatically generate the reduce amount.Reduce number will be show on affiliates billing-reduce.** ![Auto create affiliates billing](/files/-Lti-PJgOT9Nv458Y-kT) When you validate all numbers for affiliates,the status will be change to **waitting\_send**,when you send it to affiliates,it will be change to **waitting\_confirm**,when affiliates confirm their billing on affiliates system it will be change to **waitting pay** then **paid**. ![Billing Status](/files/-Lti-fHnPrt8QrWWB9PY) # Basic Setup **1、General Settings** ![General Settings](/files/-Lti6q5yh27im1LrgmKt) **Network ID**: The domain name of the sub-publisher, which cannot be modified. **Customer Application Domain**: The customer's own domain name (the default state at the time of registration), which cannot be modified. **Network Timezone**: The time zone in which the customer is located (the default state at the time of registration), and it can be modified. After the modification, it will be synchronized to the following location: **Company Logo**: Company Logo When don't uploaded, the system displays the company name at the time of registration by default. **Electronic Stamp Picture**：The upload image supports the formats ‘png’, ‘jpg’, ‘jpeg’, ‘bmp’, and the size is limited to 50M. When you need to update the logo, you should upload a new logo, and the system will directly overwrite and replace the original logo. **Customize Title**: Custom Title **2、Affiliate Panel Settings** ![Affiliate Panel Settings](/files/-Lti7cKRJs-izbB__pCU) **Terms\&Conditions**: Determines the presence or absence of the Terms on the Publisher Sign Up page. When not uploaded, the system displays the default Terms & Conditions. Upload files are only supported in PDF format and are limited to 50M. When you need to replace a new file, upload a new file, the system will directly overwrite the original file and take effect. The specific location is as follows: In the login interface of the channel, click Affiliate Sign Up. **Affiliate privacy Policy**: Customer's own privacy policy (default state at registration), support for upload and download functions. When don't uploaded, the system displays the default Privacy Policy. Upload files are only supported in PDF format and are limited to 50M. When you need to replace a new file, upload a new file, the system will directly overwrite the original file and take effect. After the upload is modified, all the Privacy Policy in the system will change accordingly. **Affiliate Sign Up Status**: Two situations are set, and Active and Require Approval modes can be selected. The default is Require Approval mode. In Active mode, when the channel registers the system, it automatically takes effect; In the Require Approval mode, the channel needs to be reviewed and approved before it can be used. **Questions For Affiliate Sign Up**: Users can customize the issue of Affiliate Sign Up. **3、Tracking Setting** ![Tracking Setting](/files/-Lti8SYbByp5bg3S8aDA) **Default Tracking Domain**: Click domain name, cannot be modified. **Network Global Postback URL**: The global postback URL cannot be modified. **Default KPI**: For the API list, the default KPI is displayed when there is no KPI. **Custom Postback Server IP List**: The advertiser's Postback Server IP. Displayed as a list, you can add, modify, and delete operations. **Conversions out of Allowed Countries**: Set up the country, accept conversions from non-permitted countries, and provide Pending and Approved modes. Default Pending. **Conversions Over Cap**: For the conversion of super cap, Pending and Approved modes are available. **4、Support Email Settings** ![Email Support Settings](/files/-Lti95hWJEtoKyRfDzlp) **SMTP Domain/IP Address**: Fill in the SMTP information **Port**: port number **SMTP User Name**: Email Address **SMTP User Password**: Email Password **"From" Email Name**: The name of the mailbox displayed in the email, usually the company name. **"From" Email Address**: Display only, the information is the same as the SMTP User Name. not editable **Test SMTP Server**: Test button, fill in the above information, click the button, will send a test email, the test can be saved before it can be saved. The following is an example of Tencent's enterprise mailbox SMTP Domain/Port SMTP Domain: smtp.exmail.qq.com Port: 465 Such as Ali business mailbox SMTP Domain: smtp.mxhichina.com Port: 465 **5、Advance Settings** ![Advanced Settings](/files/-Lti9fh6b67lqKB4qz49) **About Offer Controller：**Controller all your offers country\&platform targeting. **About Affiliates Controller：**Controller all your affiliates server traffic. # Integration with Appsflyer\&Adjust **1、Appsflyer Integration** This article is intended for networks who want to: * Work with AppsFlyer for the first time * Migrate an advertiser to AppsFlyer AppsFlyer sends attribution data to Hugoffers for installs and in-app events such as purchase first\_guid open order. **To initiate the integration with AppsFlyer:** 1. Complete the AppsFlyer [**Partner Registration Information Form**](https://www.appsflyer.com/partners-registration/) 2. Once you have submitted the registration form, to AppsFlyer, you will receive an email from the AppsFlyer Partner Development Manager. 3. Respond to this email with the name of the AppsFlyer client that you are onboarding. The AppsFlyer Partner Manager will then send you a follow-up email in a new thread where you will be asked to supply the following information: * Your company name * Transparent logo in PNG format. (Ideal size is 200x50) * The recommended Hugoffers attribution URL template, with any additional values you wish to add. The **pid** value will be automatically assigned and built into the URL once the integration has been completed * Any additional values you want in the URL * Your Network ID (nid) and postback domain for install and in-app event postbacks configurations 4. If you have not heard from an AppsFlyer team member within 48 hours of filling out the registration form, please check your spam folder, and email "" to check the status. ``` https://app.appsflyer.com/com.appsflyer?pid=mediaName_int&clickid={transaction_id}&af_siteid={affiliate_id}&af_sub_siteid={affiliate_source_id}&idfa={idfa}&sha1_idfa={idfa_sha1}&advertising_id={google_aid}&af_cost_value={amount}&af_cost_currency={offer_currency}&af_cost_model=CPI&af_sub_siteid={affiliate_source_id}&idfa={idfa}&sha1_idfa={idfa_sha1}&advertising_id={google_aid}&af_cost_value={amount}&af_cost_currency={offer_currency}&af_cost_model=CPI ``` **To update an existing integration**: \ If you need to make an update to an existing integration, then send an email request to "". Most requests are completed within 2 business days. \ Creating an Attribution Link in AppsFlyer The attribution link consists of the AppsFlyer base attribution link and additional macros added by the ad-network as detailed here. | AppsFlyer Base URL | Description | | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | [https://app.appsflyer.com/{app\_id}](https://app.appsflyer.com/%7Bapp_id%7D) | AppsFlyer end point | | app\_id | Application unique ID: represents the ID of the app being promoted | | pid | Media source name concatenated with \_int to identify integrated networks. Example: meidaName\_int | | c | Campaign name | Set out below is a complete AppsFlyer attribution link with a detailed explanation per macro: ``` https://app.appsflyer.com/{app_id}?pid=mediaName_int&clickid={click_id}&af_siteid={aff_id} &af_sub_siteid={aff_pub}&idfa={idfa}&sha1_idfa={idfa_sha1}&advertising_id={advertising_id} &af_cost_value={data2}&af_cost_currency={currency}&af_cost_model=CPI ``` * For campaign cost models other than CPI, please update the **\&af\_cost\_model=** parameter to the appropriate model. Example: CPA, CPC * If you are an existing AppsFlyer partner and currently migrating toHugoffers from a different platform, make sure to add **`&af_additional_postback=1` t**o your attribution links. ### Global Install Postback ``` http://test.hopb0.com/notify/global/?click_id={clickid} ``` ### Global In-App Event Postback ``` http://test.hopb0.com/event/global/?click_id={clickid}&event=event_name&data={data2} ``` **Useful things to add to Appsflyer attribution links** | \&af\_additionalpostback=1 | This allows you the ability to place more than one postback url in Appsflyer and fire them at the same time for every click ID | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | \&af\_installpostback=false | This allows you to only postback conversions for the event and not postback conversions for the install to Hugoffers at all | **2、Adjust Integration** With Adjust you need to setup the postback url as an encoded url in the tracking link. **Here is a doc to help you understand how this works**: **Here is postback setup tool:** The following is a step-by-step walkthrough how of how to set up an Adjust integration: **Step 1** For MMP integrations, the first step is to have the advertiser relationship in place. **Step 2** For Adjust, you don’t need to do any pre-integration conversions before launch, as you will be building your tracking link & postback link from what the advertisers sends you. **Step 3** Request all offer details, events and the Adjust tracking link from the advertiser. **Step 4** Create the offer in Hugoffers - you won’t have the final destination URL yet, but each of the events in hugoffers must be created in advance.\
**Example Link:** [https://app.adjust.com/ENCRYPTID?adgroup={sub3}\_{affiliate\_id}\&creative={sub2}\&idfa={idfa}\&gps\_adid={google\_aid}\&ip\_address={user\_ip}](https://app.adjust.com/janm8g2?adgroup={affiliateId}\&creative={subAffId}\&idfa={idfa}\&gps_adid={gaid}\&ip_address={ip}\&cost_type={s1}\&cost_amount={payout}\&cost_currency={currency}) Event token abcdef = Registration For completing your destination URL + postback setup, you will need to go to **Step 1** Under 'Enter Links' paste in the link your advertiser sent you **Step 2** Under 'Call Backs' place in your global postback link **Step 3** For \&transaction= make sure you put in the Hugoffers format of {click\_id} **Step 4** For normal setups, skip most of these sections, until you reach Events **Step 5** Under events, there are two steps: * 1\) Pop in the Event token the Advertiser sent you * 2\) Under call back, you will need to put in your Hugoffers Event Postback URL * Go to the Advertiser * Under conversion postback > select under the Conversion drop down > Select the Event you want to set up * Copy that postback link, go to Adjust, and paste that under the Call Back * Make sure to update the transaction ID to {click\_id} so that it matches the Hugoffers format **Step 6** Copy the Generated URL - That is going to be the Destination URL in Hugoffers, and includes all of the necessary details to postback to Hugoffers **Step 7** Update the Destination URL, pull a tracking link, and test to confirm everything is working correctly. **Step 8** Once everything is good go, you may consider requesting access to the Advertiser's Adjust reporting dashboard so that you can access fraud/quality data.\ **Example Screenshots:** ![](/files/-Lty3J3ZjTrEYBCfh7CJ) ![](/files/-Lty3qoedSOGOInH2wyT) ![](/files/-Lty3oW1G6JCL9_G1iwc) That generated link is inserted as your Destination URL, and includes all of the necessary data for send the Base + Event postbacks.