Skip to main content

积分墙

积分墙广告#

  • 积分墙广告一般是全屏的,调用时机是在页面切换时,一般有图片和视频两种,部分渠道会有定制化的积分墙
  • 积分墙广告是三方广告平台提供的一般不支持做定制或者修改
  • 积分墙广告一般需要预加载,在展示机会到来时判断isAdReady()是否准备好,准备好后可以调用展示广告

集成说明#

1. 初始化#

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

2. 显示广告#

//判断是否有可用广告
if (self.offerwallAd.isAdReady)
{
//sceneId为广告场景ID
[self.offerwall showAdWithSceneId:nil];
}

3. 加载广告#

[self.offerwallAd loadAd];

4 其他API#

  • 设置用户id, 首次load成功后设置。
- (void)setUserId:(NSString *)userId;
  • 获取当前余额 从callback中获取balance
- (void)getCurrencyBalance;
  • 扣除用户积分墙积分
- (void)spendCurrency:(int)amount;
  • 添加用户积分墙积分
- (void)awardCurrency:(int)amount;

5. 监听回调#

  • 回调信息说明

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

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

回调接口及说明

///AD加载完成 首个广告源加载成功时回调 一次加载流程只会回调一次
- (void)tpOfferwallAdLoaded:(NSDictionary *)adInfo;
///AD加载失败
///tpOfferwallAdOneLayerLoaded:didFailWithError:返回三方源的错误信息
- (void)tpOfferwallAdLoadFailWithError:(NSError *)error;
///AD展现
- (void)tpOfferwallAdImpression:(NSDictionary *)adInfo;
///AD展现失败
- (void)tpOfferwallAdShow:(NSDictionary *)adInfo didFailWithError:(NSError *)error;
///AD被点击
- (void)tpOfferwallAdClicked:(NSDictionary *)adInfo;
///AD关闭
- (void)tpOfferwallAdDismissed:(NSDictionary *)adInfo;
@optional
- (void)tpOfferwallAdStartLoad:(NSDictionary *)adInfo;
///当每个广告源开始加载时会都会回调一次。
- (void)tpOfferwallAdOneLayerStartLoad:(NSDictionary *)adInfo;
///当每个广告源加载成功后会都会回调一次。
- (void)tpOfferwallAdOneLayerLoaded:(NSDictionary *)adInfo;
///当每个广告源加载失败后会都会回调一次,返回三方源的错误信息
- (void)tpOfferwallAdOneLayerLoad:(NSDictionary *)adInfo didFailWithError:(NSError *)error;
///v8.7.0+新增
///调用load之后如果收到此回调,说明广告位仍处于加载状态,无法触发新的一轮广告加载。
- (void)tpOfferwallAdIsLoading:(NSDictionary *)adInfo;
///加载流程全部结束
- (void)tpOfferwallAdAllLoaded:(BOOL)success;
///userID 设置结束 error = nil 成功
- (void)tpOfferwallSetUserIdFinish:(NSError *)error;
///用户当前积分墙积分数量
- (void)tpOfferwallGetCurrencyBalance:(NSDictionary *)response error:(NSError *)error;
//扣除用户积分墙积分回调
- (void)tpOfferwallSpendCurrency:(NSDictionary *)response error:(NSError *)error;
//添加用户积分墙积分回调
- (void)tpOfferwallAwardCurrency:(NSDictionary *)response error:(NSError *)error;

6. 接入参考#

参考:TradPlusAdOfferwallViewController