LeadsADX 用户手册

LeadsADX 是一款由 LeadsWORK 开发的程序化广告交易平台，即 AD Exchange。用于对接程序化广告交易的流量供方（Supply Side）和需方（Demand Side），帮助程序化广告运营者完成毫秒级的广告竞价、成交、数据整理和回传、收益支出分析等全套功能。系统支持公开的 RTB 协议对接，也支持开发者 API 接入，可用于开发者流量变现业务。

Dashboard

Dashboard 仪表台用于展示 LeadsADX 平台内的整体数据，包含收入、支出、利润、请求数量、竞价数量、胜出数量、展示数据、点击数据以及转化数据等等, 也提供了基于时间的曲线图形，用于描述期间内的请求、竞价、展示等数据。

LeadsADX Dashboard

仪表台同样提供了柱状图用于展示收入、支出以及利润。

Dashboard 柱状图

其他包含对流量供应方的数据概览，可通过饼状图和柱状图来查看。流量需求方的展示和竞价数据也有相应的图形化展示，方便用户查看比对汇总数据。

Supply

Supply List

Supply 模块提供了管理 Supply、接入流量、管理 App/Site 和广告位 Placement 等功能， 可以对精细化管理到 APP、广告位、广告格式等粒度。

Supply列表

Create/Edit Supply

用户可以通过点击Supply模块页面上的“Create Supply”来创建一个新的Supply，主要设置项如下:

  • Name – Supply流量供应方名称
  • Email – Supply流量供应方联系人/账户邮件地址
  • Password/Confirm Password – Supply流量供应方登录密码
  • System Name – Supply流量供应方系统名称；列表中均为已定制对接的流量供应方系统，如果没有在列表内的流量供应方系统，请先联系LeadsWORK AM 和流量方确认是否需要定制对接
  • Bid Profit Percent – Supply流量供应方需要保留的利润比例
  • Currency – Supply流量供应方结算的货币种类
  • Floor – Supply流量供应方的底价，如果此Supply流量中不包含bidfloor字段，LeadsADX会自动使用此floor作为bidfloor转给DSP
  • Traffic Type – Supply流量供应方属性
    • Publisher – Supply流量供应方为Publisher系统
    • SSP – Supply流量供应方为SSP
    • ADX – Supply流量供应方为ADX
  • Max QPS – 允许Supply流量供应方的最大QPS，超过 QPS 的流量将会被返回204
  • Daily Request Cap – 每天接收Supply流量供应方的最大请求数，超过此数量的请求将会被返回204

SSP & ADX

对于聚合流量的 Supply，其系统是 SSP 或者 ADX， 提供的流量可能来自多个流量媒体，而这些媒体的流量质量、供需关系会有所不同。

Bundle ACL

系统提供工具，对来自该 Supply 的流量根据包名进行筛选：

  • 可以设定白名单方式（Include），表示仅接收指定的包名流量;
  • 也可以设定黑名单方式（Exclude），表示排除某些流量，接收其他流量。

用户可点击Supply列表右侧的“Bundle ACL”进入流量媒体黑白名单管理页面。

Supply层级设置媒体黑白名单

TOKEN

系统为每个 Supply 生成专属 TOKEN，SSP & ADX 流量接入时，系统使用该 TOKEN 识别流量所属的 Supply。
以下是一个示例 EP，提供给流量方，用于接入流量，其中 {YOUR_EXCHANGE_DOMAIN} 为系统域名， {TOKEN} 为系统生成的TOKEN。 

https://{YOUR_EXCHANGE_DOMAIN}/ad/bid/{TOKEN}

Publisher

对于 Supply 系统是 Publisher 的开发者流量，系统提供了 App/Site 管理功能，用于管理 App、站点及其广告位。

App/Site

为 Publisher 创建流量媒体，例如App或者Site， 用户通过点击Supply 列表右侧的 “App/Site” 进入流量媒体管理页面。

点击”App/Site”

点击“App/Site”列表页面上的“Create App/Site”来创建一个新的App或站点，也可以通过点击“Edit”来编辑已有的App或站点。

点击”Create App/Site”

主要设置项如下：

  • Name – App或Site的名称
  • Type – 类型：App或Site
  • Category – App或Site的所属类型，可选范围是 iAB 的分类
  • API – App或Site的API类型和版本
  • Domain (App or Site) – App或Site的Domain
  • Bundle (App) – App的Bundle
  • Store Url (App) – App的商店地址
  • Version (App) – App的版本
  • Secure – 是否通过安全链接通信
  • Privacy Policy – 是否遵从隐私约束
  • Coppa – 是否遵从儿童隐私和内容保护法规定
  • Keywords – App或Site的关键字
  • Price Model – App或Site价格模式
  • Floor – App或Site低价，如果此App或Site流量中不包含bidfloor字段，LeadsADX会自动使用此floor作为bidfloor转给DSP，注意，此设置会覆盖Supply的Floor设置
  • Block Categories – App或Site屏蔽的目录
  • Block Advertisers – App或Site屏蔽的广告主
  • Block Bundles – App或Site屏蔽的流量媒体

Placement

为App/Site创建其下的广告位，可以点击App/Site列表右侧的“Placement”进入流量媒体管理页面。

点击”Placement”

点击右上角的 “Create Placement”来创建一个新的广告位（Placement）。

点击”Create Placement”

Placement的主要设置项和说明如下：

  • Name – Placement的名称
  • Status – 状态，激活或暂停
  • Ad Format/Size – Ad的格式和尺寸描述
  • Interstitial – 是否为插屏广告
  • Floor – 底价，如果此Placement流量中不包含bidfloor字段，系统使用此floor作为bidfloor转给DSP，如果在 App/Site 层面也设置了 Floor，优先使用 Placement 的 Floor
  • Display Manager – Display Manager，用于填充流量中的此字段
  • Display Manager Version – Display Manager Version，用于填充流量中的此字段
  • Block Banner Type – 屏蔽的横幅广告类型
  • Block Creative Attribution – 屏蔽的素材属性
  • Position – Ad的位置
  • Mimes – 支持的Mime类型
  • Top Frame – 是否为顶层显示
  • Expand Direction – Ad延伸方向

Placement TOKEN

系统为每个 Placement 生成专属 TOKEN，Publisher 流量接入时，系统使用该 TOKEN 识别流量所属的 Placement。
以下是一个示例 EP，提供给流量方，用于接入流量，其中 {YOUR_EXCHANGE_DOMAIN} 为系统域名， {TOKEN} 为系统生成的TOKEN。 

https://{YOUR_EXCHANGE_DOMAIN}/ad/pub/{TOKEN}

Special Floor（SSP/Publisher)

针对SSP或者Publisher类型的流量供应方，存在需要手动设置底价的需求。用户可以对不同的App/Site，或者Placement设置不同的底价。

Demand White List

假设系统内的 Supply 数量为 m, Demand 的数量为 n，那么可能的交易通道最大就是 m*n。
为了精细化调整系统的流量转发策略，系统维护开通的交易通道白名单。系统为每个 Supply 维护一个 Demand 白名单(White List), 来自该 Supply 的流量只会发送给白名单内的 Demand。
系统列出了所有的 Demand，用户通过选中或取消，维护该白名单。

Supply Demand Whitelist

Demand

Demand 是 AD Exchange 竞价交易的流量需方。Demand 管理模块提供了Demand创建、流量对接、End Point（EP）管理、竞价版本及模式、请求模式、通知方式设置等众多功能。该模块也提供了国家、OS系统等精细粒度的流量转发规则。

Demand列表

Create/Edit Demand

用户通过点击Demand列表右侧的“Create Demand”来创建一个新的Demand，也可以通过点击“Edit”来编辑已有的Demand。

创建Demand
Demand 的主要设置项和说明如下：

  • System – 系统类型, 列表中均定制对接的需方系统，如果没有在列表内的系统，请先联系LeadsWORK AM 和 Demand，确认是否需要定制对接，留空表示无需定制，按标准对接
  • Detector Service – Demand的检测服务，用于检测流量中的恶意行为
  • RTB Version – RTB协议版本，系统支持：
    • OpenRTB 2.0
    • OpenRTB 2.1
    • OpenRTB 2.2
    • OpenRTB 2.3
    • OpenRTB 2.4
    • OpenRTB 2.5
  • Markup Method – Demand 系统响应广告内容的方式
    • Markup Served in the bid – 在 RTB Bid Response 中返回广告内容
    • Markup Served on the win notice – 在 Win Notify 的响应中返回广告内容
  • AD Format – 有的 Demand 系统对于不同格式的 AD，需要不同的请求 TOKEN，该 TOKEN 从 Demand 系统获取，填写在此处
  • Auction Type – 竞价类型
    • First Price – 一价模式
    • Second Price – 二价模式
  • Win Notice Type – 竞价结果通知类型
    • Bid Request – 竞价请求
    • Bid Response – 竞价响应
  • Country – Demand 接收的流量国家，留空表示接收所有国家的流量
  • OS – Demand 接收的流量 OS，留空表示接收所有 OS 的流量
  • Max QPS – Demand 系统所接收的最大 QPS，系统发给该Demand系统的请求不会超过此值
  • Daily Request CAP – Demand 系统每天可接收的最大请求数，系统每天发给该Demand系统的请求不会超过此值

End Point

Demand End Point 是 Demand 系统接收流量的 URL。
用户在创建好Demand后，需要为 Demand 至少配置一个 End Point（EP）， 系统将 Bid 请求发送给该 EP。

End Point列表

用户也可以为Demand根据不同的节点区域，创建多个End Point，并设置对应的延迟上限，来满足Demand的全球流量需求。

创建End Point

EP 的主要设置项和说明如下：

  • URL – EP 地址
  • Method – 请求该EP的方式
    • GET – HTTP GET
    • POST – HTTP POST
  • Encode – 请求内容是否压缩
    • Plain – 不压缩
    • GZIP – GZIP 压缩
  • DC Location – EP 服务器所在的数据中心位置，可选范围包含了全球主要的数据中心，系统将根据该设置，挑选最近的 EP 发送 Bid 请求
  • DC Latency – EP 的最大延迟毫秒数，超过该延迟的 Bid Request，系统不再继续等待其返回，标记为 Timeout

Supply White List

在 Supply 管理模块中选择 Demand 来维护交易通道，同样，也可以在 Demand 模块里选择 Supply 白名单来定制交易通道。系统为每个 Demand 维护一个 Supply 白名单(White List)，即该 Demand 只接收来自白名单之内 Supply 的流量。

Demand – Supply Whitelist

Bundle ACL

当 Demand 系统不是接收所有的流量，对而是对流量所属包名有要求，可使用 Demand Bundle ACL 功能满足该需求:

  • Include – 白名单，Demand 系统只接收 Bundle ACL 中包含的包名的流量
  • Exclude – 黑名单，Demand 系统不接收 Bundle ACL 中包含的包名的流量，但是接收所有不在 Bundle ACL 中的包名的流量

Demand – Bundle Acl

App Version Filter

用户可以为每个Demand设置多个版本过滤规则，例如不同版本下的某个App/Site的广告位的黑白名单。

Demand – App Version Filter

如上图。规则可以解释为Demand接收(1)app_one的 6.1-8.3 版本的(6)(5)(1)三个placement的流量，而不会接收Placement Blocked List中的placement流量

Placement Mapping

如果Demand系统是一个 SSP系统，LeadsADX系统需要将 Publisher 流量的广告位，对应到 Demand 系统中的预设广告位，在请求 Demand 系统时，需要符合该系统内的API定义，类似对应的不同Placement。此类对应规则可以在Demand的Placement Map中设置。

Demand – Placement Mapping

按上图匹配关系，系统接收到 5# Supply 的 test-app-1 的广告位 placement-2 的流量，将其转发给Demand系统时间， 使用 D1_App 作为 App ID，使用 banner0 作为 Placement ID，并使用0.1作为 Demand 系统对该广告位的默认出价

Default Bid Price

Demand系统不是 RTB 系统，Demand响应中可能会不包含竞价信息，这时需要手动设置对应不同Country的固定价格。

Demand – Default Bid Price

Automation

Automation 模块提供了对流量供应方Supply不同层级对象以及流量需求方Demand的自动化运营规则。
Automation模块可以对 Supply、App、Placement 和 Demand 进行持续的数据监控，在满足设定条件后，执行“建议（Suggestion）”、“警告（Warning）”或者“操作（Operation）”等动作。

Automation – 创建Rule

上图中的规则，每小时检查各个 Supply前三个小时的数据，如果对某个 Supply 的 Bid Response 超过 15000, 而其 impression 低于平均的 20% 时，暂停该 Supply
在“Automation Log”中查看自动化规则的所有记录，对于建议和警告的，也可以完成相应的操作。

Tools

Tools 提供了 Private Inventory、Black Bundles、Operation Log 等三个子功能。

Private Inventory

LeadsADX 支持为流量供应方和流量需求方配置PMP， 即 Private Marketplace。

Private Inventory Rule列表

可以在Private Inventory中创建Private Inventory Rule来描述PMP， 设置规则的名称、状态、有效期、Supply、Demand、以及描述流量特征和竞价模式。

创建Private Inventory Rule

Black Bundles

用户可以在 Black Bundles 中对不同OS系统平台设置相应的 Bundle/AppId 黑名单。该黑名单内的媒体流量将不会被 LeadsADX 所接受，而无需针对每个supply做设置。

LeadsADX平台全局媒体黑名单

Operation Log

系统提供了 Operation Log 工具， 可以随时查看平台上的操作记录，方便用户回溯操作，运营，设置等记录。用户可以根据操作对象类型，ID，操作时间来查询操作记录。

Operation Log列表

Reporting

LeadsADX 分别提供了Supply Report和Demand Report两种数据报表， 供用户查看流量交易以及分析流量数据。

Supply Report

LeadsADX Supply Report提供了多种数据列，过滤项以及汇总字段等信息供用户查看分析Supply数据。

  • Time zone – 时区
  • Dates – 基于Time zone所选的日期范围
  • Dimensions – 数据列
    • Hour/Day/Month/Year
    • Supply BD
    • Supply AM
    • Supply Account
    • Supply Protocol
    • Ad Format
    • Size
    • Site App ID
    • Placement ID
    • Position
    • Country
    • State
    • City
    • Carrier
    • OS
    • OS Version
    • Device Type
    • Device Brand
    • Device Model
    • Age
    • Gender
    • Target Site App ID
    • Bundle
  • Metrics – 聚合数据
    • Request Count
    • Bid Count
    • Bid Price
    • Win Count
    • Win Price
    • Impression
    • Impression Cost
    • Impression Revenue
    • Click
    • Conversion
    • Fill Rate
    • Win Ratio
    • Impression Rate – impression count / win count
    • CTR
    • CR
    • Revenue
    • Rev.eCPM
    • Cost
    • Cost.eCPM
    • Profit
    • eCPM
  • Filters – 过滤项
    • BD
    • AM
    • Supply
    • Placement
    • Country
    • OS
    • Protocol
    • Ad Format
    • Bundle
    • Traffic Type

Demand Report

LeadsADX Demand Report提供了多种数据列，过滤项以及汇总字段等信息供用户查看分析Supply数据。

  • Time zone – 时区
  • Dates – 基于Time zone所选的日期范围
  • Dimensions – 数据列
    • Hour/Day/Month/Year
    • Demand BD
    • Demand AM
    • Demand Account
    • Demand Campaign ID
    • Demand Creative ID
    • Demand Seat ID
    • Demand Protocol
    • Target Site App ID
    • Ad Format
    • Size
    • Site App ID
    • Placement ID
    • Position
    • Country
    • State
    • City
    • Carrier
    • OS
    • OS Version
    • Device Type
    • Device Brand
    • Device Model
    • Age
    • Gender
    • Target Site App ID
    • Bundle
  • Metrics – 聚合数据
    • Request Count
    • Bid Count
    • Bid Price
    • Win Count
    • Win Price
    • Timeout Count
    • Impression
    • Impression Cost
    • Impression Revenue
    • Click
    • Conversion
    • Fill Rate
    • Win Ratio
    • Impression Rate – impression count / win count
    • CTR
    • CR
    • Revenue
    • Rev.eCPM
    • Cost
    • Cost.eCPM
    • Profit
    • eCPM
  • Filters – 过滤项
    • BD
    • AM
    • Supply
    • Placement
    • Country
    • OS
    • Protocol
    • Ad Format
    • Bundle
    • Traffic Type

Users

LeadsADX 的账户管理模块允许管理员用户创建，编辑及管理不同角色的账户，包括Administrator、OP、BD、AM 等。不同角色的账户拥有不同的权限以及API token，用于控制该账户在平台内的功能使用，数据查看权限，以及使用相应的API。

Create User

Settings

系统 Settings 提供了若干设置项：

  • System Domain – 设置的系统domain，此 domain 将在 bid 过程中与 Supply 的 domain 进行对比，如果不同会在流量中续写Supply Chain
  • Timezone – 平台默认的时区
  • Currency – 平台默认结算货币币种
  • Cost Percent – 平台保留成本比例

Settings

Comments are closed.