实时竞价

能力说明#

游可赢SDK为接入方提供客户端实时竞价的能力。在请求到广告后，可以通过接口查询到该广告的价格，该价格可用于在不同广告之间比价。广告比价结束后，开发者可调用对应的接口将竞价结果上报至服务端，以提高后续的广告竞价效率。

权限：实时竞价需申请后才可使用。申请请联系商务经理。

竞价流程#

获取广告价格#

开发者在获取到广告内容后，可以通过广告对象获取到广告的价格，以SplashAd为例：

public abstract class SplashAd {
    /**
     * 返回 Effective Cost Per Mille
     * 即千次曝光收益（成本）
     * @return 数值，单位分
     */
    public abstract int getECPM();
}

广告比价#

开发者向多个平台发起广告请求后，可以使用不同平台的广告价格进行比价。

竞价结果调用#

游可赢广告竞胜后，在广告展示前调用 sendWinNotificationWithPrice 接口。

游可赢广告竞败后，调用 sendLossNotificationWithWinnerPrice 接口。

/**
 * @param price - 本次竞胜方出价（单位：分），必填
 */
void sendWinNotificationWithPrice(int price);

/**
 * 竞败之后或未参竞调用
 *
 * @param price：本次竞胜方出价，单位分。选填
 * @param reason: 广告竞价失败原因，见 BiddingLossReason 枚举值。必填。
 * @param adnId：本次竞胜方渠道ID，见 AdnId 枚举值。选填。
 */
sendLossNotificationWithWinnerPrice(int price, int reason, String adnId);
/**
 * 竞价失败原因
 * 2711、价格过低，竞争力不足；2712、返回超时；2713、无广告返回；2714、其他原因
 */
public interface BiddingLossReason {
    int LOW_PRICE = 2711;
    int TIME_OUT = 2712;
    int NO_AD = 2713;
    int OTHER = 2714;
}
/**
 * 竞胜方的渠道id
 * 1 - 输给游可赢其他广告，2 - 输给第三方广告ADN，3 - 输给自售广告主
 */
public interface AdnId {
    String YKY_AD = "1";
    String THIRD_PARTY = "2";
    String SELF_OWN = "3";
}