实时竞价

能力说明

优量汇提供SDK接入的客户端和服务端实时竞价能力，开发者可根据自身需求选择不同的接入方式。基于性能和安全性的考虑，我们更推荐您使用服务端竞价（Server-to-Server）的能力。

支持场景

• 开屏广告
• 原生模板广告
• 自渲染广告
• 插屏半屏/全屏广告
• 激励视频广告
• banner 广告

服务端协议定义文档

文档链接

接入方式

SDK C2S bidding

名词释义

客户端竞标出价

能力调用

• 优量汇广告竞胜之后调用 sendWinNotification 接口
• 优量汇广告竞胜失败之后调用 sendLossNotification 接口

数据协议

/**
 * 竞价失败原因
 * 1、竞争力不足；2、返回超时；3、无广告回包；4、回包不合法；10001:其他
 */
public interface BiddingLossReason {
  int LOW_PRICE = 1;
  int TIME_OUT = 2;
  int NO_AD = 3;
  int AD_DATA_ERROR = 4;
  int OTHER = 10001;
}

/**
 *  竞胜之后调用, 需要在调用广告 show 之前调用
 *  @param price - 本次竞胜方出价（单位：分），必填
 */
 void sendWinNotification(int price);     

/**
 *  竞败之后调用
 *  @param price - 本次竞胜方出价（单位：分），选填
 *  @param reason - 优量汇广告竞败原因，必填
 *  @param adnID - 本次竞胜方渠道ID，选填；如加密回传，请保持加密方式的统一性
 */
 void sendLossNotification(int price, int reason, String adnId);

SDK S2S bidding

名词释义

服务端竞标出价

能力调用

• 通过 GDTAdSdk.getGDTAdManger().getBuyerId() 获取 buyerId, 用来获取本条竞价广告的 token
• 调用 Demo 中示例增加 token 参数的构造函数来获取竞价的那条广告
• 优量汇广告竞胜后需要调用 setBidECPM 接口

接口设计

// IGDTAdManager  增加新接口
/**
 获取 buyerId 用于 Server Bidding 请求获取 token, 建议每次请求前调用一次, 并使用最新值请求
 */
com.qq.e.comm.managers.IGDTAdManager#getBuyerId;

/**
 *  构造函数, 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)

/**
 *  SDK 版本 4.410.1280 及以上支持, 之前版本请调用 sendWinNotification 方法
 *  S2S bidding 竞胜之后调用, 需要在调用广告 show 之前调用
 *  @param price - 曝光扣费, 单位分，若优量汇竞胜，在广告曝光时回传，必传
 *  针对本次曝光的媒体期望扣费，常用扣费逻辑包括一价扣费与二价扣费，当采用一价扣费时，胜者出价即为本次扣费价格；当采用二价扣费时，第二名出价为本次扣费价格.
 */
  public void setBidECPM(int price)