跳至主要内容

Android Banner Ads SDK8

TAmedia Banner 廣告支援下列尺寸,請在建立 TWMAdView 時指定對應的 TWMAdSize:

TWMAdSize 常數尺寸(寬 × 高)
TWMAdSize.BANNER320 × 50
TWMAdSize.BANNER_300X250300 × 250
TWMAdSize.BANNER_1200X6271200 × 627
TWMAdSize.SMART_BANNER寬度自動對應裝置寬度,高度依寬度調整

實作方式​

1. 建立 TWMAdView​

以下兩種方式擇一。

方式一:在程式中動態建立​

先在 Layout 準備放廣告的容器:

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
android:id="@+id/ad_container"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:gravity="center_horizontal">
</RelativeLayout>

再於 Activity 建立 TWMAdView 並加入容器:

var adView: TWMAdView? = null
var mRelativeLayout: RelativeLayout? = null

companion object {
const val TAMEDIA_BANNER_AD_UNIT_ID: String = "INSERT_YOUR_AD_UNIT_ID"
}
// Other Implement ...

// 依序傳入 Activity、TWMAdSize、Ad Unit Id;TWMAdSize 請參考頁首的支援格式
adView = TWMAdView(this, TWMAdSize.BANNER, TAMEDIA_BANNER_AD_UNIT_ID)
val layoutParams = RelativeLayout.LayoutParams(
RelativeLayout.LayoutParams.WRAP_CONTENT,
RelativeLayout.LayoutParams.WRAP_CONTENT
)
layoutParams.addRule(RelativeLayout.ALIGN_PARENT_BOTTOM)
layoutParams.addRule(RelativeLayout.CENTER_HORIZONTAL)
adView?.layoutParams = layoutParams

// 將廣告加入容器
mRelativeLayout = findViewById(R.id.ad_container)
mRelativeLayout?.addView(adView)

方式二:在 XML 中宣告​

將 TWMAdView 宣告在 Layout 中,再透過 findViewById 取得:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical" >
<com.taiwanmobile.pt.adp.view.TWMAdView
xmlns:ad="http://schemas.android.com/apk/lib/com.taiwanmobile.pt.adp.view"
android:id="@+id/adView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
ad:adSize="BANNER"
ad:adunitId="{AD_UNIT_ID}" >
</com.taiwanmobile.pt.adp.view.TWMAdView>
</LinearLayout>
adView = findViewById(R.id.adView)

2. 設定 TWMAdViewListener​

透過 TWMAdViewListener 監聽廣告投放情況:

adView?.setAdListener(object : TWMAdViewListener {
override fun onReceiveAd(ad: TWMAd) {
// 表示本次請求收到廣告
}
override fun onFailedToReceiveAd(ad: TWMAd, errorCode: TWMAdRequest.ErrorCode) {
// 表示本次請求發生錯誤, 並沒有廣告內容可供使用
}
override fun onPresentScreen(ad: TWMAd) {
// 表示廣告內容已呈現
}
override fun onDismissScreen(ad: TWMAd) {
// 表示廣告內容已被關閉
}
override fun onLeaveApplication(ad: TWMAd) {
// 表示因點擊廣告或其他因素離開app
}
})

3. 請求廣告​

建立預設的 TWMAdRequest 物件,傳入 loadAd:

adView?.loadAd(TWMAdRequest())

4. 暫停載入與回收 TWMAdView​

於 Activity.onPause() 停止載入廣告:

override fun onPause() {
adView?.stopLoading()
super.onPause()
}
注意

請務必於 Activity.onDestroy() 回收 TWMAdView 物件。

override fun onDestroy() {
super.onDestroy()
adView?.destroy()
mRelativeLayout?.removeAllViews()
}

畫面展示​

應用程式開啟
應用程式開啟
點擊Banner後開啟網頁
點擊Banner後開啟網頁
點擊Banner後撥打電話
點擊Banner後撥打電話

Jetpack Compose​

在 Compose 中透過 AndroidView 嵌入 TWMAdView。以下為精簡範例,完整寫法請參考 SDK 下載包中的 Compose 範例程式 BannerComposeActivity 的 TWMBannerComposable()。

@Composable
fun TWMBannerComposable(adSize: TWMAdSize, adUnitId: String) {
// TWMAdView 需要傳入 Activity,從 Compose 的 Context 往上找
val context = LocalContext.current
val activity = remember(context) {
generateSequence(context) { (it as? ContextWrapper)?.baseContext }
.filterIsInstance<Activity>()
.firstOrNull()
} ?: return

val adView = remember {
TWMAdView(activity, adSize, adUnitId).apply {
adListener = object : TWMAdViewListener {
override fun onReceiveAd(ad: TWMAd) {
// 表示本次請求收到廣告
}
override fun onFailedToReceiveAd(ad: TWMAd, errorCode: TWMAdRequest.ErrorCode) {
// 表示本次請求發生錯誤, 並沒有廣告內容可供使用
}
override fun onPresentScreen(ad: TWMAd) {}
override fun onDismissScreen(ad: TWMAd) {}
override fun onLeaveApplication(ad: TWMAd) {}
}
loadAd(TWMAdRequest())
}
}

// 離開畫面時回收 TWMAdView
DisposableEffect(Unit) {
onDispose { adView.destroy() }
}

AndroidView(factory = { adView })
}

使用方式:

TWMBannerComposable(TWMAdSize.BANNER, "INSERT_YOUR_AD_UNIT_ID")
應用程式開啟
應用程式開啟
點擊Banner後開啟網頁
點擊Banner後開啟網頁
無廣告內容
無廣告內容

將應用程式的廣告請求標記為兒童導向內容(13 歲以下)​

請於廣告請求時透過 TWMAdRequest.setChildDirectedTreatment(true) 告知 SDK 該廣告標記為兒童導向內容。此模式下不會存取與記錄 Android 裝置的 Google 廣告 ID(AAID)。

adView?.loadAd(TWMAdRequest().apply { setChildDirectedTreatment(true) })

回首頁