插屏广告

一、创建广告配置参数：

注意：开发者需要自行根据 “requestId” 对广告的曝光和点击等去重；​

代码块

DMAdConfig config = new DMAdConfig()​
        .setRequestId("requestId")//替换真实的广告请求Id​
        .setCodeId("codeId"); //广告位id​

接口

含义

setCodeId(String codeId)

codeId：平台创建好广告后生成的广告位id

setRequestId(String requestId)

requestId：开发者自己生成的广告唯一请求id（可使用随机数），方便排查对数GAP问题。SDK-3.4.1 新增​

setInteractionAdClickCloseDialog（boolean closeDialog）

closeDialog: true：广告点击后关闭插屏弹框，默认false，点击广告不关闭插屏弹框。​

SDK-3.4.4 新增

三、请求展示广告相关接口

1.
请求广告​

代码块

DMAdSdk.getInstance().loadInteractionAdTemplate(activity, config, new DMLoadTemplateAdListener() {​
            @Override​
            public void onFailed(int code, String message) {​
               //广告请求失败​
            }​
​
            @Override​
            public void onSuccess(DMTemplateAd ad) {​
               //广告请求成功​
            }​
        });​

2.
竞价结果上报（竞价模式必接）​

如果开发者所使用的广告位属于竞价广告位，则需要获取当前广告报价，自行实现竞价逻辑。​

如果竞价成功，需上报竞胜价格，一般竞胜价格小于等于多盟侧出价，SDK服基于收到的竞胜价格对开发者计算收益。​

如果竞价失败，需上报最终成交价及原因，方便我们对响应的广告进行调整。​

示例如下：

代码块

public void onSuccess(DMTemplateAd ad) {​
    //获取当前广告报价，单位(分)​
    long bidPrice = ad.getBidPrice();​
    //处理竞价，一般遵循二价原则下，winPrice <= bidPrice​
    //getWinPrice() 需要开发者实现​
    //long winPrice = getWinPrice(bidPrice)​
    //竞价成功上报SDK，单位(分)​
    ad.biddingSuccess(winPrice);​
    //竞价失败上报，SDK3.2.0新增​
    ad.biddingFailed(winPrice, DMAdBiddingCode);​
}​

DMAdBiddingCode参数值如下，请按实际场景回传：

参数

含义

DMAdBiddingCode.UNKNOWN

未知

DMAdBiddingCode.NO_VALID_AD

无有效广告

DMAdBiddingCode.NO_VALID_PARAM

无有效参数（缺少必填字段）

DMAdBiddingCode.NO_VALID_SPEC

无有效规格

DMAdBiddingCode.TIMEOUT

超时

插屏广告​

插屏广告