ADX SAAS操作说明

一、系统概述

TopOn ADX SAAS是一个程序化广告交易平台解决方案。为客户快速开展程序化广告交易业务提供一站式系统支持。

借助我们的ADX SAAS系统能力，客户将能够：

① 灵活便捷地聚合更多程序化预算源

② 快速低成本地扩充流量池子

③ 智能高效地降低流量成本

④ 轻松易用地集成到现成广告位上，快速提升预算消耗

目前ADX SAAS处于一期内侧阶段，仅提供adx服务端能力，暂无独立的客户端渲染能力，但可支持借助TopOn ADX SDK能力进行广告的渲染。

输入https://admin-saas.dataxforce.com/， 立马访问adx saas，进入属于你的程序化交易世界！

 

二、用户角色使用指南

2.1 用户操作流程-登录与个人信息更改

① 首次访问系统时，需要输入账号密码进行登录。

② 目前用户账号的创建及首次密码的设置需要由系统管理员进行分配。

③ 用户在登录后，可自行更改密码

④ 在创建账号时，还需用户提供自己的Company Short Name/Campany Domain/Email，供ADX SAAS实际运营使用。

⑤ Company Short Name/Campany Domain将用于adx请求里标识用户，Email将用在后续邮件通知中，需要正确提供。

⑥ Company Short Name/Campany Domain/Email目前只能由系统管理员进行更改。

 

2.2 用户操作流程-接入流量

(1) 可通过首页的Supply入口 或 侧边栏的Supply按钮进入流量方管理页面

(2) 点Create，填写准备接入的下游流量方信息。 

① 目前仅支持以第一高价结算。

② 目前暂时只支持API接入。后续我们具备前端渲染能力后，会拓展SDK、VastTag等接入方式。

③ 目前API的Protocol仅可选择oRTB2.5 及 oRTB2.5-extend(Topon)。如果客户需要借助Topon SDK进行渲染，或采买Topon 的流量，需要选择 oRTB2.5-extend(Topon)即TopOn版的ortb2.5协议。若流量方有oRTB2.5以外的特殊协议，可联系TopOn对接人进行特殊支持。

④ Billing Method支持Adm形式或Burl形式，具体根据流量方要求进行选择即可。

⑤ Relationship需要根据实际流量情况进行选择：若为自己的流量，则选择Direct；若为三方采买的流量，选择Reseller。若选择错误，可能会导致DSP校验不通过。

(3) 选择Status是Active还是Inactive后，就可以保存。Inactive的流量请求进来将直接给下游返回无填充。

(4) 创建下游信息完成后，将会分配不同区域的Endpoint（EP）。建议给流量方分区域提供EP，以优化网络传输速度。对TopOn流量，提供Global EP即可。

(5) Publisher Key及Open API Key将在后续版本中使用。

 

2.3 用户操作流程-接入预算

(1) 可通过首页的Demand入口 或 侧边栏的Demand按钮进入预算方管理页面

(2) 点Create，填写准备接入的上游预算方信息 

① 目前预算方接入仅支持RTB形式，后续会根据市场情况拓展PD/PDB等接入方式。

② 目前仅支持以第一高价结算。

③ 目前API的Protocol仅可选择oRTB2.5 及 oRTB2.5-extend(kwai)。若预算方有oRTB2.5以外的特殊协议，可联系TopOn对接人进行特殊支持。

④ Billing Method支持Adm形式或Burl形式，具体根据预算方要求进行选择即可；

⑤ Endpoint（EP）信息根据实际预算方要求填写即可，可统一设置、区分区域设置、或分样式分区域设置。

⑥ 需要注意的是：QPS及latency会根据EP配置分别控制，若多个EP填写的是同一个URL，则该URL收到的MAX QPS将会是多个EP所配置的MAX QPS 的叠加。

⑦ latency和QPS若无限制，填0即可。

(3) 选择Status是Active还是Inactive后，就可以保存。Inactive的预算方将不会收到任何流量的竞价请求。

 

2.3 用户操作流程-流量分配

2.3.1 简介

流量分配是整个ADX（Ad Exchange）系统的核心。

本系统将采用流量分配规则（Transaction Rule）来管理流量分配，并设置该分配下的利润、参数映射、兜底底价及素材过滤。

① 可通过首页的Transaction入口 或 侧边栏的Transaction按钮进入流量分配规则管理页面。

② 若希望指定Supply分配给指定Demand，需要：Supply和Demand必须同时处于生效状态（Active，图中绿灯），且他们至少有一个生效（Active）的流量分配规则，才能将流量分发给这个预算。

 

2.3.2 简单配置

(1) 点击Create，填写上下游流量分配规则。

(2) 基本信息：

① 分配规则必须选择Supply和Demand，规则id在创建后会自动分配。

② Priority一共有20档，数字越小优先级越高。简单配置的话，默认P20即可。

③ Ad Traffic Targeting可填写定向规则，为方便后续管理规则时便于理解，Targeting Description必填。简单配置的话，其他内容默认不填写/不勾选即可。

(3) 具体配置： 

① 利润设置：设置给用户自己留下的利润比例，支持大于0的四位小数。

② DSP参数映射：不同预算方（DSP）有各自的协议要求，此配置用于根据DSP的要求传递对应参数。

③ 默认Bidfloor：当Supply流量方没有传递底价，则读取该默认Bidfloor作为请求上游的底价，支持大于0的四位小数。

④ 广告素材屏蔽：可屏蔽Bundle、ADomain、Crid，及IAB的Content Category（格式形如IAB8-5）

(4) 选择Status为Active后，并保存，该流量分配规则就生效了（有大概10分钟的生效过程）。若所选Supply和Demand同时处于生效状态，Supply的流量将会请求给所选Demand。

 

2.3.3 高级配置

(1) 流量分配规则的匹配： 

① ADX每收到一次流量请求，都会遍历该流量所属Supply的所有分配规则（Transaction Rule）；

② 并针对每个Demand，按分配规则的优先级从高到低排序去匹配Traget Traffic，只有命中的第一条分配规则会生效；

③ 最终会得到该流量在每个Demand下命中的分配规则，就会分别按规则的设置往对应Demand发起广告请求。

(2) 分配规则的优先级：对于每个指定的Supply-Demand关系，优先级先按Priority排序（数字越小优先级越高），若Priority一致，则按Rule ID倒序排序（创建时间越新，ID越大）。

(3) 定向匹配规则： 

① Traget Traffic中的所有“Targeting”维度都取交集，即流量请求里的所有维度都满足Traget Traffic的维度设置，才算命中此定向。

② 若某维度没有填写或留空，代表该维度无限制，所有流量都命中该维度定向。

③ Bundles/Domains/Countries的Targeting和Exclude条件有先后顺序：流量先要满足Targeting条件，再在Targeting条件基础上匹配Exclude条件 

• E.g. 当Targeting Bundle=“com.A, com.B”，Exclude Bundle=“com.B, com.C”，则只有bundle=“com.A”能命中条件，除了“com.A”，在“com.B, com.C”之外的bundle均不能命中条件

(4) 对于Target Ad Type： 

① 对于Protocol为ortb2.5-extend(topon)的Supply，只会按TopOn广告位实际配置，去匹配Native/RV/Banner/Interstitial/Splash，不会读取Video这个AdType。

② 对于Protocol为ortb2.5及其他ortb拓展协议的Supply，会按ortb协议里的对象，去匹配Native/Banner/Video，不会读取其他AdType。