1. 应用管理

在应用页面可创建和编辑应用，正式添加应用之前您必须注册一个#TopOn开发者账号#。

在应用页面，您可以做：添加并管理应用、广告位、广告场景

1.1 添加新应用

(1) 点击左上角【添加应用】-【添加单个应用】进入添加应用页面，请按照以下两种情况对应输入信息

① 您的应用已上架Apple Store、Google Play，您可以直接输入应用商店链接并点击搜索，系统会自动获取应用信息并完成输入，您需要针对信息做二次确认，如无误点击确认即可；其他安卓商店暂不支持搜索匹配。

② 您的应用未上架商店，您需要手动输入必填项（应用名称、二级分类、Bundle ID/包名、应用屏幕方向等）并确认提交。

文章图片

文章图片

(2) 如需添加多款应用可使用【添加应用】-【批量添加】功能

1.2 查看App Key

在集成TopOn SDK时，您需要使用TopOn提供的App Key。您可以按照以下任一方法获取App Key:

(1) 方法一（推荐）

您可以在【应用管理】页面上方的【编辑】中中找到App维度的App Key。此App Key仅在相应的TopOn应用下可使用。

(2) 方法二

您可以在【账号管理】-【key】中找到App Key。此App Key在本账号下全部App下均可使用。

1.3 关联广告平台

在应用管理页面，你可以在广告平台模块点击【关联广告平台】，选择需要关联的广告平台并输入对应的广告平台参数完成关联配置。

如果后续需要更改广告平台账号或参数，你可以在广告平台模块点击对应的广告平台名称进行编辑操作。

1.4 App数据概览

在应用管理页面，选择对应应用后，将显示当前应用的部分指标数据昨天的数据情况：DAU、预估收益、预估ARPDAU、展示/DAU，同时会显示昨天环比前天的数据波动情况。

若需要查看更多数据，可点击【查看更多数据指标】，跳转至综合报表查看。

2. 广告位管理

在【应用管理】页面可创建和编辑广告位。在创建广告位之前您必须先创建一个应用。

2.1 广告位介绍

广告位即应用内展示广告的位置。例如，游戏页面底部展示的广告，或者游戏关卡结束时展示的广告。每个广告位都对应着一种广告样式。应用与广告位之间存在一对多的关系。通常大多数应用都会创建多个广告位来满足不同位置和广告类型需求。

2.2 添加广告位

(1) 点击【添加广告位】-【添加单个广告位】进入添加广告位页面。

添加步骤如下：

① 选择需要添加广告位的应用。

② 自定义填写广告名称。

③ 选择广告样式。TopOn支持的广告样式有：原生广告（信息流）、激励视频广告、Banner、插屏广告、开屏广告。

④ 选择状态。默认为开启状态，如后续您需关闭此广告位，可以选择暂停。

⑤ 信息备注。此栏是选填项。

文章图片

⑥ 当选择的广告样式=激励视频广告时，可以选择是否需要使用服务端激励回调，详细说明请查看激励视频服务端激励

(2) 如需添加多个广告位可使用【批量添加】功能

2.3 查看广告位数据

支持查看广告位维度的数据情况，支持自己选择需要查看哪些指标

3. 广告场景

在【应用管理】-【场景管理】页面可创建和编辑广告场景。在创建广告场景之前您必须先创建一个应用和至少一个广告位。

在广告场景页面，您可以做：

添加广告场景
查看广告场景数据

3.1 广告场景介绍

(1) 查看SDK加载及展示广告转化数据，提升收益

通过使用广告场景功能，可以在漏斗分析报表查看SDK的各个广告加载和展示流程数据，判断广告设置是否合理，分析各个流程转化的优化空间，提升转化提高收益。

(2) 减少广告位配置成本

开发者通常用不同的广告位来区分不同广告场景的数据，这样可以有效的区分各个场景下的展示和收益数据，但同时会带来运营成本的增加（需要维护多个广告位的广告源配置）。

TopOn平台支持在广告位下创建多个广告场景，这样可以有效的区分不同广告场景下的展示、点击数据，降低用户配置广告位的成本。

3.2 广告场景接入流程说明

(1) 当前广告位只对应一个广告场景：

添加到达广告场景代码后，TopOn会在综合报表和漏斗分析报表提供以下核心指标，为您的广告变现提供更加完整的分析数据：

SDK在到达广告场景时调用TopOn SDK的entryAdScenario()方法，可不传入广告场景ID，数据将分类到default广告场景。

(2) 当前广告位对应多个广告场景，需要区分不同广告场景查看展示、点击数据：

① 在TopOn后台创建广告场景，并可自定义广告场景ID。

② 在App里准确添加到达广告场景代码（调用TopOn SDK的entryAdScenario()方法并传入各个不同广告场景ID)。

③ 展示广告时在show方法中传入scenario Id。

3.3 到达广告场景的调用时机

您可以根据不同的广告类型及自身App的广告逻辑，在App内调用TopOn SDK添加到达广告场景代码。

● 激励视频

可参考下列示例调用到达广告场景方法：

APP类型	广告名称	广告路径	到达广告场景调用时间
游戏	激励视频领取奖励	进入游戏->点击体力/货币获取入口->弹出看广告获取奖励弹窗->点击按钮观看激励视频	弹出看广告获取奖励弹窗
应用	看视频清理垃圾	进入应用->进入清理垃圾功能->扫描垃圾->点击立即清理->弹出看广告清理垃圾弹窗->点击按钮观看激励视频	弹出看广告清理垃圾弹窗

(1) 游戏激励视频领取奖励：

(2) 应用看视频清理垃圾：

● 插屏（全屏/半屏）

可参考下列示例调用到达广告场景方法:

APP类型	广告名称	广告路径	到达广告场景调用时间
游戏	通关插屏	进入游戏->进入关卡->通关弹窗->点击进入下一关/返回关卡页面按钮->弹出插屏->进入下一关/关卡页面	通关弹窗
应用	清理结束插屏	进入应用->进入清理垃圾功能->扫描垃圾->点击立即清理->清理动画->弹出全屏插屏->清理结果页	清理动画
应用	切换页面插屏	进入应用->首页->点击首页tab的其他功能->到达其他功能页面->弹出弹窗插屏	到达其他功能页面

(1) 应用切换页面插屏：

● 原生/信息流

可参考下列示例调用到达广告场景方法：

APP类型	广告名称	广告路径	到达广告场景调用时间
游戏/应用	签到弹窗原生广告	进入游戏/应用->弹出签到弹窗->展示签到弹窗下方原生广告	弹出签到弹窗
应用	页面原生广告	进入应用->进入功能页面/长列表页->页面内嵌入原生广告	进入功能页面/长列表页

● 横幅/Banner

可参考下列示例调用到达广告场景方法：

APP类型	广告名称	广告路径	到达广告场景调用时间
游戏/应用	弹窗下方横幅广告	进入游戏/应用->弹出消息弹窗/功能弹窗->展示弹窗下方横幅广告	弹出消息弹窗/功能弹窗
游戏/应用	固定横幅广告	进入游戏/应用->进入关卡页面/小说阅读页等->展示页面下方固定横幅广告	进入关卡页面/小说阅读页等

横幅广告预加载或非预加载，均可在上述页面调用广告场景。如果横幅广告自动刷新，进入广告场景数据将小于展示数据。

● 开屏

可参考下列示例调用到达广告场景方法：

APP类型	广告名称	广告路径	到达广告场景调用时间
游戏/应用	开屏广告	进入游戏/应用->显示公司logo页面->展示开屏广告	显示公司logo页面；若无logo页直接进入应用，则可在进入游戏/应用时调用广告场景，也可不调用广告场景

3.4 创建广告场景及获取广告场景ID

若需要使用多个广告场景区分数据，可在后台创建广告场景并获取广告场景。

具体步骤如下：

(1) 【应用管理】-选择对应的应用-【场景管理】

(2) 点击添加广告场景

① 每个广告位均有Default默认场景，默认广告场景ID=1，调用到达广告场景方法时，不上传广告场景ID，数据将归到默认场景。

② 可自定义广告场景ID（TopOn SDK v6.2.48及以上版本支持），便于开发同学接入时区分广告场景；不填写广告场景ID将自动生成广告场景ID。

③ 激励视频广告可以在广告场景中添加激励信息（激励名称和激励数量），激励信息会回调给开发者。具体可参考 iOS-回调信息说明和 Android-回调信息说明

(3) 查看场景列表并获取广告场景ID，提供给开发同学接入使用。

3.5 广告场景的接入代码示例

3.5.1 TopOn Android SDK代码示例

广告类型	示例代码
激励视频	查看
插屏	查看
开屏	查看
原生	查看
横幅	查看

3.5.2 TopOn iOS SDK代码示例

广告类型	示例代码
激励视频	查看
插屏	查看
开屏	查看
原生	查看
横幅	查看

3.5.3 注意事项

(1) 如果传入的广告场景ID错误或不是当前广告位下的广告场景ID，TopOn会将该部分数据统计到Default默认场景。

(2) 如果在entryAdScenario()、Show()方法不传入广告场景ID时，TopOn会将该部分数据统计到Default默认场景。

(3) 如果在entryAdScenario()、Show()方法传入暂停的广告场景ID时，TopOn会将该部分数据统计到Default默认场景。

(4) TopOn SDK不同版本支持广告场景的情况如：

TopOn SDK版本	支持广告场景的广告类型
>=5.4.7	激励视频, 插屏
>=5.7.9 (5.7.09)	激励视频, 插屏, 原生, Banner,开屏

支持TopOn后台自定义广告场景ID版本：>= v6.2.48

3.6 查看广告场景数据

(1) 广告场景数据报表

您可以在广告场景和报表查看特定广告位的各个广告场景的数据

(2) 漏斗分析报表

您可以在漏斗分析报表查看应用的漏斗分析数据

4. 展示&请求频次设置

在【应用管理】--【频次设置】页面可设置APP维度、不同广告平台、不同广告类型的展示和请求频次限制。

4.1 展示频次设置

4.1.1 APP维度

不限制广告平台、广告类型时，所设置的展示频次对该APP内所有广告生效。

（1）展示上限（天）：单个用户在1天内可以在APP内观看所有广告的最大次数；
（2）展示上限（小时）：单个用户在1小时内可以在APP内观看所有广告的最大次数；
（3）展示间隔（秒）：单个用户在APP内本次广告展示到下次APP内任意广告展示之间的时间间隔。

4.1.2 广告平台维度

只限制广告平台、不限制广告类型时，所设置的展示频次对所限制的广告平台的所有广告生效。

（1）展示上限（天）：单个用户在1天内可以观看该广告平台下所有广告的最大次数；
（2）展示上限（小时）：单个用户在1小时内可以观看该广告平台下所有广告的最大次数；
（3）展示间隔（秒）：单个用户在本次该广告平台的展示到下次该广告平台任意展示之间的时间间隔。

4.1.3 广告类型维度

只限制广告类型、不限制广告平台时，所设置的展示频次对所限制的广告类型的所有广告生效。

（1）展示上限（天）：单个用户在1天内可以观看所有该广告类型广告的最大次数；
（2）展示上限（小时）：单个用户在1小时内可以观看该广告类型广告的最大次数；
（3）展示间隔（秒）：单个用户在本次该广告类型的展示到下次该广告广告类型任意展示之间的时间间隔。

4.1.4 广告平台的广告类型维度

同时限制广告类型、广告平台时，所设置的展示频次对所限制的广告平台下对应广告类型的广告生效。

（1）展示上限（天）：单个用户在1天内可以观看所限制的广告平台下对应广告类型广告的最大次数；
（2）展示上限（小时）：单个用户在1小时内可以观看所限制的广告平台下对应广告类型广告的最大次数；
（3）展示间隔（秒）：单个用户在本次广告平台下对应广告类型的展示到下次广告平台下对应广告类型任意展示之间的时间间隔。

4.2 请求频次设置

该功能限制的是单用户在一段时间范围内所能发起的最大请求次数。

4.2.1 APP维度

不限制广告平台、广告类型时，所设置的请求频次对该APP内所有广告生效。

4.2.2 广告平台维度

只限制广告平台、不限制广告类型时，所设置的请求频次对所限制的广告平台的所有广告生效。

4.2.3 广告类型维度

只限制广告类型、不限制广告平台时，所设置的请求频次对所限制的广告类型的所有广告生效。

4.2.4 广告平台的广告类型维度

同时限制广告类型、广告平台时，所设置的请求频次对所限制的广告平台下对应广告类型的广告生效。

4.3 参考使用场景

当三方平台，如AdMob平台，对单用户频繁展示或点击行为会进行限制时，可以针对AdMob平台整体设置展示频控，如截图：

4.4 注意事项

每个指标的规则添加上限是10条。
当APP维度、广告平台维度、广告类型维度、广告源维度同时存在展示限制时，以最小值为当前设备的限制上限。
需SDK升级到 V6.4.50及以上版本才可用。

5. 复制广告位和瀑布流配置

5.1 使用场景

开发者有多个应用，且某些应用的广告位、流量分组和瀑布流配置基本相同，在新建应用的时候，可以直接复制现有应用的广告位、流量分组和瀑布流配置（即B应用可以直接复制A应用的部分瀑布流配置），建议同时使用自动创建广告源功能，可大大提升效率。

5.2 如何操作

5.2.1 复制广告位入口

在【应用管理】页面选择需要添加广告位的应用，点击复制广告位功能入口。

5.2.2 选择广告位和流量分组

选择需要从哪个应用复制，选择后会显示当前应用下所有广告位和流量分组，可勾选需要复制的分组，此时可修改广告位名称。点击继续会立即创建广告位和流量分组。

注意事项：

没有勾选默认分组复制的时候，会在新建的广告位自动创建默认分组。
如果当前广告位有正在进行的AB测试，则只能选择单个测试分组下的流量分组，不可跨测试分组选择流量分组。
当前勾选的广告位中，没有瀑布流配置的广告位或包含不支持批量添加广告源的广告位将直接复制广告位和流量分组。

5.2.3 填写广告平台和广告源信息

在第一步点击继续添加广告位和流量分组后，会将广告位、广告场景、广告源信息、流量分组高级设置的所有内容都复制到新应用。复制功能仅复制配置信息，不会复制广告平台应用ID、广告源ID等信息，此类信息需要在复制功能第二步手动补充，或开启自动创建功能自动创建新广告源。

(1) 广告平台信息

若新应用未关联广告平台，需要先关联广告平台，填写应用ID等信息。已经关联的广告平台，将显示需要填写信息的广告源（此时，广告源的类型、排序价格等配置均为复制内容，若有需要可直接修改）。

如果当前应用不需要关联某个广告平台，可以直接点击【暂不关联】按钮，此时将不会显示这个广告平台下的广告源。

(2) 广告源信息补充

已经关联广告平台后，将显示已勾选流量分组和对应广告源信息，只需要补充广告源ID（即三方广告位ID）等信息。若关联的广告平台支持自动创建，点击【+创建三方广告位】，此处将默认开启自动创建广告源功能，不需要填写广告源ID。

所有信息补充完毕后点击提交，会在当前广告位下自动添加广告源和配置信息。若选择了多个广告位，依次提交完所有广告位信息后将返回应用界面。

6. 常见问题

6.1 应用创建创建问题

(1) 是否遵守美国COPPA/遵守加州CCPA？

根据您应用的用户实际分布情况选择即可。

地区	内容
美国COPPA	是美国儿童网络隐私保护法(Children's Online Privacy Protection Act)的简称。若您应用的用户有美国13周岁以下的儿童，请选“是”
加州CCPA	是加利福尼亚州消费者隐私保护法案(California Consumer Privacy Act)的简称。若您应用的用户有美国加利福尼亚州的用户，请选“是”

(2) 中国内地和非中国内地的应用是否需要分包？

系统	内容
Android	①安卓项目集成时，中国内地和非中国内地需要分包集成。 ②如果集成了国内的SDK版本发布到Google Play上，会导致Google Play下架处理。 ③在TopOn后台SDK下载页面，已经提供了应用发布地区选项，可选择“国内”或“海外”进行下载，选择对应的SDK版本即可。
iOS	①iOS项目集成时，中国内地和非中国内地不需要分包集成。 ②注意：从TopOn SDK iOS v5.7.45版本开始，TopOn SDK提供穿山甲国内和海外SDK分开下载。如果您国内和海外都想要使用穿山甲SDK变现，需要分包集成。

(3) 未上架AppStore/Google Play可以创建应用吗

可以。 AppStore上架/Google Play上架处选“否”，然后按指引填写所需信息即可。若后续应用上架AppStore或Google Play，建议再返回此处修改状态。

(4) 应用未上架商店，是否可以先集成topon SDK并测试？

可以。若应用未上架商店还无法在各广告平台创建参数，可以使用TopOn的测试模式或者使用TopOn提供的demo ID进行集成测试，待创建各广告平台参数后再配置在TopOn后台。>>TopOn SDK测试指引

(5) TopOn的应用ID（App ID）如何获取

路径：TopOn后台→【应用管理】→应用ID（App ID）

6.2 广告位和广告场景相关

(1) TopOn的广告位ID（Placement ID）如何获取

路径：TopOn后台→【应用管理】→广告位ID（Placement ID）

(2) TopOn的广告场景ID（Scenario id）如何获取

路径：TopOn后台→【应用管理】→【场景管理】→广告场景ID（Scenario id）

(3) 不小心误删了应用/广告位/广告场景怎么办？

不支持开发者直接在TopOn后台恢复已删除的应用/广告位/广告场景，如有需要，请联系TopOn商务运营团队。

(4) TopOn是否可以进行广告内容屏蔽？

TopOn不支持屏蔽各三方广告平台的广告内容，若需要屏蔽某一指定广告，需在各三方广告平台后台进行屏蔽设置。若有使用TopOn ADX，请联系TopOn商务运营团队进行素材审核和屏蔽。

(5) 什么是激励数量

TopOn后台支持设置激励数量，通过reward_amount返回，开发者可以根据在后台设定返回这个值去下发奖励，也可以根据自己的规则去下发奖励。

(6) 广告位和广告场景的区别

① TopOn的一个广告位对应一个瀑布流，对应一套三方广告平台的代码位ID，可以精确区分每个广告位的真实收益。

② TopOn的一个广告位可对应多个广告场景，一个广告位下的多个广告场景共用一个瀑布流。

③ 可精确区分每个广告位的真实收益，但无法精确区分每个广告场景的真实收益。

(7) 广告场景的适用场景及优点

① 广告场景的适用场景：应用内广告场景很多，如不同广告场景使用不同的广告位ID以及不同的瀑布流策略，会造成运营成本高、效率低，此时建议使用TopOn的广告场景功能。

eg：某一游戏内有3个激励视频广告入口，分别为签到激励、复活激励、免费道具激励。该3个广告入口可共用同一个TopOn的广告位ID，使用一套瀑布流策略，但同时又希望可以区分每个广告入口的数据表现，此时可以通过广告场景功能进行区分。创建3个广告场景ID（如下图），按帮助文档指引集成，即可区分不同广告场景的数据。>>如何使用广告场景功能？

② 广告场景功能的优点：

各家广告平台一般都建议单个代码位（TopOn的单个广告源）日展示最好达到5K以上才能达到机器学习门槛，ecpm也比较稳定，也更有机会分配到质量更高的广告；
全部广告位一起加载，可能会给用户设备带来压力。同时若有些入口比较深的广告位请求了广告但展示机会少，展示率低，也可能会降低广告位的权重，ecpm会下降；
降低运营成本，广告场景功能只需要对一个广告位运营即可，不需要管理多套瀑布流。

平台使用指南