檢視 Android InRead Ads SDK8 的原始碼

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

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

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

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

== <b>廣告串接方式</b> ==
===<b>Anchor</b> ===
:Anchor廣告, 不需事先設置XML或透過程式動態加入廣告View(addView), 只要直接初始InRead物件並請求廣告即可。
<big><u>Step 1: 廣告初始設置</u></big><br>
:您必須依序輸入<b>Activity</b>、<b>InRead Anchor版位ID</b>以初始化InRead物件, 並且設置Listener偵聽廣告的Callback
:<b><span style="color:red;">重要! 請務必在onResume、onPause和onDestroy分別加上resume、pause和destroy函式, 避免廣告發生無法預期的問題</span></b>
  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,<b>TAMEDIA_INREAD_ANCHOR_ADUNITID</b>)
        anchorView.apply {
            anchorView?.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>
                }
            })
        }
        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 = "<b>{TAMEDIA_INREAD_ANCHOR_ADUNITID}</b>"
    } 
  }

<br>
<big><u>Step 2: 請求廣告</u></big><br>
:請求廣告前，你需要創建一個預設的TWMAdRequest物件
:並將TWMAdReqeust物件傳入loadAd
  anchorView?.loadAd(TWMAdRequest())
<br>
:或是，透過TWMAdRequest設置使用者生日，讓您的APP獲得更多元的廣告內容<br>
{| class="wikitable"
|-
! 使用Date !! 使用Calendar
|-
| style="width:60%; padding:1%;"|
 val adRequest = 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 (e: Exception) {}
  
  <b>// 透過TWMAdRequest載入廣告</b>
  anchorView.loadAd(adRequest);
| style="width:40%; padding: 1%;"|
  <b>// 創建Calendar並設定生日 (注意! 月份的編號是由0至11)</b>
  Calendar birthDate = Calendar.getInstance();
  <b>// 設定生日為1992/01/01</b>
  birthDate[1992, 1] = 1
  
  <b>// 將生日加入request</b>
  val request = TWMAdRequest()
  request.setBirthday(birthDate)
  
  <b>// 透過TWMAdRequest載入廣告</b>
  anchorView.loadAd(request);
|}
<br><br><br>

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

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

<br><br>

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

<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 inread: TWMInReadAdAnchor = TWMInReadAdAnchor(activity, adUnitId)
    inread.setAdListener(this)
    inread.loadAd(TWMAdRequest().apply {
        setChildDirectedTreatment(true)
    })
</source>

[[SDK8_Android_SDK_Developer_Guide | 回首頁]]