跳至主要内容

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

回首頁

最後於 更新