实时竞价
能力说明
优量汇提供SDK接入的客户端和服务端实时竞价能力，开发者可根据自身需求选择不同的接入方式。
相比之下，客户端Bidding的接入成本更低，更适合竞价过程发生在客户端的开发者，优量汇优先推荐您通过此方式接入。
更多关于实时竞价的介绍、使用、常见问题可以参考帮助中心-实时竞价
支持场景
- 开屏广告
- 原生模板广告
- 自渲染广告
- 插屏半屏/全屏广告
- 激励视频广告
- banner 广告
服务端协议定义文档
接入方式
SDK C2S bidding
名词释义
客户端竞标出价
能力调用
- 优量汇广告竞胜之后调用
sendWinNotificationWithInfo:接口 - 优量汇广告竞败之后或未参竞调用
sendLossNotificationWithInfo:接口
接口协议
/**
* 竞价失败原因
*/
typedef NS_ENUM(NSInteger, GDTAdBiddingLossReason) {
GDTAdBiddingLossReasonLowPrice = 1, // 竞争力不足，如优量汇不是本次竞价的最高出价方，可上报此竞败原因
GDTAdBiddingLossReasonLoadTimeout = 2, // 返回超时，如优量汇在本次竞价中未返回广告，可上报此竞败原因
GDTAdBiddingLossReasonOther = 10001 // 其他
};
/**
* 竞胜之后调用, 需要在调用广告 show 之前调用
*
* @param winInfo 字典类型，必填。支持的key有
* GDT_M_W_E_COST_PRICE：竞胜价格 (单位: 分)，值类型为NSNumber *
* GDT_M_W_H_LOSS_PRICE：最高失败出价，值类型为NSNumber *
*
*/- (void)sendWinNotificationWithInfo:(NSDictionary *)winInfo;
/**
* 竞败之后或未参竞调用
*
* @pararm lossInfo 竞败信息，字典类型，必填，支持的key有
* GDT_M_L_WIN_PRICE ：竞胜价格 (单位: 分)，选填。值类型为NSNumber *
* GDT_M_L_LOSS_REASON ：优量汇广告竞败原因，必填。竞败原因参考枚举GDTAdBiddingLossReason中的定义，值类型为NSNumber *
* GDT_M_ADNID ：竞胜方渠道ID，必填。值类型为NSString *
* 对于【GDT_M_ADNID】字段回传支持3个枚举值，分别代表：
* 1 - 输给优量汇其它广告，当优量汇目标价报价为本次竞价的最高报价时，可上报此值，仅对混合比价类型的开发者适用
* 2 - 输给第三方ADN，当其它ADN报价为本次竞价的最高报价时，可上报此值，您无需回传具体竞胜方渠道；
* 3 - 输给自售广告主，当自售广告源报价为本次竞价的最高报价时，可上报此值，仅对有自售广告源的开发者使用；
*/
- (void)sendLossNotificationWithInfo:(NSDictionary *)lossInfo;
SDK S2S bidding
名词释义
服务端竞标出价
能力调用
- 通过
[GDTSDKConfig getBuyerIdWithContext:nil]获取 buyerId, 用来获取本条竞价广告的 token - 通过
[GDTSDKConfig getSDKInfoWithPlacementId]获取 SDKInfo，用来获取本条竞价广告的 token (4.13.30及以上SDK版本支持) - 调用
initWithPlacementId:token方法来获取竞价的那条广告 - 优量汇广告竞胜后需要调用
setBidECPM:接口
接口协议
/**
* 获取 buyerId 用于 Server Bidding 请求获取 token, 建议每次请求前调用一次, 并使用最新值请求
*/
+ (NSString *)getBuyerIdWithContext:(NSDictionary *)info;
/**
* 获取用于 Server Bidding 请求SDK侧相关请求参数信息, 建议每次请求前调用一次, 并使用最新值请求
* @param placementId 广告位 ID
*/
+ (NSString *)getSDKInfoWithPlacementId:(NSString *)placementId;
/**
* 构造方法, 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;