「Android NativeAds」修訂間的差異

出自TAMedia
跳至導覽 跳至搜尋
imported>Wikiuser
imported>Wikiuser
 
(未顯示同一使用者於中間所作的 4 次修訂)
行 33: 行 33:
</source>
</source>


getNativeAdContent所取的JSONObject內容如後 :
(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>
<source>
{
{
行 128: 行 160:
|-
|-
| align="center" | 影片<br/>(VIDEO)
| align="center" | 影片<br/>(VIDEO)
| align="center" | 96x64<br/>MP4, 10mb
| align="center" | MP4, 10mb
| align="center" |  
| align="center" |  
| align="center" |  
| align="center" |  
行 159: 行 191:
| align="center" | V
| align="center" | V
|}
|}
<br><br>
[[Android SDK Developer Guide 2 | 回首頁]]

於 2019年9月3日 (二) 03:52 的最新修訂

  • 宣告原生性廣告版位

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



回首頁