檢視 Android Banner Ads SDK8 的原始碼

== <b>Banner 廣告支援格式</b> ==
:<span style="font-size:16px;">TAmedia Banner廣告支援下列數種形式：</span>
{| 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
|}
<br><br>

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

<br><br>

== <b>實作方式</b> ==
*<span style="font-size:16px;">廣告初始設置</span>
:動態生成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 ... 
  
  <b>// 依序傳入Activity, TWMAdSize, 以及Ad Unit Id，TWMAdSize請參考頁首的TWMAdSize常數值</b>
  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>

*<span style="font-size:16px;">加入TWMAdViewListener監聽廣告投放情況</span>
  adView.setAdListener(object : TWMAdViewListener {
     override fun onReceiveAd(ad: TWMAd) {
          <b>// 表示本次請求收到廣告</b>
     }
     override fun onFailedToReceiveAd(ad: TWMAd, errorCode: TWMAdRequest.ErrorCode) {
          <b>// 表示本次請求發生錯誤, 並沒有廣告內容可供使用</b>
     }
     override fun onPresentScreen(ad: TWMAd) {
          <b>// 表示廣告內容已呈現</b>
     }
     override fun onDismissScreen(ad: TWMAd) {
          <b>// 表示廣告內容已被關閉</b>
     }
     override fun onLeaveApplication(ad: TWMAd) {
          <b>// 表示因點擊廣告或其他因素離開app</b>
     }
  })
<br><br>

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

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

<br><br>

==<b>畫面展示</b>==
{| 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]]
|}

<br><br>

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

:請於廣告請求時透過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 | 回首頁]]