Android NativeAds

• 宣告原生性廣告版位

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

  // 第一個參數為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());

(Optional) 在載入廣告前，可以透過TWMAdRequest設置使用者生日，讓您的APP獲得更多元的廣告內容

使用Date	使用Calendar
TWMAdRequest request = new TWMAdRequest(); try { //定義好時間字串的格式 SimpleDateFormat sdf = new SimpleDateFormat("yyyy/MM/dd", Locale.getDefault()); //將字串轉成Date型 Date birthDate = sdf.parse("1992/01/01"); // 將生日加入request request.setBirthday(birthDate); }catch (Exception e) {} // 透過TWMAdRequest載入廣告 twmNativeAd.loadAd(request);	// 創建Calerdar並設定生日 (注意! 月份的編號是由0至11) Calendar birthDate = Calendar.getInstance(); // 設定生日為1992/01/01 birthDate.set(1992, 0, 1); // 將生日加入request TWMAdRequest request = new TWMAdRequest(); request.setBirthday(birthDate); // 透過TWMAdRequest載入廣告 twmNativeAd.loadAd(request);

onReceiveAd(載入廣告完成)後，透過getNativeAdContent取得的JSONObject內容如下 :

{
  "LONGSUBJECT": "長標題 long subject ,※預設值為空字串",
  "SHORTSUBJECT": "短標題 short subject ,※預設值為空字串",
  "BODY": "內文 body ,※預設值為空字串",
  "ICONSQUARE": "小圖示 方 icon square ,※預設值為空字串",
  "ICONRECTANGLE": "小圖示 長 icon rectangle,※預設值為空字串",
  "VIDEO": "影片 video,※預設值為空字串",
  "IMAGE1280X720": "大圖 1280x720,※預設值為空字串",
  "IMAGE960X640": "大圖 960x640,※預設值為空字串",
  "IMAGE1200X627": "大圖 1200x627,※預設值為空字串"  
}

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

點擊處理

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

(SDK5以上) 請在Activity的生命週期中加入下述的呼叫, 以正確release NativeAd

 @Override
 public void onDestroy() {
   if(twmNativeAd != null){
     twmNativeAd.destroy();
   }
   super.onDestroy();
 }

原生性廣告內容與廣告版位關係表
※重要, 下表所描述的廣告素材有可能因廣告主未提供素材, 而以空字串提供, 使用上請特別留意

素材 \ 版位	限制條件	條列式	圖片式 (橫 16:9)	圖片式 (橫 3:2)	小圖式	影音式
長標題 (LONGSUBJECT)	25字內	V	V	V		V
短標題 (SHORTSUBJECT)	10字內	V	V	V	V
內文 (BODY)	70字內	V	V	V		V
小圖 (方) (ICONSQUARE)	120x120 jpg/png	V			V	V
小圖 (長) (ICONRECTANGLE)	96x64 jpg/png	V				V
影片 (VIDEO)	MP4, 10mb					V
大圖 (橫 16:9) (IMAGE1280X720)	1280x720 jpg/png		V
大圖 (橫 3:2) (IMAGE960X640)	960x640 jpg/png			V		V
大圖 (IMAGE1200X627)	1200x627 jpg/png	V	V	V	V	V

回首頁