实时竞价
能力说明
优量汇提供SDK接入的客户端和服务端实时竞价能力，开发者可根据自身需求选择不同的接入方式。
相比之下，客户端Bidding的接入成本更低，更适合竞价过程发生在客户端的开发者，优量汇优先推荐您通过此方式接入。
更多关于实时竞价的介绍、使用、常见问题可以参考帮助中心-实时竞价
支持场景
- 开屏广告
- 原生模板广告
- 自渲染广告
- 插屏半屏/全屏广告
- 激励视频广告
- banner 广告
服务端协议定义文档
接入方式
SDK C2S bidding
名词释义
客户端竞标出价
能力调用
- 优量汇广告竞胜之后调用
sendWinNotification接口 - 优量汇广告竞败之后或未参竞调用
sendLossNotification接口
数据协议
/**
* 竞价失败原因
*/
public interface BiddingLossReason {
int LOW_PRICE = 1; // 竞争力不足，如优量汇不是本次竞价的最高出价方，可上报此竞败原因
int NO_AD = 2; // 无广告回包，如优量汇在本次竞价中未返回广告，可上报此竞败原因
int NOT_COMPETITION = 101; // 有广告回包但是优量汇未参与竞价
int OTHER = 10001; // 其他（有回包）
}
/**
* 竞胜之后调用, 需要在调用广告 show 之前调用
* @param map - 必填，其中
* 键 IBidding.EXPECT_COST_PRICE 对应值为竞胜出价，类型为Integer。选填
* 键 IBidding.HIGHEST_LOSS_PRICE 对应值为最大竞败方出价，类型为Integer。选填
*/
void sendWinNotification(Map<String, Object> map);
/**
* 竞败之后或未参竞调用
* @param map - 必填，其中
* 键 IBidding.WIN_PRICE 值为本次竞胜方出价（单位：分），类型为Integer。选填
* 键 IBidding.LOSS_REASON 值为优量汇广告竞败原因，类型为Integer。必填
* 键 IBidding.ADN_ID 值为本次竞胜方渠道ID，类型为String。必填
* 对于【IBidding.ADN_ID】字段回传支持4个枚举值，分别代表：
* 1 - 输给优量汇其它非bidding广告位，当优量汇目标价报价为本次竞价的最高报价时，可上报此值，仅对混合比价类型的开发者适用
* 2 - 输给第三方ADN，当其它ADN报价为本次竞价的最高报价时，可上报此值，您无需回传具体竞胜方渠道；
* 3 - 输给自售广告主，当自售广告源报价为本次竞价的最高报价时，可上报此值，仅对有自售广告源的开发者使用；
* 4 - 输给优量汇其他bidding广告位，当优量汇其他bidding广告位报价为本次竞价的最高报价时，可上报此值，仅对有预加载或缓存池逻辑的开发者适用
*/
void sendLossNotification(Map<String, Object> map);
SDK S2S bidding
名词释义
服务端竞标出价
能力调用
- 通过
GDTAdSdk.getGDTAdManger().getBuyerId(Map<String, Object> map)获取 buyerId, 用来获取本条竞价广告的 token - 通过
GDTAdSdk.getGDTAdManger().getSDKInfo(String posId)获取 sdkInfo, 用来获取本条竞价广告的 sdkInfo (4.430.1300及以上SDK版本支持) - 调用 Demo 中示例增加 token 参数的构造函数来获取竞价的那条广告
接口设计
/**
* 获取 buyerId 用于 Server Bidding 请求获取 token, 建议每次请求前调用一次, 并使用最新值请求
* @param map 开发者自定义参数，无具体定义时可传null
*/
public String getBuyerId(Map<String, Object> map)
/**
* 获取 sdkInfo 参数，用于 Server Bidding 请求获取 sdkInfo, 建议每次请求前调用一次, 并使用最新值请求
* @param posId 广告位ID
*/
public String getSDKInfo(String posId)
/**
* 构造函数, S2S bidding 后获取到 token 再调用此方法
* 以激励视频为例，增加了如下构造函数
* @param placementId 广告位 ID
* @param token 通过 Server Bidding 请求回来的 token
*/
public RewardVideoAD(final Context context, final String posID,
final RewardVideoADListener rewardVideoADListener, final boolean volumeOn,
String token)