TAMedia - 使用者貢獻 [zh-tw]

Download MADP Android SDK

2025-11-25T07:04:04Z

BrandonTeng：

{| class="wikitable"
|-
! Version !! Package !! Size !! Notes
|-
|2.0.0 || TAMediaSDK_2.0.0 || 1475 KB || Initial release
|-
|2.0.1 || TAMediaSDK_2.0.1 || 1475 KB || 修復若干NullpointerException問題
|-
|2.0.2 || TAMediaSDK_2.0.2 || 1567 KB ||
* 因應google play 內容政策修訂, 增訂對google play sevice的支援
* 修復若干已知問題
|-
|2.0.3 || TAMediaSDK_2.0.3 || 1588 KB ||
* 調整插頁式廣告載入程序以促進更良好的用戶經驗
|-
|2.0.4 || TAMediaSDK_2.0.4 || 1588 KB ||
* 修復因未設定TWMVideoAdListener所導致的NullPointerException問題
* 修復若干畫面顯示不正常的現象
|-
|2.0.5 || TAMediaSDK_2.0.5 || 1587 KB ||

* 功能優化, 支援多種多媒體效果

|-
|2.0.6 || TAMediaSDK_2.0.6 || 1587 KB ||
* SDK穩定性調整
|-
|3.0.0 || TAMediaSDK_3.0.0 || 1876 KB ||
* 提供SMART_BANNER廣告型態
* 提供原生性廣告型態
|-
|3.0.1 || TAMediaSDK_3.0.1 || 1876 KB ||
* 針對插頁式廣告以及影音廣告呈現優化
|-
|4.0.0c ||TAMediaSDK_4.0.0c || 1920 KB ||
* 移除READ_PHONE_STATE權限
* 新增懸浮類型廣告
* 原生性廣告新增支援1200X627圖示
* 全版廣告支援互動效果(麥克風&補光燈)
|-
|4.0.1 ||TAMediaAndroidSDK_4.0.1 || 1920 KB ||
* 廣告效能優化
|-
|5.0.1 ||TAMediaAndroidSDK_5.0.1 || 1.88 MB ||
* SDK 穩定性調整
* 增加互動式插頁廣告種類
* 優化插頁: 小鍵盤不再擋住輸入框
* 調整 Callback 時機
|-
|5.0.2 || TAMediaAndroidSDK_5.0.2 || 2.02 MB ||
* 修正部份 Samsung 手機在特定狀況出現異常的問題
|-
|6.0.0 || TAMediaAndroidSDK_6.0.0 || 539 KB ||
* SDK 穩定性調整
* 新增 InRead 類型廣告
* 網路模組更改為 Retrofit 2
* 導入 MRAID 2.0 架構
|-
|6.1.1 || TAMediaAndroidSDK_6.1.1 || 908 KB ||
* SDK 功能優化
* Minor Fix
|-
|6.1.2 || TAMediaAndroidSDK_6.1.2 || 908 KB ||
* Minor Fix
|-
|6.2.0 || TAMediaAndroidSDK_6.2.0 || 908 KB ||
* SDK 功能優化
|-
|7.0.0 || TAMediaAndroidSDK_7.0.0 || 959 KB ||
* 新增可支援的廣告素材
* SDK 功能優化
|-
|7.0.1 || TAMediaAndroidSDK_7.0.1 || 959 KB ||
* Minor Fix
|-
|7.0.2 || TAMediaAndroidSDK_7.0.2 || 960 KB ||
* Minor Fix
|-
|7.0.3 || TAMediaAndroidSDK_7.0.3 || 4.23 MB ||
* SDK 功能優化
|-
|7.0.4 || TAMediaAndroidSDK_7.0.4 || 4.79 MB ||
* SDK 功能優化
|-
|8.0.0 || TAMediaAndroidSDK_8.0.0 || 2.7 MB ||
* 新增原生廣告整合方式
* 調整橫幅與InRead廣告
* 新增兒童導向廣告設定
|-
|8.0.1 || [[媒體:TAMediaAndroidSDK_8.0.1.zip|TAMediaAndroidSDK_8.0.1]] || 2.7 MB ||
* SDK 功能優化
* 支援Android 12上取得AAID之宣告
|-
|8.0.2 || [[媒體:TAMediaAndroidSDK 8.0.2.zip|TAMediaAndroidSDK_8.0.2]] || 2.81 MB ||
* Minor Fix
|-
|8.0.3 || [[媒體:TAMediaAndroidSDK_8.0.3.zip|TAMediaAndroidSDK_8.0.3]] || 2.68 MB ||
* Minor Fix
|-
|8.0.4 || [[媒體:TAMediaAndroidSDK_8.0.4.zip|TAMediaAndroidSDK_8.0.4]] || 2.71 MB ||
* 原生廣告優化
* 資安修正
* [https://wiki.tamedia.com.tw/wiki/index.php?title=Android_Getting_Started_SDK8#Gradle%E8%A8%AD%E5%AE%9A Gradle更新]
* [https://wiki.tamedia.com.tw/wiki/index.php?title=Android_Proguard_SDK8 Proguard更新]
|-
|8.0.5 || [[媒體:TAMediaAndroidSDK_8.0.5.zip|TAMediaAndroidSDK_8.0.5]] || 1.9 MB ||
* 支援targetSdk=34 (Android 14)
* 修正InRead廣告寬度問題
* [https://wiki.tamedia.com.tw/wiki/index.php?title=Android_Getting_Started_SDK8#Gradle%E8%A8%AD%E5%AE%9A_2 Gradle更新]
* [https://wiki.tamedia.com.tw/wiki/index.php?title=Android_Getting_Started_SDK8#Proguard%E8%A8%AD%E5%AE%9A Proguard更新]
|-
|8.0.6 || [[媒體:TAMediaAndroidSDK_8.0.6.zip|TAMediaAndroidSDK_8.0.6]] || 2.1 MB ||
* 修正Interstitial偶發閃退問題
|-
|8.0.7 [[檔案:new-xxl.png|40px]] || [[媒體:TAMediaAndroidSDK_8.0.7.zip|TAMediaAndroidSDK_8.0.7]] || 3.2 MB ||
* 支援Kotlin 2.2.0
* 支持Retrofit 3.0.0
* 支持Jetpack Compose開發
|}

[[SDK8_Android_SDK_Developer_Guide|回首頁]]

2025-11-17T06:26:17Z

BrandonTeng：

Android Native Ads SDK8

2025-11-17T06:26:03Z

BrandonTeng：/* Compose */

== Native廣告支援內容 ==
:TAmedia Native廣告支援下列數種內容：
{| class="wikitable" style="width:50%"
|-
! 廣告內容 !! 內容細節 !! 資料型別
|-
| align="center"| ShortSubject || align="center"| 短標題 || align="center"| String
|-
| align="center"| LongSubject || align="center"| 長標題 || align="center"| String
|-
| align="center"| Body || align="center"| 內文 || align="center"| String
|-
| align="center"| CTA || align="center"| 行動呼籲 || align="center"| String
|-
| align="center"| iconRect || align="center"| 小圖 (長) || align="center"| TWMNativeAd.Image
|-
| align="center"| iconSquare || align="center"| 小圖 (方) || align="center"| TWMNativeAd.Image
|-
| align="center"| image960_640 || align="center"| 大圖 (960x640) || align="center"| TWMNativeAd.Image
|-
| align="center"| image1200_627 || align="center"| 大圖 (1200x627) || align="center"| TWMNativeAd.Image
|-
| align="center"| mediaContent || align="center"| 多媒體素材(影音或主要圖片) || align="center"| TWMMediaContent
|}
 

== SDK Document ==
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view/-t-w-m-native-ad-view/index.html NativeAd]
 

== 實作方式 ==

:步驟1
: 產生一個TWMNativeAd物件, 設定廣告版位adUnitId, 並呼叫load()請求原生廣告
: 監聽TWMAdListener, 透過onReceivedAd()取得原生廣告資訊TWMNativeAd.nativeAdContent
<source>
// Native ad assets.
var body: String? = null
var shortSubject: String? = null
var longSubject: String? = null
var callToAction:String? = null
var iconRect: TWMNativeAd.Image? = null
var iconSquare: TWMNativeAd.Image? = null
var image960x640: TWMNativeAd.Image? = null
var image1200x627: TWMNativeAd.Image? = null
var mediaContent: TWMMediaContent? = null

fun loadAd(context: Context,
adUnitId: String) {
nativeAd = TWMNativeAd(context, adUnitId)
nativeAd?.setAdListener(this)
nativeAd?.loadAd(TWMAdRequest())
}

override fun onReceiveAd(ad: TWMAd) {
this.body = nativeAd?.nativeAdContent?.body
this.shortSubject = nativeAd?.nativeAdContent?.shortSubject
this.longSubject = nativeAd?.nativeAdContent?.longSubject
this.callToAction = nativeAd?.nativeAdContent?.callToAction
this.iconRect = nativeAd?.nativeAdContent?.iconRect
this.iconSquare = nativeAd?.nativeAdContent?.iconSquare
this.image960x640 = nativeAd?.nativeAdContent?.image960_640
this.image1200x627 = nativeAd?.nativeAdContent?.image1200_627
this.mediaContent = nativeAd?.nativeAdContent?.mediaContent
}
</source>

:步驟2
: 使用TWMNativeAdView作為廣告佈局容器, 開發者可在容器中可自行排列文字(TextView)圖形(ImageView)甚至影片(TWMMediaView)等原生廣告
: 下面以短標題, 小圖 (長), Call To Action, 及多媒體素材當範例
<source>
<?xml version="1.0" encoding="utf-8"?>
<com.taiwanmobile.pt.adp.view.TWMNativeAdView xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/nativeAdView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:background="@android:color/holo_orange_light">

<LinearLayout
android:id="@+id/container"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_gravity="center"
android:minHeight="50dp"
android:orientation="vertical"
android:paddingLeft="20dp"
android:paddingRight="20dp">

<TextView
android:id="@+id/tv_short_subject"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="10dp" />

<ImageView
android:id="@+id/iv_icon_rect"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="10dp"/>

<TextView
android:id="@+id/tv_call_to_action"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="10dp" />

<com.taiwanmobile.pt.adp.nativead.TWMMediaView
android:id="@+id/ad_media"
android:layout_width="150dp"
android:layout_height="120dp"
android:layout_marginTop="10dp"/>

</LinearLayout>
</com.taiwanmobile.pt.adp.view.TWMNativeAdView>

</source>

:步驟3
: 將TWMNativeAd.nativeAdContent的廣告資訊套用在上述廣告佈局中
: 並於TWMNativeAdView進行填充(ex. setShortSubjectView()), 賦予點擊後開啟廣告之功能
<source>
val adContent: TWMNativeAdContent? = ad?.nativeAdContent

// shortSubject
adContent?.shortSubject.let { subject ->
// 顯示短標題於TextView之中
vb.tvShortSubject.text = subject
// 於TWMNativeAdView進行填充, 賦予點擊後開啟廣告之功能
vb.nativeAdView.setShortSubjectView(vb.tvShortSubject)
}

// rect icon
adContent?.iconRect?.getDrawable().let { rectDrawable ->
// 顯示小圖 (長)於ImageView之中
vb.ivIconRect.setImageDrawable(rectDrawable)
vb.ivIconRect.adjustViewBounds = true
// 於TWMNativeAdView進行填充, 賦予點擊後開啟廣告之功能
vb.nativeAdView.setRectangleIconView(vb.ivIconRect)
}

// call to action
adContent?.callToAction?.let { cta ->
// 顯示行動呼籲於TextView之中
vb.tvCallToAction.text = cta
// 於TWMNativeAdView進行填充, 賦予點擊後開啟廣告之功能
vb.nativeAdView.setCallToActionView(vb.tvCallToAction)
}

</source>

:步驟4
: 如欲顯示影片廣告, 將mediaContent指派給TWMMediaView, 用TWMMediaView來顯示影片
<source>
// MediaContent
adContent?.mediaContent?.let { content ->
// 顯示TWMMediaContent於TWMMediaView
vb.adMedia.setMediaContent(content)
// 於TWMNativeAdView進行填充, 賦予點擊後開啟廣告之功能(前往了解)
vb.nativeAdView.setMediaView(vb.adMedia)
}

</source>

:步驟5
: 完成上述後, TWMNativeAd物件指派給TWMNativeAdView, 啟動原生廣告顯示 (重要!!!)
<source>
// nativeAd
vb.nativeAdView.setNativeAd(nativeAd)
</source>

 
 

== TWMNativeAdOptions ==
TWMAdRequest.setNativeAdOptions()供開發者相關功能, 調整原生廣告屬性 

:TAmedia Native廣告支援下列數種內容：
{| class="wikitable" style="width:50%"
|-
! 廣告內容 !! 內容細節
|-
| align="center"| DISABLE_IMAGE_LOADING || align="center"| TWMNativeAdContent.Image不含Drawable物件, 加速廣告下載速度
|-
| align="center"| VIDEO_START_UNMUTED || align="center"| TWMMediaView影片初始為有聲音, 預設為靜音
|-
| align="center"| VIDEO_CUSTOM_CONTROLS_REQUESTED || align="center"| TWMMediaView不提供影片控制項, 預設為提供
|-
| align="center"| MEDIA_PREFER_IMAGE || align="center"| TWMMediaView總是顯示圖片, 預設為影片
|}

: 下面例子為影片初始即有聲音
<source>
val adRequest = TWMAdRequest()
adRequest.setNativeAdOptions(arrayOf(TWMNativeAdOptions.VIDEO_START_UNMUTED))
nativeAd?.loadAd(adRequest)
</source>

 
 

== 釋放廣告 ==
請在Activity的生命週期中加入下述的呼叫, 正確釋放TWMNativeAd物件
override fun onDestroy() {
super.onDestroy()
nativeAd?.destroy()
}

 

== 廣告畫面展示 ==
{| border="1"
|-
| align="center" | 文字
| align="center" | 影片
|-
| align="center" | [[image:SDK8 nativead1.png | 300px]]
| align="center" | [[image:SDK8 nativead2.png | 300px]]
|}

 
 

== 進階. 客製化影片撥放元件(選擇性實作, 非必要) ==
當TWMAdRequest.setNativeAdOptions()使用VIDEO_CUSTOM_CONTROLS_REQUESTED
TWMVideoController / TWMMediaContent包含了下列功能, 提供影片相關資訊, 提供開發者客製化自己的影片控制項
 

{| class="wikitable" style="width:50%"
|-
! 函式名稱 !! 功能
|-
| align="center"| TWMVideoController.isMuted() || align="center"| 影片是否靜音中
|-
| align="center"| TWMVideoController.mute(boolean)|| align="center"| 影片靜音
|-
| align="center"| TWMVideoController.setVideoLifecycleCallback(callback) || align="center"| 影片生命週期(VideoLifecycleCallback)
|-
| align="center"| TWMMediaContent.getCurrentTime() || align="center"| 取得目前撥放進度
|-
| align="center"| TWMMediaContent.getDuration() || align="center"| 取得影片長度
|}

== 進階. TWMMediaView 預設UI項目客製化(選擇性實作, 非必要) ==
SDK8支援TWMMediaView UI項目客製化
 
開發者可透過TWMMediaView下列函式對預設UI控制項進行客製化
 
{| class="wikitable" style="width:50%"
|-
! 函式名稱 !! 功能
|-
| align="center"| TWMMediaView.setCTAVisible(visible: Boolean) || align="center"| 設定CTA是否顯示
|-
| align="center"| TWMMediaView.setCTATextSize(textSize: Float)|| align="center"| 設定CTA文字大小
|-
| align="center"| TWMMediaView.setVideoCountdownTextSize(textSize: Float) || align="center"| 設定影片倒數文字大小
|-
| align="center"| TWMMediaView.setVolumeImageSize(imageSize: Int) || align="center"| 設定靜音圖示大小
|}
[[image:TWMMediaView_CustomUI_Demo.png | 300px]]

== 進階. 支援Open-Measurement友善障礙物(選擇性實作, 非必要) ==
SDK8支援Open-Measurement友善障礙物事件處理
 
https://interactiveadvertisingbureau.github.io/Open-Measurement-SDKAndroid/

開發者可透過TWMNativeAdView.addFriendlyObstruction(view, purpose)將與原生廣告相關的控制元件設定為友善障礙物
 
下面以FloatingActionButton為例子, 按鈕本身為影片靜音設定,使用FriendlyObstructionPurpose.VIDEO_CONTROLS為障礙物目的
 
於TWMNativeAd.setNativeAd()之前完成障礙物添加

<source>
// friendlyObstruction
vb.nativeAdView.addFriendlyObstruction(vb.fab, TWMNativeAdView.FriendlyObstructionPurpose.VIDEO_CONTROLS)
vb.fab.setOnClickListener {
adContent?.mediaContent?.getVideoController()?.let { videoController ->
val isMute = videoController.isMuted()
// 設定影片靜音
videoController.mute(!isMute)
when (videoController.isMuted()) {
true -> { vb.fab.setImageResource(R.drawable.ic_baseline_volume_up_24) }
false -> { vb.fab.setImageResource(R.drawable.ic_baseline_volume_mute_24) }
}
}
}

// nativeAd
vb.nativeAdView.setNativeAd(nativeAd)

</source>

{| class="wikitable" style="width:50%"
|-
! 元件總類 !! 描述
|-
| align="center"| FriendlyObstructionPurpose.VIDEO_CONTROLS || align="center"| 影音控制項
|-
| align="center"| FriendlyObstructionPurpose.CLOSE_AD || align="center"| 關閉廣告
|-
| align="center"| FriendlyObstructionPurpose.NOT_VISIBLE || align="center"| 透明元件
|-
| align="center"| FriendlyObstructionPurpose.OTHER || align="center"| 非上述三種類別
|}

== Compose ==
可參考SDK下載包中之Compose範例程式(NativeAdComposeActivity), TWMNativeAdComposable()中有完整的使用方式與介紹
{| width="90%" border="1"
|-
| align="center" | 應用程式開啟(上頁)
| align="center" | 應用程式開啟(下頁)
| align="center" | 點擊素材後開啟廣告
| align="center" | 無廣告內容
|-
| align="center" | [[檔案:SDK8.0.7_nativead_1.png]]
| align="center" | [[檔案:SDK8.0.7_nativead_2.png]]
| align="center" | [[檔案:SDK8.0.7_nativead_click.png]]
| align="center" | [[檔案:SDK8.0.7_nativead_no_fill.png]]
|}

原生廣告使用流程為先取得廣告物件TWMNativeAd, 再套用在TWMNativeAdView (TWMNativeAdComposable)
 
[[檔案:SDK8.0.7_nativead_architecture.png]]

 

== 將應用程式的廣告請求標記為兒童導向內容(13 歲以下) ==
 
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view/-t-w-m-ad-request/index.html TWMAdRequest]
 
 

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

<source>
val nativeAd: TWMNativeAd = TWMNativeAd(context, adUnitId)
nativeAd.setAdListener(this)
nativeAd.loadAd(TWMAdRequest().apply {
setChildDirectedTreatment(true)
})
</source>

[[SDK8_Android_SDK_Developer_Guide | 回首頁]]

檔案:SDK8.0.7 nativead click.png

2025-11-17T06:21:34Z

BrandonTeng：

Android Native Ads SDK8

2025-11-17T06:21:10Z

BrandonTeng：/* Compose */

== Native廣告支援內容 ==
:TAmedia Native廣告支援下列數種內容：
{| class="wikitable" style="width:50%"
|-
! 廣告內容 !! 內容細節 !! 資料型別
|-
| align="center"| ShortSubject || align="center"| 短標題 || align="center"| String
|-
| align="center"| LongSubject || align="center"| 長標題 || align="center"| String
|-
| align="center"| Body || align="center"| 內文 || align="center"| String
|-
| align="center"| CTA || align="center"| 行動呼籲 || align="center"| String
|-
| align="center"| iconRect || align="center"| 小圖 (長) || align="center"| TWMNativeAd.Image
|-
| align="center"| iconSquare || align="center"| 小圖 (方) || align="center"| TWMNativeAd.Image
|-
| align="center"| image960_640 || align="center"| 大圖 (960x640) || align="center"| TWMNativeAd.Image
|-
| align="center"| image1200_627 || align="center"| 大圖 (1200x627) || align="center"| TWMNativeAd.Image
|-
| align="center"| mediaContent || align="center"| 多媒體素材(影音或主要圖片) || align="center"| TWMMediaContent
|}
 

== SDK Document ==
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view/-t-w-m-native-ad-view/index.html NativeAd]
 

== 實作方式 ==

:步驟1
: 產生一個TWMNativeAd物件, 設定廣告版位adUnitId, 並呼叫load()請求原生廣告
: 監聽TWMAdListener, 透過onReceivedAd()取得原生廣告資訊TWMNativeAd.nativeAdContent
<source>
// Native ad assets.
var body: String? = null
var shortSubject: String? = null
var longSubject: String? = null
var callToAction:String? = null
var iconRect: TWMNativeAd.Image? = null
var iconSquare: TWMNativeAd.Image? = null
var image960x640: TWMNativeAd.Image? = null
var image1200x627: TWMNativeAd.Image? = null
var mediaContent: TWMMediaContent? = null

fun loadAd(context: Context,
adUnitId: String) {
nativeAd = TWMNativeAd(context, adUnitId)
nativeAd?.setAdListener(this)
nativeAd?.loadAd(TWMAdRequest())
}

override fun onReceiveAd(ad: TWMAd) {
this.body = nativeAd?.nativeAdContent?.body
this.shortSubject = nativeAd?.nativeAdContent?.shortSubject
this.longSubject = nativeAd?.nativeAdContent?.longSubject
this.callToAction = nativeAd?.nativeAdContent?.callToAction
this.iconRect = nativeAd?.nativeAdContent?.iconRect
this.iconSquare = nativeAd?.nativeAdContent?.iconSquare
this.image960x640 = nativeAd?.nativeAdContent?.image960_640
this.image1200x627 = nativeAd?.nativeAdContent?.image1200_627
this.mediaContent = nativeAd?.nativeAdContent?.mediaContent
}
</source>

:步驟2
: 使用TWMNativeAdView作為廣告佈局容器, 開發者可在容器中可自行排列文字(TextView)圖形(ImageView)甚至影片(TWMMediaView)等原生廣告
: 下面以短標題, 小圖 (長), Call To Action, 及多媒體素材當範例
<source>
<?xml version="1.0" encoding="utf-8"?>
<com.taiwanmobile.pt.adp.view.TWMNativeAdView xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/nativeAdView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:background="@android:color/holo_orange_light">

<LinearLayout
android:id="@+id/container"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_gravity="center"
android:minHeight="50dp"
android:orientation="vertical"
android:paddingLeft="20dp"
android:paddingRight="20dp">

<TextView
android:id="@+id/tv_short_subject"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="10dp" />

<ImageView
android:id="@+id/iv_icon_rect"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="10dp"/>

<TextView
android:id="@+id/tv_call_to_action"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="10dp" />

<com.taiwanmobile.pt.adp.nativead.TWMMediaView
android:id="@+id/ad_media"
android:layout_width="150dp"
android:layout_height="120dp"
android:layout_marginTop="10dp"/>

</LinearLayout>
</com.taiwanmobile.pt.adp.view.TWMNativeAdView>

</source>

:步驟3
: 將TWMNativeAd.nativeAdContent的廣告資訊套用在上述廣告佈局中
: 並於TWMNativeAdView進行填充(ex. setShortSubjectView()), 賦予點擊後開啟廣告之功能
<source>
val adContent: TWMNativeAdContent? = ad?.nativeAdContent

// shortSubject
adContent?.shortSubject.let { subject ->
// 顯示短標題於TextView之中
vb.tvShortSubject.text = subject
// 於TWMNativeAdView進行填充, 賦予點擊後開啟廣告之功能
vb.nativeAdView.setShortSubjectView(vb.tvShortSubject)
}

// rect icon
adContent?.iconRect?.getDrawable().let { rectDrawable ->
// 顯示小圖 (長)於ImageView之中
vb.ivIconRect.setImageDrawable(rectDrawable)
vb.ivIconRect.adjustViewBounds = true
// 於TWMNativeAdView進行填充, 賦予點擊後開啟廣告之功能
vb.nativeAdView.setRectangleIconView(vb.ivIconRect)
}

// call to action
adContent?.callToAction?.let { cta ->
// 顯示行動呼籲於TextView之中
vb.tvCallToAction.text = cta
// 於TWMNativeAdView進行填充, 賦予點擊後開啟廣告之功能
vb.nativeAdView.setCallToActionView(vb.tvCallToAction)
}

</source>

:步驟4
: 如欲顯示影片廣告, 將mediaContent指派給TWMMediaView, 用TWMMediaView來顯示影片
<source>
// MediaContent
adContent?.mediaContent?.let { content ->
// 顯示TWMMediaContent於TWMMediaView
vb.adMedia.setMediaContent(content)
// 於TWMNativeAdView進行填充, 賦予點擊後開啟廣告之功能(前往了解)
vb.nativeAdView.setMediaView(vb.adMedia)
}

</source>

:步驟5
: 完成上述後, TWMNativeAd物件指派給TWMNativeAdView, 啟動原生廣告顯示 (重要!!!)
<source>
// nativeAd
vb.nativeAdView.setNativeAd(nativeAd)
</source>

 
 

== TWMNativeAdOptions ==
TWMAdRequest.setNativeAdOptions()供開發者相關功能, 調整原生廣告屬性 

:TAmedia Native廣告支援下列數種內容：
{| class="wikitable" style="width:50%"
|-
! 廣告內容 !! 內容細節
|-
| align="center"| DISABLE_IMAGE_LOADING || align="center"| TWMNativeAdContent.Image不含Drawable物件, 加速廣告下載速度
|-
| align="center"| VIDEO_START_UNMUTED || align="center"| TWMMediaView影片初始為有聲音, 預設為靜音
|-
| align="center"| VIDEO_CUSTOM_CONTROLS_REQUESTED || align="center"| TWMMediaView不提供影片控制項, 預設為提供
|-
| align="center"| MEDIA_PREFER_IMAGE || align="center"| TWMMediaView總是顯示圖片, 預設為影片
|}

: 下面例子為影片初始即有聲音
<source>
val adRequest = TWMAdRequest()
adRequest.setNativeAdOptions(arrayOf(TWMNativeAdOptions.VIDEO_START_UNMUTED))
nativeAd?.loadAd(adRequest)
</source>

 
 

== 釋放廣告 ==
請在Activity的生命週期中加入下述的呼叫, 正確釋放TWMNativeAd物件
override fun onDestroy() {
super.onDestroy()
nativeAd?.destroy()
}

 

== 廣告畫面展示 ==
{| border="1"
|-
| align="center" | 文字
| align="center" | 影片
|-
| align="center" | [[image:SDK8 nativead1.png | 300px]]
| align="center" | [[image:SDK8 nativead2.png | 300px]]
|}

 
 

== 進階. 客製化影片撥放元件(選擇性實作, 非必要) ==
當TWMAdRequest.setNativeAdOptions()使用VIDEO_CUSTOM_CONTROLS_REQUESTED
TWMVideoController / TWMMediaContent包含了下列功能, 提供影片相關資訊, 提供開發者客製化自己的影片控制項
 

{| class="wikitable" style="width:50%"
|-
! 函式名稱 !! 功能
|-
| align="center"| TWMVideoController.isMuted() || align="center"| 影片是否靜音中
|-
| align="center"| TWMVideoController.mute(boolean)|| align="center"| 影片靜音
|-
| align="center"| TWMVideoController.setVideoLifecycleCallback(callback) || align="center"| 影片生命週期(VideoLifecycleCallback)
|-
| align="center"| TWMMediaContent.getCurrentTime() || align="center"| 取得目前撥放進度
|-
| align="center"| TWMMediaContent.getDuration() || align="center"| 取得影片長度
|}

== 進階. TWMMediaView 預設UI項目客製化(選擇性實作, 非必要) ==
SDK8支援TWMMediaView UI項目客製化
 
開發者可透過TWMMediaView下列函式對預設UI控制項進行客製化
 
{| class="wikitable" style="width:50%"
|-
! 函式名稱 !! 功能
|-
| align="center"| TWMMediaView.setCTAVisible(visible: Boolean) || align="center"| 設定CTA是否顯示
|-
| align="center"| TWMMediaView.setCTATextSize(textSize: Float)|| align="center"| 設定CTA文字大小
|-
| align="center"| TWMMediaView.setVideoCountdownTextSize(textSize: Float) || align="center"| 設定影片倒數文字大小
|-
| align="center"| TWMMediaView.setVolumeImageSize(imageSize: Int) || align="center"| 設定靜音圖示大小
|}
[[image:TWMMediaView_CustomUI_Demo.png | 300px]]

== 進階. 支援Open-Measurement友善障礙物(選擇性實作, 非必要) ==
SDK8支援Open-Measurement友善障礙物事件處理
 
https://interactiveadvertisingbureau.github.io/Open-Measurement-SDKAndroid/

開發者可透過TWMNativeAdView.addFriendlyObstruction(view, purpose)將與原生廣告相關的控制元件設定為友善障礙物
 
下面以FloatingActionButton為例子, 按鈕本身為影片靜音設定,使用FriendlyObstructionPurpose.VIDEO_CONTROLS為障礙物目的
 
於TWMNativeAd.setNativeAd()之前完成障礙物添加

<source>
// friendlyObstruction
vb.nativeAdView.addFriendlyObstruction(vb.fab, TWMNativeAdView.FriendlyObstructionPurpose.VIDEO_CONTROLS)
vb.fab.setOnClickListener {
adContent?.mediaContent?.getVideoController()?.let { videoController ->
val isMute = videoController.isMuted()
// 設定影片靜音
videoController.mute(!isMute)
when (videoController.isMuted()) {
true -> { vb.fab.setImageResource(R.drawable.ic_baseline_volume_up_24) }
false -> { vb.fab.setImageResource(R.drawable.ic_baseline_volume_mute_24) }
}
}
}

// nativeAd
vb.nativeAdView.setNativeAd(nativeAd)

</source>

{| class="wikitable" style="width:50%"
|-
! 元件總類 !! 描述
|-
| align="center"| FriendlyObstructionPurpose.VIDEO_CONTROLS || align="center"| 影音控制項
|-
| align="center"| FriendlyObstructionPurpose.CLOSE_AD || align="center"| 關閉廣告
|-
| align="center"| FriendlyObstructionPurpose.NOT_VISIBLE || align="center"| 透明元件
|-
| align="center"| FriendlyObstructionPurpose.OTHER || align="center"| 非上述三種類別
|}

== Compose ==
可參考SDK下載包中之Compose範例程式(NativeAdComposeActivity), TWMNativeAdComposable()中有完整的使用方式與介紹
{| width="90%" border="1"
|-
| align="center" | 應用程式開啟(上頁)
| align="center" | 應用程式開啟(下頁)
| align="center" | 點擊素材後開啟廣告
| align="center" | 無廣告內容
|-
| align="center" | [[檔案:SDK8.0.7_nativead_1.png]]
| align="center" | [[檔案:SDK8.0.7_nativead_2.png]]
| align="center" | [[檔案:SDK8.0.7_nativead_click.png]]
| align="center" | [[檔案:SDK8.0.7_nativead_no_fill.png]]
|}

 

== 將應用程式的廣告請求標記為兒童導向內容(13 歲以下) ==
 
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view/-t-w-m-ad-request/index.html TWMAdRequest]
 
 

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

<source>
val nativeAd: TWMNativeAd = TWMNativeAd(context, adUnitId)
nativeAd.setAdListener(this)
nativeAd.loadAd(TWMAdRequest().apply {
setChildDirectedTreatment(true)
})
</source>

[[SDK8_Android_SDK_Developer_Guide | 回首頁]]

檔案:SDK8.0.7 nativead 1.png

2025-11-17T06:19:36Z

BrandonTeng：

檔案:SDK8.0.7 nativead 2.png

2025-11-17T06:19:26Z

BrandonTeng：

Android Native Ads SDK8

2025-11-17T06:18:56Z

BrandonTeng：/* Compose */

== Native廣告支援內容 ==
:TAmedia Native廣告支援下列數種內容：
{| class="wikitable" style="width:50%"
|-
! 廣告內容 !! 內容細節 !! 資料型別
|-
| align="center"| ShortSubject || align="center"| 短標題 || align="center"| String
|-
| align="center"| LongSubject || align="center"| 長標題 || align="center"| String
|-
| align="center"| Body || align="center"| 內文 || align="center"| String
|-
| align="center"| CTA || align="center"| 行動呼籲 || align="center"| String
|-
| align="center"| iconRect || align="center"| 小圖 (長) || align="center"| TWMNativeAd.Image
|-
| align="center"| iconSquare || align="center"| 小圖 (方) || align="center"| TWMNativeAd.Image
|-
| align="center"| image960_640 || align="center"| 大圖 (960x640) || align="center"| TWMNativeAd.Image
|-
| align="center"| image1200_627 || align="center"| 大圖 (1200x627) || align="center"| TWMNativeAd.Image
|-
| align="center"| mediaContent || align="center"| 多媒體素材(影音或主要圖片) || align="center"| TWMMediaContent
|}
 

== SDK Document ==
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view/-t-w-m-native-ad-view/index.html NativeAd]
 

== 實作方式 ==

:步驟1
: 產生一個TWMNativeAd物件, 設定廣告版位adUnitId, 並呼叫load()請求原生廣告
: 監聽TWMAdListener, 透過onReceivedAd()取得原生廣告資訊TWMNativeAd.nativeAdContent
<source>
// Native ad assets.
var body: String? = null
var shortSubject: String? = null
var longSubject: String? = null
var callToAction:String? = null
var iconRect: TWMNativeAd.Image? = null
var iconSquare: TWMNativeAd.Image? = null
var image960x640: TWMNativeAd.Image? = null
var image1200x627: TWMNativeAd.Image? = null
var mediaContent: TWMMediaContent? = null

fun loadAd(context: Context,
adUnitId: String) {
nativeAd = TWMNativeAd(context, adUnitId)
nativeAd?.setAdListener(this)
nativeAd?.loadAd(TWMAdRequest())
}

override fun onReceiveAd(ad: TWMAd) {
this.body = nativeAd?.nativeAdContent?.body
this.shortSubject = nativeAd?.nativeAdContent?.shortSubject
this.longSubject = nativeAd?.nativeAdContent?.longSubject
this.callToAction = nativeAd?.nativeAdContent?.callToAction
this.iconRect = nativeAd?.nativeAdContent?.iconRect
this.iconSquare = nativeAd?.nativeAdContent?.iconSquare
this.image960x640 = nativeAd?.nativeAdContent?.image960_640
this.image1200x627 = nativeAd?.nativeAdContent?.image1200_627
this.mediaContent = nativeAd?.nativeAdContent?.mediaContent
}
</source>

:步驟2
: 使用TWMNativeAdView作為廣告佈局容器, 開發者可在容器中可自行排列文字(TextView)圖形(ImageView)甚至影片(TWMMediaView)等原生廣告
: 下面以短標題, 小圖 (長), Call To Action, 及多媒體素材當範例
<source>
<?xml version="1.0" encoding="utf-8"?>
<com.taiwanmobile.pt.adp.view.TWMNativeAdView xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/nativeAdView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:background="@android:color/holo_orange_light">

<LinearLayout
android:id="@+id/container"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_gravity="center"
android:minHeight="50dp"
android:orientation="vertical"
android:paddingLeft="20dp"
android:paddingRight="20dp">

<TextView
android:id="@+id/tv_short_subject"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="10dp" />

<ImageView
android:id="@+id/iv_icon_rect"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="10dp"/>

<TextView
android:id="@+id/tv_call_to_action"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="10dp" />

<com.taiwanmobile.pt.adp.nativead.TWMMediaView
android:id="@+id/ad_media"
android:layout_width="150dp"
android:layout_height="120dp"
android:layout_marginTop="10dp"/>

</LinearLayout>
</com.taiwanmobile.pt.adp.view.TWMNativeAdView>

</source>

:步驟3
: 將TWMNativeAd.nativeAdContent的廣告資訊套用在上述廣告佈局中
: 並於TWMNativeAdView進行填充(ex. setShortSubjectView()), 賦予點擊後開啟廣告之功能
<source>
val adContent: TWMNativeAdContent? = ad?.nativeAdContent

// shortSubject
adContent?.shortSubject.let { subject ->
// 顯示短標題於TextView之中
vb.tvShortSubject.text = subject
// 於TWMNativeAdView進行填充, 賦予點擊後開啟廣告之功能
vb.nativeAdView.setShortSubjectView(vb.tvShortSubject)
}

// rect icon
adContent?.iconRect?.getDrawable().let { rectDrawable ->
// 顯示小圖 (長)於ImageView之中
vb.ivIconRect.setImageDrawable(rectDrawable)
vb.ivIconRect.adjustViewBounds = true
// 於TWMNativeAdView進行填充, 賦予點擊後開啟廣告之功能
vb.nativeAdView.setRectangleIconView(vb.ivIconRect)
}

// call to action
adContent?.callToAction?.let { cta ->
// 顯示行動呼籲於TextView之中
vb.tvCallToAction.text = cta
// 於TWMNativeAdView進行填充, 賦予點擊後開啟廣告之功能
vb.nativeAdView.setCallToActionView(vb.tvCallToAction)
}

</source>

:步驟4
: 如欲顯示影片廣告, 將mediaContent指派給TWMMediaView, 用TWMMediaView來顯示影片
<source>
// MediaContent
adContent?.mediaContent?.let { content ->
// 顯示TWMMediaContent於TWMMediaView
vb.adMedia.setMediaContent(content)
// 於TWMNativeAdView進行填充, 賦予點擊後開啟廣告之功能(前往了解)
vb.nativeAdView.setMediaView(vb.adMedia)
}

</source>

:步驟5
: 完成上述後, TWMNativeAd物件指派給TWMNativeAdView, 啟動原生廣告顯示 (重要!!!)
<source>
// nativeAd
vb.nativeAdView.setNativeAd(nativeAd)
</source>

 
 

== TWMNativeAdOptions ==
TWMAdRequest.setNativeAdOptions()供開發者相關功能, 調整原生廣告屬性 

:TAmedia Native廣告支援下列數種內容：
{| class="wikitable" style="width:50%"
|-
! 廣告內容 !! 內容細節
|-
| align="center"| DISABLE_IMAGE_LOADING || align="center"| TWMNativeAdContent.Image不含Drawable物件, 加速廣告下載速度
|-
| align="center"| VIDEO_START_UNMUTED || align="center"| TWMMediaView影片初始為有聲音, 預設為靜音
|-
| align="center"| VIDEO_CUSTOM_CONTROLS_REQUESTED || align="center"| TWMMediaView不提供影片控制項, 預設為提供
|-
| align="center"| MEDIA_PREFER_IMAGE || align="center"| TWMMediaView總是顯示圖片, 預設為影片
|}

: 下面例子為影片初始即有聲音
<source>
val adRequest = TWMAdRequest()
adRequest.setNativeAdOptions(arrayOf(TWMNativeAdOptions.VIDEO_START_UNMUTED))
nativeAd?.loadAd(adRequest)
</source>

 
 

== 釋放廣告 ==
請在Activity的生命週期中加入下述的呼叫, 正確釋放TWMNativeAd物件
override fun onDestroy() {
super.onDestroy()
nativeAd?.destroy()
}

 

== 廣告畫面展示 ==
{| border="1"
|-
| align="center" | 文字
| align="center" | 影片
|-
| align="center" | [[image:SDK8 nativead1.png | 300px]]
| align="center" | [[image:SDK8 nativead2.png | 300px]]
|}

 
 

== 進階. 客製化影片撥放元件(選擇性實作, 非必要) ==
當TWMAdRequest.setNativeAdOptions()使用VIDEO_CUSTOM_CONTROLS_REQUESTED
TWMVideoController / TWMMediaContent包含了下列功能, 提供影片相關資訊, 提供開發者客製化自己的影片控制項
 

{| class="wikitable" style="width:50%"
|-
! 函式名稱 !! 功能
|-
| align="center"| TWMVideoController.isMuted() || align="center"| 影片是否靜音中
|-
| align="center"| TWMVideoController.mute(boolean)|| align="center"| 影片靜音
|-
| align="center"| TWMVideoController.setVideoLifecycleCallback(callback) || align="center"| 影片生命週期(VideoLifecycleCallback)
|-
| align="center"| TWMMediaContent.getCurrentTime() || align="center"| 取得目前撥放進度
|-
| align="center"| TWMMediaContent.getDuration() || align="center"| 取得影片長度
|}

== 進階. TWMMediaView 預設UI項目客製化(選擇性實作, 非必要) ==
SDK8支援TWMMediaView UI項目客製化
 
開發者可透過TWMMediaView下列函式對預設UI控制項進行客製化
 
{| class="wikitable" style="width:50%"
|-
! 函式名稱 !! 功能
|-
| align="center"| TWMMediaView.setCTAVisible(visible: Boolean) || align="center"| 設定CTA是否顯示
|-
| align="center"| TWMMediaView.setCTATextSize(textSize: Float)|| align="center"| 設定CTA文字大小
|-
| align="center"| TWMMediaView.setVideoCountdownTextSize(textSize: Float) || align="center"| 設定影片倒數文字大小
|-
| align="center"| TWMMediaView.setVolumeImageSize(imageSize: Int) || align="center"| 設定靜音圖示大小
|}
[[image:TWMMediaView_CustomUI_Demo.png | 300px]]

== 進階. 支援Open-Measurement友善障礙物(選擇性實作, 非必要) ==
SDK8支援Open-Measurement友善障礙物事件處理
 
https://interactiveadvertisingbureau.github.io/Open-Measurement-SDKAndroid/

開發者可透過TWMNativeAdView.addFriendlyObstruction(view, purpose)將與原生廣告相關的控制元件設定為友善障礙物
 
下面以FloatingActionButton為例子, 按鈕本身為影片靜音設定,使用FriendlyObstructionPurpose.VIDEO_CONTROLS為障礙物目的
 
於TWMNativeAd.setNativeAd()之前完成障礙物添加

<source>
// friendlyObstruction
vb.nativeAdView.addFriendlyObstruction(vb.fab, TWMNativeAdView.FriendlyObstructionPurpose.VIDEO_CONTROLS)
vb.fab.setOnClickListener {
adContent?.mediaContent?.getVideoController()?.let { videoController ->
val isMute = videoController.isMuted()
// 設定影片靜音
videoController.mute(!isMute)
when (videoController.isMuted()) {
true -> { vb.fab.setImageResource(R.drawable.ic_baseline_volume_up_24) }
false -> { vb.fab.setImageResource(R.drawable.ic_baseline_volume_mute_24) }
}
}
}

// nativeAd
vb.nativeAdView.setNativeAd(nativeAd)

</source>

{| class="wikitable" style="width:50%"
|-
! 元件總類 !! 描述
|-
| align="center"| FriendlyObstructionPurpose.VIDEO_CONTROLS || align="center"| 影音控制項
|-
| align="center"| FriendlyObstructionPurpose.CLOSE_AD || align="center"| 關閉廣告
|-
| align="center"| FriendlyObstructionPurpose.NOT_VISIBLE || align="center"| 透明元件
|-
| align="center"| FriendlyObstructionPurpose.OTHER || align="center"| 非上述三種類別
|}

== Compose ==
可參考SDK下載包中之Compose範例程式(NativeAdComposeActivity), TWMNativeAdComposable()中有完整的使用方式與介紹
{| width="70%" border="1"
|-
| align="center" | 應用程式開啟(上頁)
| align="center" | 應用程式開啟(下頁)
| align="center" | 無廣告內容
|-
| align="center" | [[檔案:SDK8.0.7_nativead_1.png]]
| align="center" | [[檔案:SDK8.0.7_nativead_2.png]]
| align="center" | [[檔案:SDK8.0.7_nativead_no_fill.png]]
|}

 

== 將應用程式的廣告請求標記為兒童導向內容(13 歲以下) ==
 
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view/-t-w-m-ad-request/index.html TWMAdRequest]
 
 

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

<source>
val nativeAd: TWMNativeAd = TWMNativeAd(context, adUnitId)
nativeAd.setAdListener(this)
nativeAd.loadAd(TWMAdRequest().apply {
setChildDirectedTreatment(true)
})
</source>

[[SDK8_Android_SDK_Developer_Guide | 回首頁]]

2025-11-17T03:40:02Z

BrandonTeng：/* 廣告畫面展示 */

== 簡介 ==
:InRead廣告是SDK8新增的內嵌式廣告, 您可將廣告放置在文章、列表中, 當App使用者滑動到您指定的位置時便可看見InRead廣告, 若該廣告為影音廣告, 會等待廣告出現在畫面中才會進行撥放。 
:InRead廣告為:
<ul>
:<li>Anchor: 固定在螢幕下方的廣告, 廣告高度不會超過螢幕的30%</li>
</ul>
 

:在投放限制方面，由於不同版本的手機支援程度不同，InRead廣告僅會投放在符合下列條件的手機： 
<ol>
:<li>Android 5.0 (API 21) 以上</li>
:<li>Android System WebView 版本43 以上</li>
</ol>
 

:而在介接方式上,下列章節將說明如何串接InRead廣告
 

== SDK Document ==
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view.inread/index.html InRead]
 

== 廣告串接方式 ==
===Anchor ===
:Anchor廣告, 不需事先設置XML或透過程式動態加入廣告View(addView), 只要直接初始InRead物件並請求廣告即可。
<big>Step 1: 廣告初始設置</big> 
:您必須依序輸入Activity、InRead Anchor版位ID以初始化InRead物件, 並且設置Listener偵聽廣告的Callback
:重要! 請務必在onResume、onPause和onDestroy分別加上resume、pause和destroy函式, 避免廣告發生無法預期的問題
class InReadActivityKt:AppCompatActivity() {
private var mTestResult: TextView? =null
private var anchorView: TWMInReadAdAnchor? = null
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_inread)
mTestResult = findViewById(R.id.inread_result)
initAd()
}
private fun initAd() {
anchorView = TWMInReadAdAnchor(this,TAMEDIA_INREAD_ANCHOR_ADUNITID)
anchorView.apply {
anchorView?.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
}
})
}
anchorView?.loadAd(TWMAdRequest())
}
override fun onResume() {
super.onResume()
anchorView?.resume()
}
override fun onPause() {
super.onPause()
anchorView?.pause()
}
override fun onDestroy() {
anchorView?.destroy()
super.onDestroy()
}

companion object{
const val TAMEDIA_INREAD_ANCHOR_ADUNITID: String = "{TAMEDIA_INREAD_ANCHOR_ADUNITID}"
}
}

 
<big>Step 2: 請求廣告</big> 
:請求廣告前，你需要創建一個預設的TWMAdRequest物件
:並將TWMAdReqeust物件傳入loadAd
anchorView?.loadAd(TWMAdRequest())
 
:或是，透過TWMAdRequest設置使用者生日，讓您的APP獲得更多元的廣告內容 
{| class="wikitable"
|-
! 使用Date !! 使用Calendar
|-
| style="width:60%; padding:1%;"|
val adRequest = TWMAdRequest()
try {
//定義好時間字串的格式
val sdf = SimpleDateFormat("yyyy/MM/dd", Locale.getDefault())
//將字串轉成Date型
val birthDate: Date = sdf.parse("1992/01/01")
// 將生日加入request
request.setBirthday(birthDate)
}catch (e: Exception) {}

// 透過TWMAdRequest載入廣告
anchorView.loadAd(adRequest);
| style="width:40%; padding: 1%;"|
// 創建Calendar並設定生日 (注意! 月份的編號是由0至11)
Calendar birthDate = Calendar.getInstance();
// 設定生日為1992/01/01
birthDate[1992, 1] = 1

// 將生日加入request
val request = TWMAdRequest()
request.setBirthday(birthDate)

// 透過TWMAdRequest載入廣告
anchorView.loadAd(request);
|}
 

=== 結束廣告 ===
: destroy() 必須被呼叫, 即使TWMInReadAdAnchor沒有被使用到或參考
<source>
anchorView.destroy()
</source>

=== 硬體加速 ===
:HardWare Acceleration是Android 3.0 (API 11) 加入的feature，該選項在Android 4.0 (API 14)時預設是enable。由於部分InRead廣告會投放影音廣告，請不要將此選項關閉避免影音廣告無法呈現。 
:如有需要在Application Level關閉此選項，請針對要投放InRead廣告的Activity開啟即可，範例如下：
<application android:hardwareAccelerated="false" ...> 
<activity ... />
<activity
android:name=".InReadActivity"
android:hardwareAccelerated="true" ... > 
</activity>
</application>

 

== 廣告畫面展示 ==
{| border="1"
|-
| align="center" | InRead
|-
| align="center" | [[image:SDK8 inread.png | 300px]]
|}

== Compose ==
可參考SDK下載包中之Compose範例程式(InReadComposeActivity), 內有完整的使用方式與介紹
{| width="70%" border="1"
|-
| align="center" | 應用程式開啟
| align="center" | 點擊InRead後開啟網頁
| align="center" | 無廣告內容
|-
| align="center" | [[檔案:SDK8.0.7_inread.png]]
| align="center" | [[檔案:SDK8.0.7_inread_click.png]]
| align="center" | [[檔案:SDK8.0.7_inread_no_fill.png]]
|}
 

== 將應用程式的廣告請求標記為兒童導向內容(13 歲以下) ==
 
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view/-t-w-m-ad-request/index.html TWMAdRequest]
 
 

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

<source>
val inread: TWMInReadAdAnchor = TWMInReadAdAnchor(activity, adUnitId)
inread.setAdListener(this)
inread.loadAd(TWMAdRequest().apply {
setChildDirectedTreatment(true)
})
</source>

[[SDK8_Android_SDK_Developer_Guide | 回首頁]]

檔案:SDK8.0.7 inread.png

2025-11-17T03:37:18Z

BrandonTeng：

檔案:SDK8.0.7 inread no fill.png

2025-11-17T03:33:39Z

BrandonTeng：

檔案:SDK8.0.7 inread click.png

2025-11-17T03:31:14Z

BrandonTeng：

Android InRead Ads SDK8

2025-11-17T03:20:25Z

BrandonTeng：/* Compose */

== 簡介 ==
:InRead廣告是SDK8新增的內嵌式廣告, 您可將廣告放置在文章、列表中, 當App使用者滑動到您指定的位置時便可看見InRead廣告, 若該廣告為影音廣告, 會等待廣告出現在畫面中才會進行撥放。 
:InRead廣告為:
<ul>
:<li>Anchor: 固定在螢幕下方的廣告, 廣告高度不會超過螢幕的30%</li>
</ul>
 

:在投放限制方面，由於不同版本的手機支援程度不同，InRead廣告僅會投放在符合下列條件的手機： 
<ol>
:<li>Android 5.0 (API 21) 以上</li>
:<li>Android System WebView 版本43 以上</li>
</ol>
 

:而在介接方式上,下列章節將說明如何串接InRead廣告
 

== SDK Document ==
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view.inread/index.html InRead]
 

== 廣告串接方式 ==
===Anchor ===
:Anchor廣告, 不需事先設置XML或透過程式動態加入廣告View(addView), 只要直接初始InRead物件並請求廣告即可。
<big>Step 1: 廣告初始設置</big> 
:您必須依序輸入Activity、InRead Anchor版位ID以初始化InRead物件, 並且設置Listener偵聽廣告的Callback
:重要! 請務必在onResume、onPause和onDestroy分別加上resume、pause和destroy函式, 避免廣告發生無法預期的問題
class InReadActivityKt:AppCompatActivity() {
private var mTestResult: TextView? =null
private var anchorView: TWMInReadAdAnchor? = null
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_inread)
mTestResult = findViewById(R.id.inread_result)
initAd()
}
private fun initAd() {
anchorView = TWMInReadAdAnchor(this,TAMEDIA_INREAD_ANCHOR_ADUNITID)
anchorView.apply {
anchorView?.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
}
})
}
anchorView?.loadAd(TWMAdRequest())
}
override fun onResume() {
super.onResume()
anchorView?.resume()
}
override fun onPause() {
super.onPause()
anchorView?.pause()
}
override fun onDestroy() {
anchorView?.destroy()
super.onDestroy()
}

companion object{
const val TAMEDIA_INREAD_ANCHOR_ADUNITID: String = "{TAMEDIA_INREAD_ANCHOR_ADUNITID}"
}
}

 
<big>Step 2: 請求廣告</big> 
:請求廣告前，你需要創建一個預設的TWMAdRequest物件
:並將TWMAdReqeust物件傳入loadAd
anchorView?.loadAd(TWMAdRequest())
 
:或是，透過TWMAdRequest設置使用者生日，讓您的APP獲得更多元的廣告內容 
{| class="wikitable"
|-
! 使用Date !! 使用Calendar
|-
| style="width:60%; padding:1%;"|
val adRequest = TWMAdRequest()
try {
//定義好時間字串的格式
val sdf = SimpleDateFormat("yyyy/MM/dd", Locale.getDefault())
//將字串轉成Date型
val birthDate: Date = sdf.parse("1992/01/01")
// 將生日加入request
request.setBirthday(birthDate)
}catch (e: Exception) {}

// 透過TWMAdRequest載入廣告
anchorView.loadAd(adRequest);
| style="width:40%; padding: 1%;"|
// 創建Calendar並設定生日 (注意! 月份的編號是由0至11)
Calendar birthDate = Calendar.getInstance();
// 設定生日為1992/01/01
birthDate[1992, 1] = 1

// 將生日加入request
val request = TWMAdRequest()
request.setBirthday(birthDate)

// 透過TWMAdRequest載入廣告
anchorView.loadAd(request);
|}
 

=== 結束廣告 ===
: destroy() 必須被呼叫, 即使TWMInReadAdAnchor沒有被使用到或參考
<source>
anchorView.destroy()
</source>

=== 硬體加速 ===
:HardWare Acceleration是Android 3.0 (API 11) 加入的feature，該選項在Android 4.0 (API 14)時預設是enable。由於部分InRead廣告會投放影音廣告，請不要將此選項關閉避免影音廣告無法呈現。 
:如有需要在Application Level關閉此選項，請針對要投放InRead廣告的Activity開啟即可，範例如下：
<application android:hardwareAccelerated="false" ...> 
<activity ... />
<activity
android:name=".InReadActivity"
android:hardwareAccelerated="true" ... > 
</activity>
</application>

 

== 廣告畫面展示 ==
{| border="1"
|-
| align="center" | Anchor
|-
| align="center" | [[image:SDK8 inread.png | 300px]]
|}

== Compose ==
可參考SDK下載包中之Compose範例程式(InReadComposeActivity), 內有完整的使用方式與介紹
{| width="70%" border="1"
|-
| align="center" | 應用程式開啟
| align="center" | 點擊InRead後開啟網頁
| align="center" | 無廣告內容
|-
| align="center" | [[檔案:SDK8.0.7_inread.png]]
| align="center" | [[檔案:SDK8.0.7_inread_click.png]]
| align="center" | [[檔案:SDK8.0.7_inread_no_fill.png]]
|}
 

== 將應用程式的廣告請求標記為兒童導向內容(13 歲以下) ==
 
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view/-t-w-m-ad-request/index.html TWMAdRequest]
 
 

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

<source>
val inread: TWMInReadAdAnchor = TWMInReadAdAnchor(activity, adUnitId)
inread.setAdListener(this)
inread.loadAd(TWMAdRequest().apply {
setChildDirectedTreatment(true)
})
</source>

[[SDK8_Android_SDK_Developer_Guide | 回首頁]]

Android InRead Ads SDK8

2025-11-17T03:13:49Z

BrandonTeng：

== 簡介 ==
:InRead廣告是SDK8新增的內嵌式廣告, 您可將廣告放置在文章、列表中, 當App使用者滑動到您指定的位置時便可看見InRead廣告, 若該廣告為影音廣告, 會等待廣告出現在畫面中才會進行撥放。 
:InRead廣告為:
<ul>
:<li>Anchor: 固定在螢幕下方的廣告, 廣告高度不會超過螢幕的30%</li>
</ul>
 

:在投放限制方面，由於不同版本的手機支援程度不同，InRead廣告僅會投放在符合下列條件的手機： 
<ol>
:<li>Android 5.0 (API 21) 以上</li>
:<li>Android System WebView 版本43 以上</li>
</ol>
 

:而在介接方式上,下列章節將說明如何串接InRead廣告
 

== SDK Document ==
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view.inread/index.html InRead]
 

== 廣告串接方式 ==
===Anchor ===
:Anchor廣告, 不需事先設置XML或透過程式動態加入廣告View(addView), 只要直接初始InRead物件並請求廣告即可。
<big>Step 1: 廣告初始設置</big> 
:您必須依序輸入Activity、InRead Anchor版位ID以初始化InRead物件, 並且設置Listener偵聽廣告的Callback
:重要! 請務必在onResume、onPause和onDestroy分別加上resume、pause和destroy函式, 避免廣告發生無法預期的問題
class InReadActivityKt:AppCompatActivity() {
private var mTestResult: TextView? =null
private var anchorView: TWMInReadAdAnchor? = null
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_inread)
mTestResult = findViewById(R.id.inread_result)
initAd()
}
private fun initAd() {
anchorView = TWMInReadAdAnchor(this,TAMEDIA_INREAD_ANCHOR_ADUNITID)
anchorView.apply {
anchorView?.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
}
})
}
anchorView?.loadAd(TWMAdRequest())
}
override fun onResume() {
super.onResume()
anchorView?.resume()
}
override fun onPause() {
super.onPause()
anchorView?.pause()
}
override fun onDestroy() {
anchorView?.destroy()
super.onDestroy()
}

companion object{
const val TAMEDIA_INREAD_ANCHOR_ADUNITID: String = "{TAMEDIA_INREAD_ANCHOR_ADUNITID}"
}
}

 
<big>Step 2: 請求廣告</big> 
:請求廣告前，你需要創建一個預設的TWMAdRequest物件
:並將TWMAdReqeust物件傳入loadAd
anchorView?.loadAd(TWMAdRequest())
 
:或是，透過TWMAdRequest設置使用者生日，讓您的APP獲得更多元的廣告內容 
{| class="wikitable"
|-
! 使用Date !! 使用Calendar
|-
| style="width:60%; padding:1%;"|
val adRequest = TWMAdRequest()
try {
//定義好時間字串的格式
val sdf = SimpleDateFormat("yyyy/MM/dd", Locale.getDefault())
//將字串轉成Date型
val birthDate: Date = sdf.parse("1992/01/01")
// 將生日加入request
request.setBirthday(birthDate)
}catch (e: Exception) {}

// 透過TWMAdRequest載入廣告
anchorView.loadAd(adRequest);
| style="width:40%; padding: 1%;"|
// 創建Calendar並設定生日 (注意! 月份的編號是由0至11)
Calendar birthDate = Calendar.getInstance();
// 設定生日為1992/01/01
birthDate[1992, 1] = 1

// 將生日加入request
val request = TWMAdRequest()
request.setBirthday(birthDate)

// 透過TWMAdRequest載入廣告
anchorView.loadAd(request);
|}
 

=== 結束廣告 ===
: destroy() 必須被呼叫, 即使TWMInReadAdAnchor沒有被使用到或參考
<source>
anchorView.destroy()
</source>

=== 硬體加速 ===
:HardWare Acceleration是Android 3.0 (API 11) 加入的feature，該選項在Android 4.0 (API 14)時預設是enable。由於部分InRead廣告會投放影音廣告，請不要將此選項關閉避免影音廣告無法呈現。 
:如有需要在Application Level關閉此選項，請針對要投放InRead廣告的Activity開啟即可，範例如下：
<application android:hardwareAccelerated="false" ...> 
<activity ... />
<activity
android:name=".InReadActivity"
android:hardwareAccelerated="true" ... > 
</activity>
</application>

 

== 廣告畫面展示 ==
{| border="1"
|-
| align="center" | Anchor
|-
| align="center" | [[image:SDK8 inread.png | 300px]]
|}

== Compose ==
可參考SDK下載包中之Compose範例程式(InterstitialComposeActivity), 內有完整的使用方式與介紹
{| width="70%" border="1"
|-
| align="center" | 應用程式開啟
| align="center" | 點擊Interstitial後開啟網頁
| align="center" | 無廣告內容
|-
| align="center" | [[檔案:SDK8.0.7_interstitial.png]]
| align="center" | [[檔案:SDK8.0.7_interstitial_click.png]]
| align="center" | [[檔案:SDK8.0.7_interstitial_no_fill.png]]
|}
 

== 將應用程式的廣告請求標記為兒童導向內容(13 歲以下) ==
 
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view/-t-w-m-ad-request/index.html TWMAdRequest]
 
 

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

<source>
val inread: TWMInReadAdAnchor = TWMInReadAdAnchor(activity, adUnitId)
inread.setAdListener(this)
inread.loadAd(TWMAdRequest().apply {
setChildDirectedTreatment(true)
})
</source>

[[SDK8_Android_SDK_Developer_Guide | 回首頁]]

檔案:SDK8.0.7 interstitial no fill.png

2025-11-14T02:26:00Z

BrandonTeng：

檔案:SDK8.0.7 interstitial.png

2025-11-14T02:12:19Z

BrandonTeng：BrandonTeng 上傳了新版本的檔案:SDK8.0.7 interstitial.png

檔案:SDK8.0.7 interstitial.png

2025-11-14T02:11:07Z

BrandonTeng：

Download MADP Android SDK

2025-11-14T02:09:00Z

BrandonTeng：

{| class="wikitable"
|-
! Version !! Package !! Size !! Notes
|-
|2.0.0 || TAMediaSDK_2.0.0 || 1475 KB || Initial release
|-
|2.0.1 || TAMediaSDK_2.0.1 || 1475 KB || 修復若干NullpointerException問題
|-
|2.0.2 || TAMediaSDK_2.0.2 || 1567 KB ||
* 因應google play 內容政策修訂, 增訂對google play sevice的支援
* 修復若干已知問題
|-
|2.0.3 || TAMediaSDK_2.0.3 || 1588 KB ||
* 調整插頁式廣告載入程序以促進更良好的用戶經驗
|-
|2.0.4 || TAMediaSDK_2.0.4 || 1588 KB ||
* 修復因未設定TWMVideoAdListener所導致的NullPointerException問題
* 修復若干畫面顯示不正常的現象
|-
|2.0.5 || TAMediaSDK_2.0.5 || 1587 KB ||

* 功能優化, 支援多種多媒體效果

|-
|2.0.6 || TAMediaSDK_2.0.6 || 1587 KB ||
* SDK穩定性調整
|-
|3.0.0 || TAMediaSDK_3.0.0 || 1876 KB ||
* 提供SMART_BANNER廣告型態
* 提供原生性廣告型態
|-
|3.0.1 || TAMediaSDK_3.0.1 || 1876 KB ||
* 針對插頁式廣告以及影音廣告呈現優化
|-
|4.0.0c ||TAMediaSDK_4.0.0c || 1920 KB ||
* 移除READ_PHONE_STATE權限
* 新增懸浮類型廣告
* 原生性廣告新增支援1200X627圖示
* 全版廣告支援互動效果(麥克風&補光燈)
|-
|4.0.1 ||TAMediaAndroidSDK_4.0.1 || 1920 KB ||
* 廣告效能優化
|-
|5.0.1 ||TAMediaAndroidSDK_5.0.1 || 1.88 MB ||
* SDK 穩定性調整
* 增加互動式插頁廣告種類
* 優化插頁: 小鍵盤不再擋住輸入框
* 調整 Callback 時機
|-
|5.0.2 || TAMediaAndroidSDK_5.0.2 || 2.02 MB ||
* 修正部份 Samsung 手機在特定狀況出現異常的問題
|-
|6.0.0 || TAMediaAndroidSDK_6.0.0 || 539 KB ||
* SDK 穩定性調整
* 新增 InRead 類型廣告
* 網路模組更改為 Retrofit 2
* 導入 MRAID 2.0 架構
|-
|6.1.1 || TAMediaAndroidSDK_6.1.1 || 908 KB ||
* SDK 功能優化
* Minor Fix
|-
|6.1.2 || TAMediaAndroidSDK_6.1.2 || 908 KB ||
* Minor Fix
|-
|6.2.0 || TAMediaAndroidSDK_6.2.0 || 908 KB ||
* SDK 功能優化
|-
|7.0.0 || TAMediaAndroidSDK_7.0.0 || 959 KB ||
* 新增可支援的廣告素材
* SDK 功能優化
|-
|7.0.1 || TAMediaAndroidSDK_7.0.1 || 959 KB ||
* Minor Fix
|-
|7.0.2 || TAMediaAndroidSDK_7.0.2 || 960 KB ||
* Minor Fix
|-
|7.0.3 || TAMediaAndroidSDK_7.0.3 || 4.23 MB ||
* SDK 功能優化
|-
|7.0.4 || TAMediaAndroidSDK_7.0.4 || 4.79 MB ||
* SDK 功能優化
|-
|8.0.0 || TAMediaAndroidSDK_8.0.0 || 2.7 MB ||
* 新增原生廣告整合方式
* 調整橫幅與InRead廣告
* 新增兒童導向廣告設定
|-
|8.0.1 || [[媒體:TAMediaAndroidSDK_8.0.1.zip|TAMediaAndroidSDK_8.0.1]] || 2.7 MB ||
* SDK 功能優化
* 支援Android 12上取得AAID之宣告
|-
|8.0.2 || [[媒體:TAMediaAndroidSDK 8.0.2.zip|TAMediaAndroidSDK_8.0.2]] || 2.81 MB ||
* Minor Fix
|-
|8.0.3 || [[媒體:TAMediaAndroidSDK_8.0.3.zip|TAMediaAndroidSDK_8.0.3]] || 2.68 MB ||
* Minor Fix
|-
|8.0.4 || [[媒體:TAMediaAndroidSDK_8.0.4.zip|TAMediaAndroidSDK_8.0.4]] || 2.71 MB ||
* 原生廣告優化
* 資安修正
* [https://wiki.tamedia.com.tw/wiki/index.php?title=Android_Getting_Started_SDK8#Gradle%E8%A8%AD%E5%AE%9A Gradle更新]
* [https://wiki.tamedia.com.tw/wiki/index.php?title=Android_Proguard_SDK8 Proguard更新]
|-
|8.0.5 || [[媒體:TAMediaAndroidSDK_8.0.5.zip|TAMediaAndroidSDK_8.0.5]] || 1.9 MB ||
* 支援targetSdk=34 (Android 14)
* 修正InRead廣告寬度問題
* [https://wiki.tamedia.com.tw/wiki/index.php?title=Android_Getting_Started_SDK8#Gradle%E8%A8%AD%E5%AE%9A_2 Gradle更新]
* [https://wiki.tamedia.com.tw/wiki/index.php?title=Android_Getting_Started_SDK8#Proguard%E8%A8%AD%E5%AE%9A Proguard更新]
|-
|8.0.6 [[檔案:new-xxl.png|40px]] || [[媒體:TAMediaAndroidSDK_8.0.6.zip|TAMediaAndroidSDK_8.0.6]] || 2.1 MB ||
* 修正Interstitial偶發閃退問題
|-
|8.0.7 [[檔案:under-construction.png|40px]] || [[媒體:TAMediaAndroidSDK_8.0.7.zip|TAMediaAndroidSDK_8.0.7]] || ?.? MB ||
* 支援Kotlin 2.2.0
* 支持Retrofit 3.0.0
* 支持Jetpack Compose開發
|}

[[SDK8_Android_SDK_Developer_Guide|回首頁]]

檔案:SDK8.0.7 interstitial click.png

2025-11-14T02:02:33Z

BrandonTeng：

Android Interstitial Ads SDK8

2025-11-14T01:47:55Z

BrandonTeng：

== 簡介 ==
SDK8
:TWMInterstitialAd為全螢幕大小之廣告, 使用方法跟TWMAdView非常類似, 顯示廣告時需在onReceivedAd()之後呼叫show()函式以便顯示 注意：目前Interstitial廣告有相同版位ID在同一台裝置上，預設為120分鐘展示一次,如需調整請洽服務窗口
 

== SDK Document ==
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view/-t-w-m-interstitial-ad/index.html Interstitial]
 

== 實作方式 ==
*廣告初始設置
var interstitialAd : TWMInterstitialAd? = null
interstitialAd = TWMInterstitialAd(this ,TAMEDIA_INTERSTITIAL_ADUNITID)
companion object{
const val TAMEDIA_INTERSTITIAL_ADUNITID: String = "{TAMEDIA_INTERSTITIAL_ADUNITID}"
}
 

*加入TWMAdViewListener監聽廣告投放情況，並在onReceiveAd Callback內呼叫showAd()
:在onReceiveAd後可透過showAd()顯示廣告
interstitialAd.setAdListener(object : TWMAdViewListener {
override fun onReceiveAd(ad: TWMAd) {
// 表示本次請求收到廣告
interstitialAd?.show()
}
override fun onFailedToReceiveAd(ad: TWMAd, errorCode: TWMAdRequest.ErrorCode) {
// 表示本次請求發生錯誤, 並沒有廣告內容可供使用
}
override fun onPresentScreen(ad: TWMAd) {
// 表示廣告內容已呈現
}
override fun onDismissScreen(ad: TWMAd) {
// 表示廣告內容已被關閉
}
override fun onLeaveApplication(ad: TWMAd) {
// 表示因點擊廣告或其他因素離開app
}
})
 

*請求廣告
:使用預設TWMAdRequest
interstitialAd?.loadAd(TWMAdRequest())

:或是透過TWMAdRequest設置使用者生日，讓您的APP獲得更多元的廣告內容 
{| class="wikitable"
|-
! 使用Date !! 使用Calendar
|-
| style="width:60%; padding:1%;"|
val adRequest = TWMAdRequest()
try {
// 定義好時間字串的格式
val sdf = SimpleDateFormat("yyyy/MM/dd", Locale.getDefault())
// 將字串轉成Date型
val birthDate: Date = sdf.parse("1992/01/01")
// 將生日加入request
request.setBirthday(birthDate)
} catch (e: Exception) {}

// 透過TWMAdRequest載入廣告
twmInterstitial.loadAd(request)
| style="width:40%; padding: 1%;"|
// 創建Calendar並設定生日 (注意! 月份的編號是由0至11)
val birthDate = Calendar.getInstance()
// 設定生日為1992/01/01
birthDate[1992, 1] = 1

// 將生日加入request
val request = TWMAdRequest()
request.setBirthday(birthDate)

// 透過TWMAdRequest載入廣告
twmInterstitial.loadAd(request)
|}
 

*結束廣告
: destroy() 必須被呼叫, 即使Interstitial沒有被使用到或參考
<source>
interstitialAd.destroy()
</source>

== Interstitial畫面展示 ==
{| border="1"
|-
| align="center" | 插頁式廣告呈現
|-
| align="center" | [[檔案:SDK8 inerstitial.png]]
|}
 

== Compose ==
可參考SDK下載包中之Compose範例程式(InterstitialComposeActivity), 內有完整的使用方式與介紹
{| width="70%" border="1"
|-
| align="center" | 應用程式開啟
| align="center" | 點擊Interstitial後開啟網頁
| align="center" | 無廣告內容
|-
| align="center" | [[檔案:SDK8.0.7_interstitial.png]]
| align="center" | [[檔案:SDK8.0.7_interstitial_click.png]]
| align="center" | [[檔案:SDK8.0.7_interstitial_no_fill.png]]
|}
 

== 將應用程式的廣告請求標記為兒童導向內容(13 歲以下) ==
 
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view/-t-w-m-ad-request/index.html TWMAdRequest]
 
 

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

<source>
val interstitialAd: TWMInterstitialAd = TWMInterstitialAd(activity, adUnitId)
interstitialAd.setAdListener(this)
interstitialAd.loadAd(TWMAdRequest().apply {
setChildDirectedTreatment(true)
})
</source>

[[SDK8_Android_SDK_Developer_Guide | 回首頁]]

Android Banner Ads SDK8

2025-11-14T01:44:34Z

BrandonTeng：/* Compose */

== Banner 廣告支援格式 ==
:TAmedia Banner廣告支援下列數種形式：
{| class="wikitable" style="width:50%"
|-
! 廣告格式 !! 大小(寬度x高度) !! TWMAdSize 常數值
|-
| align="center"|BANNER || align="center"|320x50 || align="center"|TWMAdSize.BANNER
|-
| align="center"|BANNER || align="center"|300x250 || align="center"|TWMAdSize.BANNER_300X250
|-
| align="center"|BANNER || align="center"|1200x627 || align="center"|TWMAdSize.BANNER_1200X627
|-
| align="center"|SMART_BANNER || align="center"|自動對應裝置寬度, 並對應適當的高度 || align="center"|TWMAdSize.SMART_BANNER
|}
 

== SDK設計文件 ==
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view/-t-w-m-ad-view/index.html Banner]
 

 

== 實作方式 ==
*廣告初始設置
:動態生成TWMAdView加入Layout中

{| class="wikitable"
|-
! Layout (XML範例) !! Activity(Kotlin)
|-
| style="width:40%; padding:1%;"|
<?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>
| style="width:60%; padding: 1%;"|
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請參考頁首的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?.addView(adView)
|}

:或是將TWMAdView宣告至XML中, 透過findViewById取得TWMAdView
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android=<nowiki>"http://schemas.android.com/apk/res/android"</nowiki>
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical" >
<com.taiwanmobile.pt.adp.view.TWMAdView
xmlns:ad=<nowiki>"http://schemas.android.com/apk/lib/com.taiwanmobile.pt.adp.view"</nowiki>
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>

*加入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
}
})
 

*請求廣告
:請求廣告前，你需要創建一個預設的TWMAdRequest物件
:並將TWMAdReqeust物件傳入loadAd
adView?.loadAd(TWMAdRequest())
 
:或是，透過TWMAdRequest額外設置使用者生日，可讓您的APP獲得更多元的廣告內容 
{| class="wikitable"
|-
! 使用Date !! 使用Calendar
|-
| style="width:60%; padding:1%;"|
val request = TWMAdRequest()
try {
// 定義好時間字串的格式
val sdf = SimpleDateFormat("yyyy/MM/dd", Locale.getDefault())
// 將字串轉成Date型
val birthDate: Date = sdf.parse("1992/01/01")
// 將生日加入request
request.setBirthday(birthDate)
} catch (Exception e) {}

// 透過TWMAdRequest載入廣告
adView?.loadAd(adRequest)
| style="width:40%; padding: 1%;"|
// 創建Calendar設定生日 (注意! 月份的編號是由0至11)
val birthDate = Calendar.getInstance()
// 設定生日為1992/01/01
birthDate[1992, 1] = 1

// 將生日加入request
val adRequest = TWMAdRequest()
request.setBirthday(birthDate)

// 透過TWMAdRequest載入廣告
adView?.loadAd(adRequest)
|}
 

:最後請記得, 於Activity.onDestroy()回收TWMAdView物件
<source>
override fun onDestroy() {
super.onDestroy()
if (view is TWMAdView) {
view.destroy()
}
mRelativeLayout?.removeAllViews()
}
</source>

 

==畫面展示==
{| width="70%" border="1"
|-
| align="center" | 應用程式開啟
| align="center" | 點擊Banner後開啟網頁
| align="center" | 點擊Banner後撥打電話
|-
| align="center" | [[檔案:SDK8 banner.png]]
| align="center" | [[檔案:SDK8 banner click.png]]
| align="center" | [[檔案:4.png]]
|}

 

== Compose ==
可參考SDK下載包中之Compose範例程式(BannerComposeActivity), TWMBannerComposable()中有完整的使用方式與介紹
{| width="70%" border="1"
|-
| align="center" | 應用程式開啟
| align="center" | 點擊Banner後開啟網頁
| align="center" | 無廣告內容
|-
| align="center" | [[檔案:SDK8.0.7_banner.png]]
| align="center" | [[檔案:SDK8.0.7_banner_click.png]]
| align="center" | [[檔案:SDK8.0.7_banner_no_fill.png]]
|}

 

== 將應用程式的廣告請求標記為兒童導向內容(13 歲以下) ==
 
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view/-t-w-m-ad-request/index.html TWMAdRequest]
 
 

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

<source>
val adView: TWMAdView = TWMAdView(activity, adSize, adunitId)
val paramAd = RelativeLayout.LayoutParams(
RelativeLayout.LayoutParams.MATCH_PARENT,
RelativeLayout.LayoutParams.WRAP_CONTENT
)
paramAd.addRule(RelativeLayout.ALIGN_PARENT_BOTTOM)
paramAd.addRule(RelativeLayout.CENTER_HORIZONTAL)
adView?.layoutParams = paramAd
adView?.visibility = View.INVISIBLE
container?.addView(adView)

adView?.loadAd(adRequest.apply {
setChildDirectedTreatment(true)
})
</source>

[[SDK8_Android_SDK_Developer_Guide | 回首頁]]

Download MADP Android SDK

2025-11-14T01:38:25Z

BrandonTeng：

{| class="wikitable"
|-
! Version !! Package !! Size !! Notes
|-
|2.0.0 || TAMediaSDK_2.0.0 || 1475 KB || Initial release
|-
|2.0.1 || TAMediaSDK_2.0.1 || 1475 KB || 修復若干NullpointerException問題
|-
|2.0.2 || TAMediaSDK_2.0.2 || 1567 KB ||
* 因應google play 內容政策修訂, 增訂對google play sevice的支援
* 修復若干已知問題
|-
|2.0.3 || TAMediaSDK_2.0.3 || 1588 KB ||
* 調整插頁式廣告載入程序以促進更良好的用戶經驗
|-
|2.0.4 || TAMediaSDK_2.0.4 || 1588 KB ||
* 修復因未設定TWMVideoAdListener所導致的NullPointerException問題
* 修復若干畫面顯示不正常的現象
|-
|2.0.5 || TAMediaSDK_2.0.5 || 1587 KB ||

* 功能優化, 支援多種多媒體效果

|-
|2.0.6 || TAMediaSDK_2.0.6 || 1587 KB ||
* SDK穩定性調整
|-
|3.0.0 || TAMediaSDK_3.0.0 || 1876 KB ||
* 提供SMART_BANNER廣告型態
* 提供原生性廣告型態
|-
|3.0.1 || TAMediaSDK_3.0.1 || 1876 KB ||
* 針對插頁式廣告以及影音廣告呈現優化
|-
|4.0.0c ||TAMediaSDK_4.0.0c || 1920 KB ||
* 移除READ_PHONE_STATE權限
* 新增懸浮類型廣告
* 原生性廣告新增支援1200X627圖示
* 全版廣告支援互動效果(麥克風&補光燈)
|-
|4.0.1 ||TAMediaAndroidSDK_4.0.1 || 1920 KB ||
* 廣告效能優化
|-
|5.0.1 ||TAMediaAndroidSDK_5.0.1 || 1.88 MB ||
* SDK 穩定性調整
* 增加互動式插頁廣告種類
* 優化插頁: 小鍵盤不再擋住輸入框
* 調整 Callback 時機
|-
|5.0.2 || TAMediaAndroidSDK_5.0.2 || 2.02 MB ||
* 修正部份 Samsung 手機在特定狀況出現異常的問題
|-
|6.0.0 || TAMediaAndroidSDK_6.0.0 || 539 KB ||
* SDK 穩定性調整
* 新增 InRead 類型廣告
* 網路模組更改為 Retrofit 2
* 導入 MRAID 2.0 架構
|-
|6.1.1 || TAMediaAndroidSDK_6.1.1 || 908 KB ||
* SDK 功能優化
* Minor Fix
|-
|6.1.2 || TAMediaAndroidSDK_6.1.2 || 908 KB ||
* Minor Fix
|-
|6.2.0 || TAMediaAndroidSDK_6.2.0 || 908 KB ||
* SDK 功能優化
|-
|7.0.0 || TAMediaAndroidSDK_7.0.0 || 959 KB ||
* 新增可支援的廣告素材
* SDK 功能優化
|-
|7.0.1 || TAMediaAndroidSDK_7.0.1 || 959 KB ||
* Minor Fix
|-
|7.0.2 || TAMediaAndroidSDK_7.0.2 || 960 KB ||
* Minor Fix
|-
|7.0.3 || TAMediaAndroidSDK_7.0.3 || 4.23 MB ||
* SDK 功能優化
|-
|7.0.4 || TAMediaAndroidSDK_7.0.4 || 4.79 MB ||
* SDK 功能優化
|-
|8.0.0 || TAMediaAndroidSDK_8.0.0 || 2.7 MB ||
* 新增原生廣告整合方式
* 調整橫幅與InRead廣告
* 新增兒童導向廣告設定
|-
|8.0.1 || [[媒體:TAMediaAndroidSDK_8.0.1.zip|TAMediaAndroidSDK_8.0.1]] || 2.7 MB ||
* SDK 功能優化
* 支援Android 12上取得AAID之宣告
|-
|8.0.2 || [[媒體:TAMediaAndroidSDK 8.0.2.zip|TAMediaAndroidSDK_8.0.2]] || 2.81 MB ||
* Minor Fix
|-
|8.0.3 || [[媒體:TAMediaAndroidSDK_8.0.3.zip|TAMediaAndroidSDK_8.0.3]] || 2.68 MB ||
* Minor Fix
|-
|8.0.4 || [[媒體:TAMediaAndroidSDK_8.0.4.zip|TAMediaAndroidSDK_8.0.4]] || 2.71 MB ||
* 原生廣告優化
* 資安修正
* [https://wiki.tamedia.com.tw/wiki/index.php?title=Android_Getting_Started_SDK8#Gradle%E8%A8%AD%E5%AE%9A Gradle更新]
* [https://wiki.tamedia.com.tw/wiki/index.php?title=Android_Proguard_SDK8 Proguard更新]
|-
|8.0.5 || [[媒體:TAMediaAndroidSDK_8.0.5.zip|TAMediaAndroidSDK_8.0.5]] || 1.9 MB ||
* 支援targetSdk=34 (Android 14)
* 修正InRead廣告寬度問題
* [https://wiki.tamedia.com.tw/wiki/index.php?title=Android_Getting_Started_SDK8#Gradle%E8%A8%AD%E5%AE%9A_2 Gradle更新]
* [https://wiki.tamedia.com.tw/wiki/index.php?title=Android_Getting_Started_SDK8#Proguard%E8%A8%AD%E5%AE%9A Proguard更新]
|-
|8.0.6 [[檔案:new-xxl.png|40px]] || [[媒體:TAMediaAndroidSDK_8.0.6.zip|TAMediaAndroidSDK_8.0.6]] || 2.1 MB ||
* 修正Interstitial偶發閃退問題
|-
|8.0.7 [[檔案:under-construction.png|40px]] || [[媒體:TAMediaAndroidSDK_8.0.7.zip|TAMediaAndroidSDK_8.0.7]] || ?.? MB ||
* 支援Kotlin 2.2.0
* 支持Retrofit 3.0.0
* 增加Compose範例
|}

[[SDK8_Android_SDK_Developer_Guide|回首頁]]