激励互动广告

激励互动广告

PlayableAds提供一种可交互的试玩广告，增加了广告的趣味性。激励互动广告使用单例模式，模态窗口的方式展示广告。使用简单，参考如下步骤：

1 引入头文件 PlayableAds.h

#import <PlayableAdsSDK/PlayableAds.h>

2 初始化并设置代理

/*
 * 初始化
 */
+ (PlayableAdsReward *_Nonnull)sharedInstance;

/**
 * 设置激励互动广告回调
 *
 */
@property (nonatomic, weak, nullable)id <PlayableAdsRewardDelegate> delegate;

3 设置广告位名字（可选）

/*
 * 广告位名字
 */
@property (nonatomic, strong) NSString *_Nullable placeId;

4 设置区域，默认为国外（可选）

/*
 * 区域(区分国内国外)，请在load和show方法前设置
 */
@property (nonatomic, assign) VGGlobalZone zone;

5 检查广告是否可显示

/*
 * 判断预加载的内容是否可显示(校验使用)
 */
- (BOOL)isReady;

6 加载广告

/*
 * key 广告位的key
 */
- (void)loadRewardAdsResourcesWithKey:(NSString *_Nonnull)key;

7 展示广告

/**
 * 展示激励互动广告
 * viewController  展示广告的控制器(controller)
 */
- (void)showRewardAdsWithController:(UIViewController *_Nonnull)viewController;

8 示例代码

我们仅以Xcode工程作为示例，其它IDE工程，请参考修改！

- (void)enterGame:(id)sender{
        if ([[PlayableAds sharePlayableAds] isReady]) {
            [[PlayableAds sharePlayableAds] showRewardAdsWithController:self];
        }else{
            [[PlayableAds sharePlayableAds] loadRewardAdsResourcesWithKey:@"key"];
        }
}

9 获取即将播放的广告信息

/**
 * 返回待播放的激励互动广告Info
 * @{@"icon":@""}
 */
- (NSDictionary *_Nullable)getOfferInfo;

在对象被销毁时，将代理置空：

[PlayableAds sharePlayableAds].delegate = nil;

目前提供的回调方法有：

/**
 *加载成功
 */
- (void)playableAdsRewardLoadSuccessWithKey:(NSString *_Nonnull)key placeId:(NSString *_Nullable)placeId;

/**
 *加载失败
 */
- (void)playableAdsRewardLoadFailed:(NSDictionary *_Nullable)dic withKey:(NSString *_Nonnull)key placeId:(NSString *_Nullable)placeId;

/**
 *广告打开
 */
- (void)playableAdsRewardDidOpenWithKey:(NSString *_Nonnull)key placeId:(NSString *_Nullable)placeId;

/**
 *广告点击
 */
- (void)playableAdsRewardDidClick:(NSString *_Nullable)placeString withKey:(NSString *_Nonnull)key placeId:(NSString *_Nullable)placeId;
/**
 *广告播放完成
 */
- (void)playableAdsRewardDidPlayCompleteWithKey:(NSString *_Nonnull)key placeId:(NSString *_Nullable)placeId;

/**
 *广告关闭
 */
- (void)playableAdsRewardDidCloseWithKey:(NSString *_Nonnull)key placeId:(NSString *_Nullable)placeId;

/**
 *准备发放奖励
 */
- (void)playableAdsRewardDidRewardUserWithReward:(NSDictionary *_Nullable)reward withKey:(NSString *_Nonnull)key placeId:(NSString *_Nullable)placeId;

/**
 *不符合发放奖励
 */
- (void)playableAdsRewardDontReward:(NSError *_Nullable)error withKey:(NSString *_Nonnull)key placeId:(NSString *_Nullable)placeId;

调用展示广告和加载广告方法前，必须先设置delegate，否则将收不到回调。播放当前广告时，默认预加载下一个。加载广告的顺序是先检查本地，如果没有，再向服务器请求。