跳转到主要内容
PRODUCT DOCUMENTS

快速找到所需文档,高效完成接入与排障

浏览产品文档与友盟 Skill,展开目录并阅读正文。

悬浮球广告

简介

悬浮球广告以小图标的形式出现在屏幕右下角,用户可以选择点击或关闭。【渲染方式:模板渲染】

主要API

使用说明:创建UMUnionFloatingIconAd对象来加载广告,通过设置UMUnionFloatingIconAdDelegate代理,获取广告相关回调。

代理回调方法说明

@protocol UMUnionFloatingIconAdDelegate <NSObject>
@optional
/// 请求广告数据成功回调
- (void)uadFloatingIconDidLoad:(UMUnionFloatingIconAd *)floatingIconAd;

/// 请求广告数据失败回调
/// @param error 失败信息
- (void)uadFloatingIconDidLoad:(UMUnionFloatingIconAd *)floatingIconAd failWithError:(NSError *_Nullable)error;

/// 广告显示回调
- (void)uadFloatingIconExposeSuccess:(UMUnionFloatingIconAd *)floatingIconAd;

/// 广告点击回调
- (void)uadFloatingIconClicked:(UMUnionFloatingIconAd *)floatingIconAd;

/// 广告关闭回调
- (void)uadFloatingIconClose:(UMUnionFloatingIconAd *)floatingIconAd;

/// 广告详情页即将打开
- (void)uadFloatingIconDetailViewWillPresent:(UMUnionFloatingIconAd *)floatingIconAd;

/// 广告详情页关闭
- (void)uadFloatingIconDetailViewClosed:(UMUnionFloatingIconAd *)floatingIconAd;

@end

在实现上述事件回调之前,请务必先设置delegate:

fiAd.delegate = self;

调用接口说明

方法

说明

- (instancetype)initWithSlotId:(NSString *)slotId;

UMUnionFloatingIconAd实例构造方法,slotId为对应广告位id

- (void)loadAdAndShow:(UIViewController *)rootViewController;

广告请求并显示,rootViewController:用于显示/跳转广告的UIViewController[必选]

- (void)loadAd;

广告请求,用于Load、Show分离场景

- (void)presentAdWithRootViewController:(UIViewController *)rootViewController;

广告展示,用于Load、Show分离场景

- (NSNumber *)eCPM;

出价策略有两种:1、PD约定价格,此时该字段返回固定值 -1 ,结算以合同约定的价格为准(可能是CPM固定价,可能是CPM阶梯价,也可能是CPC/CPS等);2、RTB价格,此时该字段返回实时出价,结算以此价格为依据。

接入代码示例

方式一:

- (IBAction)onLoadAndShow:(id)sender {
    self.fiAd  = [[UMUnionFloatingIconAd alloc] initWithSlotId:YOUR_SLOT_ID];
    self.fiAd.delegate = self;
    [self.fiAd loadAdAndShow:self];
}

方式二:

- (IBAction)onLoad:(id)sender {
    self.fiAd  = [[UMUnionFloatingIconAd alloc] initWithSlotId:YOUR_SLOT_ID];
    self.fiAd.delegate = self;
    [self.fiAd loadAd];
}

- (IBAction)onShow:(id)sender {
    if (self.fiAd) {
        [self.fiAd presentAdWithRootViewController:self];
    }
}