SwAdText

广告位四要素

  • 使用场景:导航条下 / 页面顶部的文字链位(slotKey 例 top_links)
  • 业界形态:Text link ads(AdSDK 格式 text)
  • 表现形态:纯文字链单列 / 多列
  • 打点事件:同 banner —— adImpression(IntersectionObserver 进视口一次)/ adClick;自动内置零配置,gate 关闭静默 no-op

选错场景 = 埋点 ad_type / 时机全错。按场景选组件见 广告组件选型。

SwAdText 是文字广告位组件,属广告底座「文字卡片类」自渲染组件,用于纯文案广告(文字链 / 推广位)。支持 cell(单列文字链)与 grid(文字宫格)两种布局。内置曝光 / 点击埋点。

文字链(cell)

加载中...

Props

名称类型必填默认值说明
itemsSwAdItem[]✓—广告创意数组(用 title 作文案)
slotKeystring✓—广告位键 → ad_slot_key
slotNamestringundefined广告位名 → ad_slot_name
pageKeystringundefined页面键 → page_key
pageNamestringundefined页面名 → page_name
showAdLabelbooleanundefined「广告」合规角标(inline 行内形态,置于每条文案行尾;文案截断成省略号时标签仍完整露出);不传时跟随全局 swiftConfig.ad.showLabel(默认 true),显式传值始终优先
layout'cell' | 'grid''cell'布局:单列文字链 / 文字宫格
gridColumnsnumber3grid 列数
gridGapnumber8grid 间距(px)

Events

名称携带说明
load—渲染完成
empty—items 为空
impressionitems: SwAdItem[]曝光(自动埋点)
clickitem: SwAdItem点击(自动埋点)
error—渲染 / 加载错误

文字宫格(grid,3 列)

加载中...

事件总览(load/impression/click 日志)

加载中...

gridColumns / gridGap 调参

加载中...

空数据 @empty(零渲染)

加载中...
<SwAdText :items="textAds" slot-key="footer_text_ad" show-ad-label />

注意事项

  • 文案取 item.title;纯文字广告 item.image 可不传。
  • 埋点内置,受 tracker 双重 gate。