Bidding Android iOS 快应用 SDK H5 SDK Media API 常见问题

实时竞价

能力说明

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

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

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

支持场景

服务端协议定义文档

优量汇Server Bidding接口文档

接入方式

SDK C2S bidding

名词释义

客户端竞标出价

能力调用

接口协议

/**
* 竞价失败原因
  */
typedef NS_ENUM(NSInteger, GDTAdBiddingLossReason) {
    GDTAdBiddingLossReasonLowPrice          = 1,        // 有广告回包,竞败(竞争力不足)
    GDTAdBiddingLossReasonNoAd              = 2,        // 无广告回包
    GDTAdBiddingLossReasonAdSuccNoBid       = 101,      // 有回包但未竞价
    GDTAdBiddingLossReasonOther             = 10001     // 其他
};

/**
 *  竞胜之后调用, 需要在调用广告 show 之前调用
 *
 *  @param winInfo 竞胜信息,字典类型,必填,支持的key为以下内容。注:key是个宏,在GDTAdProtocol.h中有定义,可以参考demo中的使用方法
 *  GDT_M_W_E_COST_PRICE:竞胜价格 (单位: 分),选填。值类型为NSNumber *
 *  GDT_M_W_H_LOSS_PRICE:最高失败出价,选填。值类型为NSNumber *
 *
 */- (void)sendWinNotificationWithInfo:(NSDictionary *)winInfo;     

/**
 *  竞败之后或未参竞调用
 *
 *  @pararm lossInfo 竞败信息,字典类型,必填,支持的key为以下内容。注:key是个宏,在GDTAdProtocol.h中有定义,可以参考demo中的使用方法
 *  GDT_M_L_WIN_PRICE :竞胜价格 (单位: 分),选填。值类型为NSNumber *
 *  GDT_M_L_LOSS_REASON :优量汇广告竞败原因,必填。竞败原因参考枚举GDTAdBiddingLossReason中的定义,值类型为NSNumber *
 *  GDT_M_ADNID :竞胜方渠道ID,必填。值类型为NSString *
 *         对于【GDT_M_ADNID】字段回传支持4个枚举值,分别代表:
 *         1 - 输给优量汇其它非bidding广告位,当优量汇目标价报价为本次竞价的最高报价时,可上报此值,仅对混合比价类型的开发者适用;
 *         2 - 输给第三方ADN,当其它ADN报价为本次竞价的最高报价时,可上报此值,您无需回传具体竞胜方渠道;
 *         3 - 输给自售广告主,当自售广告源报价为本次竞价的最高报价时,可上报此值,仅对有自售广告源的开发者使用;
 *         4 - 输给优量汇其他bidding广告位,当优量汇其他bidding广告位报价为本次竞价的最高报价时,可上报此值,仅对有预加载或缓存池逻辑的开发者适用
 */
- (void)sendLossNotificationWithInfo:(NSDictionary *)lossInfo;

SDK S2S bidding

名词释义

服务端竞标出价

能力调用

接口协议

/**
 *  获取 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;

 文档反馈

腾讯公司 版权所有