竞价接入

接入概览 · 运行示例 · 广告加载与展示

仅在平台已为媒体开通相应竞价能力时使用。普通加载无需配置服务端竞价。

普通请求可调用 ysifly_loadAd,或通过 ysifly_loadAdWithRequestConfig: 传入 YSIFLYAdRequestConfig。请求超时、App 信息、底价等请求字段与 YSIFLYSplashAdConfig 展示配置分开设置。

常用请求字段说明
requestTimeout请求超时,单位秒
appName / appVersion宿主 App 名称和版本
idfa仅在 ATT 允许时传入有效标识
settleType / bidFloor结算方式与底价,按平台协议设置;底价单位为 CNY 元/千次展示
deepLinkDisabled是否禁用 DeepLink;点击和落地页跳转仍由 SDK 处理

可左右滚动查看完整表格

ysifly_splashAdDidLoad: 后可读 ad.bidInfo.price、ad.bidInfo.dealId。只有接入 Header Bidding 时才按平台协议调用 ysifly_sendBidResultWithType:reason:;不要把加载成功自动等同于竞胜。

已开通 S2S 时,先通过 YSIFLYAdSDK 的 ysifly_getSdkTokenWithAdUnitId:error: 获取请求 Token 交给媒体服务端;收到服务端竞价胜出的响应 Token 后,为新的 YSIFLYSplashAd 调用 ysifly_loadAdWithServerBiddingToken:。两种 Token 不能互换,响应 Token 不可重复消费,也不要对同一实例同时调用普通加载与 S2S 加载。S2S 成功后的 bidInfo.price 固定为 0,不能据此判断实际竞价价格。