Bidding Android iOS Unity JS API Media API 常见问题

实时竞价

能力说明

优量汇提供SDK接入的客户端和服务端实时竞价能力,开发者可根据自身需求选择不同的接入方式。

相比之下,客户端Bidding的接入成本更低,更适合竞价过程发生在客户端的开发者,优量汇优先推荐您通过此方式接入。

更多关于实时竞价的介绍、使用、常见问题可以参考帮助中心-实时竞价

支持场景

服务端协议定义文档

优量汇Server Bidding接口文档

接入方式

SDK C2S bidding

名词释义

客户端竞标出价

能力调用

数据协议

/**
 * 竞价失败原因
 */
public interface BiddingLossReason {
  int LOW_PRICE = 1; // 竞争力不足,如优量汇不是本次竞价的最高出价方,可上报此竞败原因
  int TIME_OUT = 2; // 返回超时,如优量汇在本次竞价中未返回广告,可上报此竞败原因,预计22/7月可支持
  int OTHER = 10001;
}

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

/**
 *  竞败之后或未参竞调用
 *  @param price - 本次竞胜方出价(单位:分),选填
 *  @param reason - 优量汇广告竞败原因,必填
 *  @param adnID - 本次竞胜方渠道ID,必填;
 *         对于【adnID】字段回传支持3个枚举值,分别代表:
 *         1 - 输给优量汇其它广告,当优量汇目标价报价为本次竞价的最高报价时,可上报此值,仅对混合比价类型的开发者适用
 *         2 - 输给第三方ADN,当其它ADN报价为本次竞价的最高报价时,可上报此值,您无需回传具体竞胜方渠道;
 *         3 - 输给自售广告主,当自售广告源报价为本次竞价的最高报价时,可上报此值,仅对有自售广告源的开发者使用;
 */
 void sendLossNotification(int price, int reason, String adnId);

SDK S2S bidding

名词释义

服务端竞标出价

能力调用

接口设计

  /**
   * 获取 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)
  /**
   *  SDK 版本 4.410.1280 及以上支持, 之前版本请调用 sendWinNotification 方法
   *  S2S bidding 竞胜之后调用, 需要在调用广告 show 之前调用
   *  @param price - 曝光扣费, 单位分,若优量汇竞胜,在广告曝光时回传,使用二价计费类型的开发者必传,一价计费类型的开发者可忽略此值,无需回传
   *
   *  计费类型说明:计费类型为广告曝光时,媒体侧期望使用的计费逻辑,常用计费类型包括一价计费与二价计费,
   *  当采用一价计费时,胜者出价即为本次的计费和结算价格,您无需进行计费数据回传,系统将默认按照一价计费和结算;
   *  当采用二价计费时,第二名出价为本次计费和结算价格,为保证结算和出价的准确性,请二价计费开发者保证计费数据准确、全面回传.
   */
  public void setBidECPM(int price)

 文档反馈

腾讯公司 版权所有