TAMedia Wiki

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



回首頁