Skip to content

激励视频广告

激励广告能够向与广告交互的用户提供各种应用内物品作为奖励,如继续游戏、虚拟货币等。这样,用户在广告互动中投入时间后就能获得切实的价值,从而达到推动交互的效果。

以下各节将向您介绍如何加载和显示激励广告。

加载广告

加载激励广告,首先创建激励广告实例对象 CTRewardedVideoAd ,然后调用其 loadAd 方法

  • Objective-C
objc
#import <CartySDK/CartySDK.h>

self.rewardedVideoAd = [[CTRewardedVideoAd alloc] init];
self.rewardedVideoAd.placementid = @"<your-placement-id>";
self.rewardedVideoAd.delegate = self;
[self.rewardedVideoAd loadAd];
  • Swift
swift
import CartySDK

rewardedVideoAd = CTRewardedVideoAd()
rewardedVideoAd.placementid = "<your-placement-id>"
rewardedVideoAd.delegate = self
rewardedVideoAd.load()

实现监听回调

实现 CTRewardedVideoAdDelegate 接收广告相关回调通知

  • Objective-C
objc
- (void)CTRewardedVideoAdDidLoad:(nonnull CTRewardedVideoAd *)ad { 
    NSLog(@"加载成功");
}

- (void)CTRewardedVideoAdLoadFail:(nonnull CTRewardedVideoAd *)ad withError:(nonnull NSError *)error { 
    NSLog(@"加载成功: %@",error.localizedDescription);
}

- (void)CTRewardedVideoAdDidShow:(nonnull CTRewardedVideoAd *)ad { 
    NSLog(@"展示成功");
}

- (void)CTRewardedVideoAdShowFail:(nonnull CTRewardedVideoAd *)ad withError:(nonnull NSError *)error { 
    NSLog(@"展示失败: %@",error.localizedDescription);
}

- (void)CTRewardedVideoAdDidClick:(nonnull CTRewardedVideoAd *)ad {
    NSLog(@"广告被点击");
}

- (void)CTRewardedVideoAdDidDismiss:(nonnull CTRewardedVideoAd *)ad {
    NSLog(@"广告已关闭");
}

- (void)CTRewardedVideoAdDidEarnReward:(nonnull CTRewardedVideoAd *)ad rewardInfo:(nonnull NSDictionary *)rewardInfo {
    NSLog(@"激励触发");
}
  • Swift
swift
func ctRewardedVideoAdDidLoad(_ ad: CTRewardedVideoAd) {
    print("加载成功")
}
    
func ctRewardedVideoAdLoadFail(_ ad: CTRewardedVideoAd, withError error: any Error) {
    print("加载失败 \(error.localizedDescription)")
}
    
func ctRewardedVideoAdDidShow(_ ad: CTRewardedVideoAd) {
    print("展示成功")
}
    
func ctRewardedVideoAdShowFail(_ ad: CTRewardedVideoAd, withError error: any Error) {
    print("展示失败 \(error.localizedDescription)")
}
    
func ctRewardedVideoAdDidClick(_ ad: CTRewardedVideoAd) {
    print("广告被点击")
}
    
func ctRewardedVideoAdDidDismiss(_ ad: CTRewardedVideoAd) {
    print("广告已关闭")
}
    
func ctRewardedVideoAdDidEarnReward(_ ad: CTRewardedVideoAd, rewardInfo: [AnyHashable : Any]) {
    print("激励触发")
}

展示广告

调用 CTRewardedVideoAd 的 showAd 方法来展示广告

  • Objective-C
objc
if(self.rewardedVideoAd.isReady)
{
    [self.rewardedVideoAd showAd:self];
}
  • Swift
swift
if(rewardedVideoAd.isReady())
{
    rewardedVideoAd.show(self)
}

其他

静音设置

需要在加载前设置

  • Objective-C
objc
self.rewardedVideoAd.isMute = YES;
  • Swift
swift
rewardedVideoAd.isMute = true

服务端激励回调

示例