JgAds Android Sdk——接入文档 V2.2.0.2

allprojects {
    repositories {
        ...
        google()
        jcenter()
        mavenCentral()
    }
}

dependencies {
    // support支持库，如果是AndroidX请使用对应的支持库
    implementation 'com.android.support:appcompat-v7:28.0.0'
    implementation 'com.android.support:support-v4:28.0.0'
    implementation 'com.android.support:design:28.0.0'

    // 极光Ads广告SDK
    implementation "cn.jiguang.sdk.ad.third:jgads:2.2.0.2"
}

ndk {
    // 设置支持的SO库架构，暂不支持x86
    abiFilters 'armeabi-v7a', 'arm64-v8a'
}

<!-- 广告必须的权限，允许网络访问 -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- 广告必须的权限，允许安装未知来源权限（如下载类广告下载完成后唤起安卓） -->
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES"/>
<!-- 广告必须的权限，地理位置权限，获取位置信息，用于广告投放。精准广告投放及反作弊 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- 广告必须的权限，为了避免投放错误的广告，以此提高用户的广告体验。若添加此权限，需要在您的用户隐私文档中声明！通过此权限在Android R系统上判定广告对应的应用是否在用户的设备上安装 -->
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" />

<!-- 广告可选权限，提升广告填充，允许应用检测网络状态，SDK 会根据网络状态选择是否发送数据 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 广告可选权限，提升广告填充，允许应用获取 MAC 地址。广告投放及广告监测归因、反作弊 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- 广告可选权限，提升广告填充，影响广告填充，强烈建议的权限，获取设备信息，允许应用获取手机状态（包括手机号码、IMEI、IMSI权限等）。广告投放及广告监测归因、反作弊 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<!-- 为了提高广告收益，建议设置的权限，获取粗略位置信息。精准广告投放及反作弊 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

<application
    android:name=".MyApplication"
        ... ...
    android:usesCleartextTraffic="true">

    <uses-library
        android:name="org.apache.http.legacy"
        android:required="false" />
    ... ...
</application>

# 极光混淆
-keep class com.junion.**{ *; }
-keep class junion.com.** { *; }
-keep interface junion.com.** { *; }

JgAds.getInstance().init(this, new JUnionInitConfig.Builder()
    ...
    //【慎改】是否同意隐私政策，将禁用一切设备信息读起严重影响收益
    .agreePrivacyStrategy(true)
    // 是否可获取定位数据
    .isCanUseLocation(true)
    // 是否可获取设备信息
    .isCanUsePhoneState(true)
    ...
    .build());

JgAds.getInstance().init(this, new JUnionInitConfig.Builder()
    ...
    .setCustomController(new JUnionCustomController() {
        /**
         * 当isCanUsePhoneState=false时，可传入imei信息，天目使用您传入的imei信息
         * @return imei信息
         */
        @Override
        public String getDevImei() {
            return super.getDevImei();
        }

        /**
         * 当isCanUsePhoneState=false时，可传入AndroidId信息，天目使用您传入的AndroidId信息
         * @return androidid信息
         */
        @Override
        public String getAndroidId() {
            return super.getAndroidId();
        }

        /**
         * 当isCanUseLocation=false时，可传入地理位置信息，天目使用您传入的地理位置信息
         * @return 极光地理位置参数JUnionLocationProvider
         */
        @Override
        public JUnionLocationProvider getLocation() {
            return super.getLocation();
        }

        /**
         * 当isCanUseWifiState=false时，可传入Mac地址信息，天目使用您传入的Mac地址信息
         * @return Mac地址
         */
        @Override
        public String getMacAddress() {
            return super.getMacAddress();
        }

        /**
         * 开发者可以传入oaid ，若不传或为空值，则不使用oaid信息
         * @return oaid
         */
        @Override
        public String getDevOaid() {
            return super.getDevOaid();
        }

        /**
         * 开发者可以传入vaid ，若不传或为空值，则不使用vaid信息
         * @return vaid
         */
        @Override
        public String getDevVaid() {
            return super.getDevVaid();
        }
    })
    ...
    .build());

// true开启个性化广告，false关闭个性化广告
JgAds.setPersonalizedAds(boolean enablePersonalized);

// 初始化JgAds广告SDK
JgAds.getInstance().init(this, new JUnionInitConfig.Builder()
    // 设置APPID，必须的
    .appId(String appId)
    // 是否开启Debug，开启会有详细的日志信息打印
    // 注意上线后请置为false
    .debug(BuildConfig.DEBUG)
    ...
    .build());

SplashAd splashAd = new SplashAd(Context context);
splashAd.setListener(new SplashAdListener() {
    @Override
    public void onAdTick(long millisUntilFinished) {
        // 倒计时剩余时长（单位：秒）
    }

    @Override
    public void onAdReceive(SplashAdInfo splashAdInfo) {
        // 广告获取成功回调，在此回调中展示广告
        // 获取开屏广告视图
        View view = splashAdInfo.getSplashAdView();
        // 将广告视图添加到容器中，注意容器高度要大于屏幕75%
        flContainer.addView(view);
        // 渲染广告，一定要最后调用
        splashAdInfo.render();
    }

    @Override
    public void onAdExpose(SplashAdInfo splashAdInfo) {
        // 广告展示回调
    }

    @Override
    public void onAdClick(SplashAdInfo splashAdInfo) {
        // 广告点击回调
    }

    @Override
    public void onAdSkip(SplashAdInfo splashAdInfo) {
        // 广告跳过回调
    }

    @Override
    public void onAdClose(SplashAdInfo splashAdInfo) {
        // 广告关闭回调，可在此处进入应用首页
    }

    @Override
    public void onAdFailed(JUnionError error) {
        // 广告失败回调，可在此处进入应用首页
    }
});
splashAd.loadAd(String posId);

BannerAd bannerAd = new BannerAd(Context context, ViewGroup container);
bannerAd.setListener(new BannerAdListener() {
    @Override
    public void onAdExpose(BannerAdInfo bannerAdInfo) {
        // 广告展示回调
    }

    @Override
    public void onAdClick(BannerAdInfo bannerAdInfo) {
        // 广告点击回调
    }

    @Override
    public void onAdClose(BannerAdInfo bannerAdInfo) {
        // 广告关闭回调
    }

    @Override
    public void onAdReceive(BannerAdInfo bannerAdInfo) {
        // 广告获取成功回调
    }

    @Override
    public void onAdFailed(JUnionError error) {
        // 广告失败回调
    }
});
bannerAd.loadAd(String posId);

NativeAd nativeAd = new NativeAd(Context context);
nativeAd.setListener(new NativeAdListener() {

    @Override
    public void onRenderFailed(NativeAdInfo nativeAdInfo, JUnionError error) {
        // 广告渲染失败回调
    }

    @Override
    public void onAdReceive(List<NativeAdInfo> nativeAdInfos) {
        // 广告获取成功回调
        if (nativeAdInfos == null || nativeAdInfos.size() == 0) {
            return;
        }
        NativeAdInfo nativeAdInfo = nativeAdInfos.get(0);
        if (nativeAdInfo != null) {
            // 注册视频监听
            setVideoListener(nativeAdInfo);
            // 判断是否为视频类广告
            if (nativeAdInfo.isVideo()) {
                // 获取视频视图控件
                View videoView = nativeAdInfo.getMediaView(flMaterialContainer);
                // 添加进布局
                JUnionViewUtil.addAdViewToAdContainer(flMaterialContainer, videoView);
            } else {
                ImageView imageView = new ImageView(flMaterialContainer.getContext());
                ViewGroup.LayoutParams imageViewLayoutParams = new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
                // 获取图片并展示
                JgAds.getInstance().getImageLoader().loadImage(imageView.getContext(), nativeAdInfo.getImageUrl(), imageView);
                imageView.setScaleType(ImageView.ScaleType.CENTER_CROP);
                imageView.setLayoutParams(imageViewLayoutParams);
                JUnionViewUtil.addAdViewToAdContainer(flMaterialContainer, imageView);
            }
            if (tvTitle != null) {
                // 设置标题
                tvTitle.setText(nativeAdInfo.getTitle());
            }
            if (tvDesc != null) {
                // 设置正文
                tvDesc.setText(nativeAdInfo.getDesc());
            }
            if (tvAdTarget != null) {
                // 设置渠道
                tvAdTarget.setText(nativeAdInfo.getAdTarget());
            }
            // 注册关闭事件
            nativeAdInfo.registerCloseView(ivClose);
            // 注册视图和点击事件
            nativeAdInfo.registerView(rlAdContainer, rlAdContainer);
        }
    }

    @Override
    public void onAdExpose(NativeAdInfo nativeAdInfo) {
        // 广告展示回调
    }

    @Override
    public void onAdClick(NativeAdInfo nativeAdInfo) {
        // 广告点击回调
    }

    @Override
    public void onAdClose(NativeAdInfo nativeAdInfo) {
        // 广告关闭回调
    }

    @Override
    public void onAdFailed(JUnionError error) {
        // 广告失败回调
    }
});
nativeAd.loadAd(String posId);

NativeExpressAd nativeExpressAd = new NativeExpressAd(Context context, new JUnionAdSize(int width, int height));
nativeExpressAd.setListener(new NativeExpressAdListener() {
    @Override
    public void onRenderFailed(NativeExpressAdInfo nativeExpressAdInfo, JUnionError error) {
        // 广告渲染失败
    }

    @Override
    public void onAdReceive(List<NativeExpressAdInfo> nativeExpressAdInfos) {
        // 广告获取成功回调
        if (nativeExpressAdInfos == null || nativeExpressAdInfos.size() == 0) {
            return;
        }
        NativeExpressAdInfo nativeExpressAdInfo = nativeExpressAdInfos.get(0);
        if (nativeExpressAdInfo != null) {
            // 获取广告视图
            View view = nativeExpressAdInfo.getNativeExpressAdView();
            // 将广告视图添加到容器中
            ((ViewGroup) itemView).addView(view, new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT));
            // 渲染广告，一定要最后调用
            nativeExpressAdInfo.render();
        }
    }

    @Override
    public void onAdExpose(NativeExpressAdInfo nativeExpressAdInfo) {
        // 广告展示回调
    }

    @Override
    public void onAdClick(NativeExpressAdInfo nativeExpressAdInfo) {
        // 广告点击回调
    }

    @Override
    public void onAdClose(NativeExpressAdInfo nativeExpressAdInfo) {
        // 广告关闭回调
    }

    @Override
    public void onAdFailed(JUnionError error) {
        // 广告失败回调
    }
});
nativeExpressAd.loadAd(String posId);

InterstitialAd interstitialAd = new InterstitialAd(this);
interstitialAd.setListener(new InterstitialAdListener() {
    @Override
    public void onAdReceive(InterstitialAdInfo interstitialAdInfo) {
        // 广告获取成功回调
        if (interstitialAdInfo != null) {
            interstitialAdInfo.showInterstitial(Activity activity);
        }
    }

    @Override
    public void onAdExpose(InterstitialAdInfo interstitialAdInfo) {
        // 广告展示回调
    }

    @Override
    public void onAdClick(InterstitialAdInfo interstitialAdInfo) {
        // 广告点击回调
    }

    @Override
    public void onAdClose(InterstitialAdInfo interstitialAdInfo) {
        // 广告关闭回调
    }

    @Override
    public void onVideoStart(InterstitialAdInfo interstitialAdInfo) {
        // 视频开始播放
    }

    @Override
    public void onVideoFinish(InterstitialAdInfo interstitialAdInfo) {
        // 视频播放完毕
    }

    @Override
    public void onVideoPause(InterstitialAdInfo interstitialAdInfo) {
        // 视频暂停
    }

    @Override
    public void onVideoError(InterstitialAdInfo interstitialAdInfo) {
        // 视频错误
    }

    @Override
    public void onAdFailed(JUnionError error) {
        // 广告失败回调
    }
});
interstitialAd.loadAd(String posId);

RewardAd rewardAd = new RewardAd(this);
rewardAd.setListener(new RewardAdListener() {
    @Override
    public void onAdReceive(RewardAdInfo rewardAdInfo) {
        // 广告获取成功回调
        if (rewardAdInfo != null) {
            rewardAdInfo.showRewardAd(Activity activity);
        }
    }

    @Override
    public void onAdReward(RewardAdInfo rewardAdInfo) {
        // 广告奖励回调
    }

    @Override
    public void onAdExpose(RewardAdInfo rewardAdInfo) {
        // 广告展示回调
    }

    @Override
    public void onAdClick(RewardAdInfo rewardAdInfo) {
        // 广告点击回调
    }

    @Override
    public void onAdClose(RewardAdInfo rewardAdInfo) {
        // 广告关闭回调
    }

    @Override
    public void onVideoCompleted(RewardAdInfo rewardAdInfo) {
        // 视频播放完毕回调
    }

    @Override
    public void onVideoSkip(RewardAdInfo rewardAdInfo) {
        // 视频跳过回调
    }

    @Override
    public void onVideoError(RewardAdInfo rewardAdInfo, String msg) {
        // 视频播放错误回调
    }

    @Override
    public void onAdFailed(JUnionError error) {
        // 广告失败回调
    }
});
rewardAd.loadAd(String posId);

// 获取广告价格（分）
splashAdInfo.getBidPrice();

/**
 * price 竞赢价格（分）
 */
splashAdInfo.sendWinNotice(int price);

/**
 * price 三方竞赢价格（分）
 * msg 失败原因 LOW_PRICE竞价失败、OTHER其他
 */
splashAdInfo.sendLossNotice(Integer.valueOf(price), BidLossNotice.LOW_PRICE);