檢視 Android NativeAds 的原始碼

:*宣告原生性廣告版位
TWMNativeAd以簡單且單純的方式, 提供廣告內容供開發商使用,可在收到onReceivedAd()呼叫getNativeAdContent()取得原生廣告內容, 並解析

<source lang="java" collapse="false" title="Native Ad">
  // 第一個參數為Activity or Context, 第二個參數請輸入您的版位ID
  TWMNativeAd twmNativeAd = new TWMNativeAd(this, AD_UNIT_ID);
  twmNativeAd.setAdListener(new TWMAdViewListener() {
  @Override
  public void onReceiveAd(TWMAd paramTWMAd) {
     // 表示本次請求收到廣告,
     // 呼叫getNativeAdContent()取得廣告內容
     JSONObject adContent = twmNativeAd.getNativeAdContent();
  }
  @Override
  public void onFailedToReceiveAd(TWMAd paramTWMAd, ErrorCode paramErrorCode) {
     // 表示本次請求發生錯誤, 並沒有廣告內容可供使用
  }
  @Override
  public void onPresentScreen(TWMAd paramTWMAd) {
     // native ad 並不使用本介面功能
  }
  @Override
  public void onDismissScreen(TWMAd paramTWMAd) {
     // native ad 並不使用本介面功能
  }
  @Override
  public void onLeaveApplication(TWMAd paramTWMAd) {
     // native ad 並不使用本介面功能
  }
  });
 // 透過TWMAdRequest載入廣告
 twmNativeAd.loadAd(new TWMAdRequest());
</source>

(Optional) 在載入廣告前，可以透過TWMAdRequest設置使用者生日，讓您的APP獲得更多元的廣告內容<br>
{| class="wikitable"
|-
! 使用Date !! 使用Calendar
|-
| style="width:60%; padding:1%;"|
  TWMAdRequest request = new TWMAdRequest();
  try {
  	<b>//定義好時間字串的格式</b>
  	SimpleDateFormat sdf = new SimpleDateFormat("yyyy/MM/dd", Locale.getDefault());
  	<b>//將字串轉成Date型</b>
  	Date birthDate = sdf.parse("1992/01/01");
  	<b>// 將生日加入request</b>
  	request.setBirthday(birthDate);
  }catch (Exception e) {}
  
  <b>// 透過TWMAdRequest載入廣告</b>
  twmNativeAd.loadAd(request);
| style="width:40%; padding: 1%;"|
  <b>// 創建Calerdar並設定生日 (注意! 月份的編號是由0至11)</b>
  Calendar birthDate = Calendar.getInstance();
  <b>// 設定生日為1992/01/01</b>
  birthDate.set(1992, 0, 1);
  
  <b>// 將生日加入request</b>
  TWMAdRequest request = new TWMAdRequest();
  request.setBirthday(birthDate);
  
  <b>// 透過TWMAdRequest載入廣告</b>
  twmNativeAd.loadAd(request);
|}

onReceiveAd(載入廣告完成)後，透過getNativeAdContent取得的JSONObject內容如下 :
<source>
{
  "LONGSUBJECT": "長標題 long subject ,※預設值為空字串",
  "SHORTSUBJECT": "短標題 short subject ,※預設值為空字串",
  "BODY": "內文 body ,※預設值為空字串",
  "ICONSQUARE": "小圖示 方 icon square ,※預設值為空字串",
  "ICONRECTANGLE": "小圖示 長 icon rectangle,※預設值為空字串",
  "VIDEO": "影片 video,※預設值為空字串",
  "IMAGE1280X720": "大圖 1280x720,※預設值為空字串",
  "IMAGE960X640": "大圖 960x640,※預設值為空字串",
  "IMAGE1200X627": "大圖 1200x627,※預設值為空字串"  
}</source>

開發商們可依照APP最恰當的方式來將取得的廣告內容佈局在APP的呈現上

點擊處理
<source>
 // 處理點擊時可以下述的方式來進行
….
View.setOnClickListener(new OnClickListener(){
    @Override
    public void onClick(View v){
         if(twmNativeAd != null){
            twmNativeAd.handleClick();
         }
    }
});

</source>

<b><span style="color:#ff0000">(SDK5以上) 請在Activity的生命週期中加入下述的呼叫, 以正確release NativeAd</span></b>
  @Override
  public void onDestroy() {
    if(twmNativeAd != null){
      twmNativeAd.destroy();
    }
    super.onDestroy();
  }


原生性廣告內容與廣告版位關係表
<br>
<b><span style="color:#ff0000">※重要, 下表所描述的廣告素材有可能因廣告主未提供素材, 而以空字串提供, 使用上請特別留意</span></b>
{| width="100%" border="1"
|-
| align="center" | 素材 \  版位
| align="center" | 限制條件
| align="center" | 條列式
| align="center" | 圖片式 (橫 16:9)
| align="center" | 圖片式 (橫 3:2)
| align="center" | 小圖式
| align="center" | 影音式
|-
| align="center" | 長標題<br/>(LONGSUBJECT)
| align="center" | 25字內
| align="center" | V
| align="center" | V
| align="center" | V
| align="center" | 
| align="center" | V
|-
| align="center" | 短標題<br/>(SHORTSUBJECT)
| align="center" | 10字內
| align="center" | V
| align="center" | V
| align="center" | V
| align="center" | V
| align="center" | 
|-
| align="center" | 內文<br/>(BODY)
| align="center" | 70字內
| align="center" | V
| align="center" | V
| align="center" | V
| align="center" | 
| align="center" | V
|-
| align="center" | 小圖 (方)<br/>(ICONSQUARE)
| align="center" | 120x120<br/>jpg/png
| align="center" | V
| align="center" | 
| align="center" | 
| align="center" | V
| align="center" | V
|-
| align="center" | 小圖 (長)<br/>(ICONRECTANGLE)
| align="center" | 96x64<br/>jpg/png
| align="center" | V
| align="center" | 
| align="center" | 
| align="center" | 
| align="center" | V
|-
| align="center" | 影片<br/>(VIDEO)
| align="center" | MP4, 10mb
| align="center" | 
| align="center" | 
| align="center" | 
| align="center" | 
| align="center" | V
|-
| align="center" | 大圖 (橫 16:9)<br/>(IMAGE1280X720)
| align="center" | 1280x720<br/>jpg/png
| align="center" | 
| align="center" | V
| align="center" | 
| align="center" | 
| align="center" |
|-
| align="center" | 大圖 (橫 3:2)<br/>(IMAGE960X640)
| align="center" | 960x640<br/>jpg/png
| align="center" | 
| align="center" | 
| align="center" | V
| align="center" | 
| align="center" | V
|-
| align="center" | 大圖<br/>(IMAGE1200X627)
| align="center" | 1200x627<br/>jpg/png
| align="center" | V
| align="center" | V
| align="center" | V
| align="center" | V
| align="center" | V
|}

<br><br>
[[Android SDK Developer Guide 2 | 回首頁]]