Skip to main content

Android 开屏广告

Unity导出到Android Studio接入开屏​

开屏广告目前支持导出到Android项目集成，如图：

开发者导出到Android Studio集成开屏，API介绍请参看Android开屏广告

接入代码示例​

接入步骤参考以下代码，开发者需要根据实际需要调整。 
    mUnityPlayer = new UnityPlayer(this);
    
    ...
    
    // 1、接入开屏，只需要在AS端初始化TradPlus SDK，AppId是应用Id，需要您去开发者后台添加APP
    TradPlusSdk.initSdk(this, “AppId“);

    // 2、初始化广告位。广告位ID在TradPlus后台创建。仅调用一次。
    TPSplash tpSplash = new TPSplash(context, "AdUnitId");

    FrameLayout frameLayout = new FrameLayout(UnityPlayerActivity.this);
    frameLayout.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));

    // 3、设置回调监听（onAdClosed回调监听中remove传入容器）
    tpSplash.setAdListener(new SplashAdListener() {
        @Override
        public void onAdClicked(TPAdInfo tpAdInfo) {}

        @Override
        public void onAdImpression(TPAdInfo tpAdInfo) {}

        @Override
        public void onAdClosed(TPAdInfo tpAdInfo) {
            Log.i(TAG, "onAdClosed: ");
            // 注意这里需要remove
            frameLayout.removeAllViews();
        }

        @Override
        public void onAdShowFailed(TPAdError var1, TPAdInfo var2) {}

        @Override
        public void onAdLoaded(TPAdInfo tpAdInfo, TPBaseAd tpBaseAd) {
			//v1.1.2优化回调方式，一次loadAd对应一次loaded回调，不调用不回调。
		}

        @Override
        public void onAdLoadFailed(TPAdError tpAdInfo) {}
    });

    // 4、设置每层广告源回调监听 （可选）
    tpSplash.setAllAdLoadListener(new LoadAdEveryLayerListener() {...});


    // 5、请求广告
    tpSplash.loadAd(frameLayout);
    mUnityPlayer.addView(frameLayout);
        
    // 6、检查是否有可用广告（可做几秒倒计时判断，如5秒内无用广告直接跳转进入游戏界面）
    if (tpSplash.isReady()) {
       // 7、展示广告
       tpSplash.showAd();
    }


    setContentView(mUnityPlayer);

    ...

    mUnityPlayer.requestFocus();

iOS部分

开屏广告​

  • 开屏广告是打开app的时候展示一个3-5s的全屏的广告
  • 开屏广告分冷启动和热启动，冷启动时要尽可能提前开始加载广告，这样才能确保在进入app之前加载到并展示广告
  • 热启动是app切换到后台，并没有真正的退出，这种情况下要能检测到并提前加载广告
  • 开屏广告一般要配合app的启动页来使用，在加载的时间先给用户看启动页，等广告加载成功后展示广告，广告结束进入app内部

集成说明​

注意： 需先将项目导入至Xcode后，再接入开屏。​

1. 初始化​

#import <TradPlusAds/TradPlusAdSplash.h>
//初始化广告位
self.splashAd = [[TradPlusAdSplash alloc] init];
//设置回调
self.splashAd.delegate = self;
//设置广告位ID
[self.splashAd setAdUnitID:@"您的广告位ID"];

2. 加载广告​

//设置 window 自定义view
[self.splashAd loadAdWithWindow:window bottomView:view];

注：自定义view大小一般不超过屏幕的25%；支持广告平台为：Mintegral,腾讯广告，穿山甲，Sigmob，百度

3. 进入广告场景​

- (void)entryAdScenario:(nullable NSString *)sceneId;

参数说明

sceneId ：广告场景ID (推荐)​
  • 开发者可在在TradPlus后台创建，位置如下：应用管理--广告场景。
  • 具体如何调用，可以参考广告场景的调用时机和用途说明。
  • 进入广告场景时传入sceneId，展示广告时也需传入sceneId，否则会影响统计。

4. 显示广告​

//判断是否有可用广告
if (self.splashAd.isAdReady)
{
	[self.splashAd showWithSceneId:sceneId];//sceneId可为nil
}

5. 监听回调​

  • 回调信息说明

  • tpSplashAdLoadFailWithError:返回的是TP封装的错误信息：详见： 错误码说明

  • tpSplashAdOneLayerLoaded:didFailWithError: 返回三方源的错误信息

  • 以下回调接口已废弃v7.6.0+

- (void)tpSplashAdBidEnd:(NSDictionary *)adInfo success:(BOOL)success DEPRECATED_MSG_ATTRIBUTE("Please use tpSplashAdBidEnd:error:");
- (void)tpSplashAdLoadStart:(NSDictionary *)adInfo DEPRECATED_MSG_ATTRIBUTE("Please use tpSplashAdOneLayerStartLoad:");

回调接口及说明

///AD加载完成 
///v1.1.2优化回调方式，一次loadAd对应一次loaded回调，不调用不回调。
- (void)tpSplashAdLoaded:(NSDictionary *)adInfo;

///AD加载失败
///tpSplashAdOneLayerLoad:didFailWithError：返回三方源的错误信息
- (void)tpSplashAdLoadFailWithError:(NSError *)error;

///AD展现
- (void)tpSplashAdImpression:(NSDictionary *)adInfo;

///AD展现失败
- (void)tpSplashAdShow:(NSDictionary *)adInfo didFailWithError:(NSError *)error;

///AD被点击
- (void)tpSplashAdClicked:(NSDictionary *)adInfo;

///AD关闭
- (void)tpSplashAdDismissed:(NSDictionary *)adInfo;

@optional

///v7.6.0+新增 开始加载流程
- (void)tpSplashAdStartLoad:(NSDictionary *)adInfo;

///当每个广告源开始加载时会都会回调一次。
///v7.6.0+新增。替代原回调接口：tpSplashAdLoadStart:(NSDictionary *)adInfo;
- (void)tpSplashAdOneLayerStartLoad:(NSDictionary *)adInfo;

///v8.7.0+新增
///调用load之后如果收到此回调，说明广告位仍处于加载状态，无法触发新的一轮广告加载。
- (void)tpSplashAdIsLoading:(NSDictionary *)adInfo;

///bidding开始
- (void)tpSplashAdBidStart:(NSDictionary *)adInfo;

///bidding结束 error = nil 表示成功
- (void)tpSplashAdBidEnd:(NSDictionary *)adInfo error:(NSError *)error;

///当每个广告源加载成功后会都会回调一次。
- (void)tpSplashAdOneLayerLoaded:(NSDictionary *)adInfo;

///当每个广告源加载失败后会都会回调一次，返回三方源的错误信息
- (void)tpSplashAdOneLayerLoad:(NSDictionary *)adInfo didFailWithError:(NSError *)error;

///加载流程全部结束
- (void)tpSplashAdAllLoaded:(BOOL)success;

5. 接入参考​

参考：TradPlusAdSplashViewController

广告平台特殊配置说明​

Pangle（海外）​

开发者可以通过一下代码设置Pangle（海外）开屏的 自定义icon（正方形）

UIImage *image = [UIImage imageNamed:@"icon"];
self.splashAd.dicCustomValue = @{@"pangleGlobal_appIcon":image};

开屏广告的推荐用法​

应用启动方式​

  • 冷启动：当启动应用时，后台没有该应用的进程，这时系统会重新创建一个新的进程分配给该应用，这种方式叫“冷启动”
  • 热启动：当启动应用时，后台已有该应用的进程，例：按home键推出再回到前台，或切换应用回到前台等，这种方式叫“热启动”

开屏加载策略​

冷启动方式打开应用​

  • 第一时间在后台load广告，同时建议在loading页时最多停留5秒
    • 如果5秒内返回广告，直接显示。显示完后，再调用 load 方法加载一条广告，供下次热启动时使用
    • 如果5秒内未返回广告，则关闭loading页，直接进入应用主界面。如在此之后收到 loaded 回调，不要再调用show方法。本次广告不会丢弃，SDK会缓存下来备用
  • 应用冷启动时，加载广告的过程中尽量不要同时请求其他网络资源，以免影响广告加载速度

热启动方式打开应用​

  • 有广告则直接显示
  • 不管有无广告展示，都需要再加载一条新的广告，作为备用
  • 如果应用能够监听到切换后台事件，可在切换后台时调用 isReady 方法判断广告是否Ready，如果没有Ready，可补充一条广告

开屏出现时机​

推荐示例

在下面的推荐示例中，开屏广告在应用的加载屏幕上显示。

不推荐示例

如果用户已经进入应用Home页，则不要展示开屏广告。否则会突然弹出，容易造成用户误点击。