v2.0.0 版本接口升级说明

接口升级

本次版本升级，对于初始化API、模板广告API以及媒体渲染广告API进行了全面变更, 集成后请按照最新API接口文档进行接入。

SDK初始化

初始化SDK配置变更

// 2.0.0之前
JadYunSdkConfig config = new JadYunSdkConfig.Builder()
                .setAppId(APP_ID)//设置APPID
                .setEnableLog(BuildConfig.DEBUG) //设置日志开关
                .setCustomController(createCustomController()) //设置隐私控制器
                .build();

JadYunSdk.init(this, config);

// 2.0.0之后
JADYunSdkConfig config = new JADYunSdkConfig.Builder()
                .setAppId(APP_ID)//设置APPID
                .setEnableLog(BuildConfig.DEBUG)//设置日志开关
                .setPrivateController(createPrivateController())//设置隐私控制器 
                .build();

JADYunSdk.init(this, config);

隐私信息控制类变更

// 2.0.0之前
private JadCustomController createCustomController() {
        return new JadCustomController() {
            ...
        };
    }

// 2.0.0之后
private JADPrivateController createPrivateController() {
        return new JADPrivateController() {
            ...
        };
    }

其中，隐私信息控制器有3个接口配置有变更

1.获取IMEI信息配置接口

// 2.0.0之前
public String getDevImei() {
     ...
}

// 2.0.0之后
public String getImei() {
     ...
}

2.获取IP信息配置接口

// 2.0.0之前
public String getIp() {
    ...
}

// 2.0.0之后
 public String getIP() {
    ...
}

3获取地理位置信息配置接口

// 2.0.0之前
JadLocation getJadLocation() {
    ...
}

// 2.0.0之后
public JADLocation getLocation() {
    ...
}

京东渲染广告

京东渲染广告位配置变更

// 2.0.0之前
JadPlacementParams params = new JadPlacementParams.Builder()
                .setPlacementId(AD_ID) //广告位ID
                .setSize(widthDp, heightDp)//模板广告view的size,单位dp
                .setTolerateTime(3.5f) //京东渲染开屏广告加载容忍时间
                .setSkipTime(5) //京东渲染开屏倒计时时间 单位：秒
                .setSplashAdClickAreaType(JadPlacementParams.ClickStyle.SERVER)//京东渲染开屏广告点击类型
                .setCloseHide(false) //是否隐藏关闭按钮，仅支持横幅广告、信息流广告

                .build();

// 2.0.0之后
JADSlot slot = new JADSlot.Builder()
                .setSlotID(SLOT_ID)//广告位ID
                .setSize(widthDp, heightDp)//模板广告view的size,单位dp
                .setTolerateTime(mTolerateTime) //京东渲染开屏广告加载容忍时间
                .setSkipTime(mSkitTime) //京东渲染开屏广告倒计时时间 单位：秒
                .setSplashClickAreaType(JADSlot.ClickStyle.SERVER)//京东渲染开屏广告点击类型
                .setCloseButtonHidden(false)//是否隐藏关闭按钮，仅支持京东渲染横幅广告和京东渲染信息流广告
                .build();

京东渲染广告位请求接口变更

1.京东渲染开屏广告请求接口变更

// 2.0.0之前
//京东渲染广告位对象初始化
JadSplash splash = new JadSplash(context, params, new JadListener() {
    ...
});
//京东渲染广告位对象请求
splash.loadAd();

// 2.0.0之后
//京东渲染广告位对象初始化
JADSplash splash = new JADSplash(context, slot);
//京东渲染广告位对象请求
splash.loadAd(new JADSplashListener() {
    ...
});

2.京东渲染信息流广告请求接口变更

// 2.0.0之前
//京东渲染广告位对象初始化
JadFeed feed = new JadFeed(context, params, new JadListener() {
    ...
});
//京东渲染广告位对象请求
feed.loadAd();

// 2.0.0之后
//京东渲染广告位对象初始化
JADFeed feed = new JADFeed(context, slot);
//京东渲染广告位对象请求
feed.loadAd(new JADFeedListener() {
    ...
});

京东渲染广告的回调接口变更

// 2.0.0之前

public interface JadListener {
    //加载成功
    void onAdLoadSuccess();
    //加载失败
    void onAdLoadFailed(int code, String error);
    //渲染成功
    void onAdRenderSuccess(View view);
    //渲染失败
    void onAdRenderFailed(int code, String error);
     //曝光
    void onAdExposure();
    //点击
    void onAdClicked();
    //关闭
    void onAdDismissed();
}


// 2.0.0之后

//京东渲染开屏广告回调
public interface JADSplashListener {
    //广告加载成功
    void onLoadSuccess();
    //广告加载失败
    void onLoadFailure(int code, String error);
    //广告视图渲染成功
    void onRenderSuccess(View view);
    //广告渲染失败
    void onRenderFailure(int code, String error);
    //广告曝光
    void onExposure();
    //广告被点击
    void onClick();
    //广告被关闭
    void onClose();
}

//京东渲染信息流广告回调
public interface JADFeedListener {
    //广告加载成功
    void onLoadSuccess();
    //广告加载失败
    void onLoadFailure(int code, String error);
    //广告视图渲染成功
    void onRenderSuccess(View view);
    //广告渲染失败
    void onRenderFailure(int code, String error);
    //广告曝光
    void onExposure();
    //广告被点击
    void onClick();
    //广告被关闭
    void onClose();
}

//京东渲染横幅广告回调
public interface JADBannerListener {
    //广告加载成功
    void onLoadSuccess();
    //广告加载失败
    void onLoadFailure(int code, String error);
    //广告视图渲染成功
    void onRenderSuccess(View view);
    //广告渲染失败
    void onRenderFailure(int code, String error);
    //广告曝光
    void onExposure();
    //广告被点击
    void onClick();
    //广告被关闭
    void onClose();
}

//京东渲染插屏广告回调
public interface JADInterstitialListener {
    //广告加载成功
    void onLoadSuccess();
    //广告加载失败
    void onLoadFailure(int code, String error);
    //广告视图渲染成功
    void onRenderSuccess(View view);
    //广告渲染失败
    void onRenderFailure(int code, String error);
    //广告曝光
    void onExposure();
    //广告被点击
    void onClick();
    //广告被关闭
    void onClose();
}

京东渲染广告获取价格接口变更

此处以开屏模板广告为例：

// 2.0.0之前
 int price = jadSplash.getJadExtra().getPrice();

// 2.0.0之后
int price = mJADSplash.getJADExtra().getPrice();

媒体渲染广告

• 媒体渲染广告位配置变更

// 2.0.0之前
JadNativeSlot params = new JadNativeSlot.Builder()
                .setPlacementId(AD_ID) //广告位ID
                .setImageSize(imageWidth, imageHeight)//广告素材尺寸,dp
                .setSkipTime(5)
                .setInteractionType(JadNativeSlot.InteractionType.NORMAL)
                .build();


// 2.0.0之后
JADSlot slot = new JADSlot.Builder()
                .setSlotID(SLOT_ID) //广告位ID
                .setImageSize(imageWidth, imageHeight) //广告素材尺寸,dp
                .setSkipTime(5)//开屏广告的跳过时间
                .setAdType(JADSlot.AdType.SPLASH)//媒体渲染广告类型
                .setInteractionType(JADSlot.InteractionType.NORMAL)//媒体渲染广告交互类型
                .build();

媒体渲染广告位请求接口变更

// 2.0.0之前
//媒体渲染开屏广告请求
JadNative.getInstance().loadSplashAd(context, params, new JadNativeAdCallback() {
    ...
});

//媒体渲染信息流广告请求
JadNative.getInstance().loadFeedAd(context, params, new JadNativeAdCallback() {
    ...
});

// 2.0.0之后
JADNative mJADNative = new JADNative(slot);
mJADNative.loadAd(new JADNativeLoadListener() {
    ...
});

媒体渲染广告的回调接口变更

1.请求广告接口回调

// 2.0.0之前
public interface JadNativeAdCallback {
    // 加载完成
    void nativeAdDidLoad(JadNativeAd nativeAd);
    //加载失败
    void nativeAdDidFail(JadNativeAd nativeAd, JadError error);

}

// 2.0.0之后
public interface JADNativeLoadListener {
    //加载完成
    void onLoadSuccess();
    //加载失败
    void onLoadFailure(int code, String error);
}

2.交互接口回调

// 2.0.0之前
//开屏广告回调监听
public interface JadSplashNativeAdInteractionListener {
    //广告曝光
    void nativeAdBecomeVisible(JadNativeAd nativeAd);
    //广告点击
    void nativeAdDidClick(JadNativeAd nativeAd, View view);
    //广告关闭
    void nativeAdDidClose(JadNativeAd nativeAd, View view);
    //广告倒计时
    void nativeAdForSplashCountdown(JadNativeAd ad, int time)

}

//其他广告回调监听
public interface JadNativeAdInteractionListener {
    //广告曝光
    void nativeAdBecomeVisible(JadNativeAd nativeAd);
    //广告点击
    void nativeAdDidClick(JadNativeAd nativeAd, View view);
    //广告关闭
    void nativeAdDidClose(JadNativeAd nativeAd, View view);
}


// 2.0.0之后
//开屏广告回调监听
public interface JADNativeInteractionListener {
    //广告曝光
    void onExposure();
    //广告被点击
    void onClick(View view);
    //广告关闭
    void onClose(View view);

}

//其他广告回调监听
public interface JADNativeInteractionListener {
    //广告曝光
    void onExposure();
    //广告被点击
    void onClick(View view);
    //广告关闭
    void onClose(View view);
    //广告倒计时
    void onCountdown(int time);
}

广告数据接口变更

// 2.0.0之前
public List<JadMaterialData> getDataList();

// 2.0.0之后
public List<JADMaterialData> getDataList();

广告组件接口变更

此处以获取广告Logo举例：

// 2.0.0之前
JadNativeAd.getLogo()

// 2.0.0之后
JADNativeWidget.getLogo(context);