优量汇Reporting API如何接入

接入方法详见链接：https://www.csjplatform.com/supportcenter/27654#vrl70wtr1cw0。

GroMore目前支持通过reporting api的方式给GroMore回传优量汇、快手后台的数据，在GroMore后台以API数据呈现。

错误码10086(iOS)&20005(android)的排查建议

10086(iOS) & 20005(android)错误码含义为「全部代码位请求失败」,代表该广告位(瀑布流)下配置的所有代码位均无广告填充,建议按照下述方式进行排查和优化:

1. 优先确认该广告位(瀑布流)下是否有添加"竞价代码位"or"兜底代码位",一般情况下,这两类代码位的填充率在95%+,确保广告位(瀑布流)至少有一个广告填充;
2. 如已添加"竞价代码位"or"兜底代码位",可先重点排查这两类代码位的诊断分析,根据对应的广告无填充原因及优化建议进行调整;
3. 如在测试阶段,为尽快测试链路是否通顺,建议可使用测试式代码位进行测试(测试代码位不计费,正式上线前需更新代码位状态),或在后台「广告变现-辅助工具-测试工具」汤添加测试信息进行测试。

4. 1.Android端请通过检索TMe/mediation排查对应错误日志;iOS端请通过检索ABUSDK排查对应错误日志,查看填充失败原因
5. 在瀑布流详情页通过点击代码位右侧三个点->点击诊断分析->查看广告无填充的具体原因
6. 当通过日志/诊断分析无法排查时可通过抓包明确adn具体错误码,抓包可参考穿山甲广告抓包:https://www.csjplatform.com/supportcenter/5419

如仍有疑问，可点击工单选择【SDK产品技术问题-错误码咨询】版块详细描述您的问题，技术同学将会在1个工作日内给您答复，感谢您的支持

GroMore和优量汇看到的请求量不一样

"1.确认下该代码位是否存在复用问题 2.两个请求量的对比是否是API数据对比情况 3.需要了解优量汇后台的广告位请求量的定义是 4.需要以这边的请求API数据为准，M目前仅对首次请求的数据作统计"

banner广告是否可以支持轮播功能？

支持轮播，但是设置轮播后对应banner的轮播都是由各自的adn实现，后续广告轮播展示时不会有内部的请求返回回调，可能会导致banner使用轮播后数据存在gap的问题。具体数据差异参见帮助中心文档。

GroMore排序价格、eCPM、eCPM API与穿山甲期望eCPM的区别是？

详见：https://www.csjplatform.com/supportcenter/5884#cfq6h6kybg80

• 穿山甲的期望CPM，是在穿山甲ADN下，【流量-代码位】中新建代码位时，设置的“期望CPM”，即该代码位的真实底价。
• GroMore 排序价格：即在瀑布流下/在GroMore中添加代码位时填写的价格，该价格仅用于在瀑布流中给该代码位排序与计算预估收益，而非真实期望CPM。
• GroMore eCPM=预估收益*1000/展示量，其中预估收益根据排序价格计算，均为预估数据
• GroMore eCPM API=收益API*1000/展示API，均为API数据

如何做预缓存

预缓存功能不需要申请，开发者可自行设置：在使用广告之前，先请求下来广告，到需要展示的场景调用广告展示的方法即可。

【需要注意】

（1）每次请求广告都需要新创建一个AdSlot参数 新创建一个广告对象

（2）展示完广告之后需要把广告对象置空处理

（3）不建议在广告show回调中做请求广告的逻辑处理

建议使用GroMore预缓存功能。详见帮助中心文档

如何接入第三方ADN Reporting API

GroMore聚合支持ADN报表API数据，如需使用ADN报表API数据，请注册GroMore官方合作伙伴“DMPlatform”账号（点击链接可跳转），通过“DMPlatform”的技术服务同步各ADN的报表数据，再通过DMPlatform的API Key授权穿山甲聚合平台获取相关数据。详细操作步骤请点击链接查看：https://www.csjplatform.com/supportcenter/27654

GroMore预估收益

GroMore中，标准代码位预估收益=瀑布流中设置的排序价格*Gromore统计的展示量/1000；

竞价代码位预估收益=每次展示对应的实时价格；

可根据需求查看对应的GroMore数据指标定义

GroMore-API数据与预估数据存在gap

预估数据(如预估收益、请求量、返回量等)是GroMore通过GroMore SDK的埋点统计的数据；

API数据(如收益API、请求API、返回API等)是GroMore通过reporting API获取的数据；

两者由于网络环境、口径差异等情况可能存在GAP，如GAP率在5%以内可暂时忽略；如GAP率较大可先定位有差异的应用/广告位/代码位，再排查是由展示量或eCPM带来的差异，可参考自查指南进行详细排查，如仍有疑问，可提交工单排查，工单内提供以下信息：

1.广告样式

2.应用ID

3.广告位ID

4.代码位ID

5.操作系统

6.MSDK版本号

7.问题发生具体时间段

8.问题详细描述

9.问题对应截图

为什么某应用下明明创建了穿山甲代码位，但是在创建瀑布流时没有可选的代码位？

只有在满足以下条件时穿山甲代码位才可以被添加到瀑布流中： 1. 代码位在创建时选择了【用于GroMore聚合】 2. 代码位处于该应用的该代码位类型下 3. 代码位没有被用在穿山甲聚合的其他瀑布流中

展示率有问题

请确认是否有开启预缓存功能/使用预缓存机制。 因预缓存适用于展示时机密集的场景，如展示时机不密集、用户IPU较低，预缓存广告利用率不高，将会拉低展示率的分子“展示量”，而拉高展示率的分母“返回量”，即预缓存的返回没有被展示，利用率低。 预缓存广告如超过1小时未展示则失效，将影响展示率变低，请合理使用预缓存功能，如需使用请及时展示缓存广告，也可参看该文档:https://www.csjplatform.com/growthcenter/610127b000195d0046c2732f?subjectId=26179&live=1

流量请求量/流量返回量/流量填充率 与 广告请求量/广告返回量/广告填充率 之间的区别

流量请求量/流量返回量/流量填充率是GroMore（聚合工具）维度的特殊指标，即从流量/用户维度来统计请求量、返回量、填充率；

广告请求量/广告返回量/广告填充率可参考穿山甲ADN/GroMore后台的解释，即代码位维度的指标。

一条流量请求量、流量返回量会对应多条广告请求量、广告返回量。

点击链接https://www.csjplatform.com/supportcenter/5884#yk4qcc2evkg0详见例子。

GroMore数据指标说明

您好，GroMore各数据指标含义请参考链接：https://www.csjplatform.com/supportcenter/28095

是否支持展示时返回bidding价格

为满足买量变现开发者测算ROI的需求，bidding目前已支持在bidding获胜时返回真实价格，调用时机需要在展示（show）之后，过早调用可能会导致没有值返回。您可以直接调用接口获取相关内容，技术对接文档搜索platform可以看到相关字段“getPreEcpm”；bidding详细功能介绍可点击查看 >>https://www.csjplatform.com/supportcenter/5854

GroMore能否获取每个用户的ecpm

GroMore中没有用户维度的ecpm数据，不支持获取用户ecpm

设置底价的代码位填充率参考

ecpm底价越高则对应代码位填充率越低，设置底价的代码位填充率建议控制在5%以上，最低不少于1%

流量分组

流量分组是指，开发者可从不同维度对流量进行分组，配置不同的瀑布流，对流量进行精细化运营。详细使用指南可点击链接查看：https://www.csjplatform.com/support/doc/60bc3ab9951e61004726e599

Gap率是？怎么利用这个指标？

Gap率是指预估数据与API数据之间的差异。

建议分析方法：请求gap率、返回gap率建议分析代码位维度数据，因请求gap率=（广告请求量-请求量API）/请求API，返回gap率同理，均为代码位维度的数据。不建议用来分析应用、广告位、瀑布流的数据。展示gap率=（展示量-展示api）/ 展示api，代码位、瀑布流、广告位、应用维度的数据均可分析。

GroMore中如何获取小时级/天级数据

开通GroMore后，点击【接入】-【数据与内容接收】，在【聚合数据报告API文档】模块下，点击【查看接入文档】，选择【小时级数据API】或【天级数据API】，即可获取相应的API接入文档。需注意：仅返回用于穿山甲聚合内的流量的数据。

创建穿山甲应用和代码位时，【用于GroMore聚合】属性应该如何选择？

在[穿山甲开发者平台-流量]创建代码位时，选择应用后便可以看到代码位【是否用于GroMore聚合】的选项。如果选择“用于GroMore聚合”，便可在GroMore聚合平台中使用该代码位，但不能在GroMore外使用；选择“否”则不可在GroMore聚合平台使用，但可以正常在GroMore聚合平台外使用。注意，同一个代码位不能同时在GroMore内外使用。 如果选择的应用尚未加入GroMore聚合，则需要先点击启用，再创建GroMore聚合内代码位。或直接在GroMore聚合页面内添加穿山甲应用至GroMore，再创建GroMore聚合内代码位。

穿山甲插屏对应GroMore全屏还是插屏？

穿山甲的新插屏在GroMore下归属于全屏

底价设置在什么范围内比较合适

"基于通跑ecpm设置各层价格：首先，在各家广告网络采用不设底价代码位通跑得到ecpm；其次，选择ecpm更高的广告网络，然后，将对应广告网络的ecpm作为基准，乘以 2-3倍作为首层价格；然后，观察首层代码位填充率进行微调后作为最终价格；最后，以此类推设置后面层级的底价。 可以链接一个：https://www.csjplatform.com/support/doc/61165f3f46b9a2004893f01b"

为什么有些代码位的填充率api>100%？

兜底代码位填充率api＞100%，跟a组b组代码位复用有关，请求量api、返回量api数据拆分是基于a组b组埋点上报的请求量、返回量占比预估拆分的。如若要做严格的ab测试，则建议a组、b组使用不同代码位id。

GroMore请求广告个数对收益的影响

聚合内是串行+并行的请求逻辑，开通并行自定义请求功能可设置并行请求层数，可以根据群公告内的指南进行具体设置，具体收益差异的对比可根据产品具体情况进行测试

我应该如何快速找到用于Gromore聚合的代码位？

在[穿山甲开发者平台-流量-代码位]的页面上方，展开筛选项便可筛选用于Gromore聚合的代码位。导出代码位信息的时候也可以看到代码位是否可以用于Gromore聚合。

底价设置过高

代码位的底价设置过高 本次广告出价低于此代码位的底价 导致该代码位无填充 如果该代码位整个的填充率小于5%可适当调整该代码位的底价

串并行策略

GroMore瀑布流属性配置包含【自定义并行及请求配置】，自定义并行请求，即媒体可自定义设置瀑布流中串并行请求方式和层数，当前支持【固定层数并行请求】和【固定数量并行请求】两种方式。详细可见>>瀑布流调优建议