实时竞价

能力说明

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

支持场景

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

服务端协议定义文档

文档链接

接入方式

SDK C2S bidding

名词释义

客户端竞标出价

能力调用

• 优量汇广告竞胜之后调用 sendWinNotificationWithPrice: 接口
• 优量汇广告竞胜失败之后调用 sendLossNotificationWithWinnerPrice:lossReason:winnerAdnID: 接口

接口协议

typedef NS_ENUM(NSInteger, GDTAdBiddingLossReason) {
    GDTAdBiddingLossReasonLowPrice          = 1,        // 竞争力不足
    GDTAdBiddingLossReasonLoadTimeout       = 2,        // 返回超时
    GDTAdBiddingLossReasonNoAd              = 3,        // 无广告回包
    GDTAdBiddingLossReasonAdDataError       = 4,        // 回包不合法
    GDTAdBiddingLossReasonOther             = 10001     // 其他
};

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

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

SDK S2S bidding

名词释义

服务端竞标出价

能力调用

• 通过 [GDTSDKConfig getBuyerId] 获取 buyerId, 用来获取本条竞价广告的 token
• 调用 initWithPlacementId:token 方法来获取竞价的那条广告
• 优量汇广告竞胜后需要调用 setBidECPM: 接口

接口协议

// GDTSDKConfig  增加新接口
/**
 获取 buyerId 用于 Server Bidding 请求获取 token, 建议每次请求前调用一次, 并使用最新值请求
 */
+ (NSString *)getBuyerId;

/**
 *  构造方法, S2S bidding 后获取到 token 再调用此方法
 *  @param placementId  广告位 ID
 *  @param token  通过 Server Bidding 请求回来的 token
 */
- (instancetype)initWithPlacementId:(NSString *)placementId token:(NSString *)token;

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