Android iOS Unity JS API Media API 常见问题

实时竞价

能力说明

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

支持场景

服务端协议定义文档

文档链接

接入方式

SDK C2S bidding

名词释义

客户端竞标出价

能力调用

接口协议

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  增加新接口
/**
 获取 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;

Copyright © 1998 - 2020 Tencent Inc. All Rights Reserved.
腾讯公司 版权所有 | 加入优量汇