Difference between revisions of "Android InApp"

From AdLocus
Jump to: navigation, search
(→‎Sample Code)
 
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
在 Activity 中加入以下程式碼
+
== 前言 ==
 +
InApp 版位為最常見的版位,AdLocus 提供您 320x50, 300x250, 728x90 三種不同尺寸的選擇。
 +
 
 +
== 設定 ==
 +
* 在 InApp 的Activity 中加入以下程式碼
 
<syntaxhighlight lang="java">
 
<syntaxhighlight lang="java">
 
import com.adlocus.*;
 
import com.adlocus.*;
  
−
usLayout adlocusLayout =  
+
AdLocusLayout alLayout = new AdLocusLayout(this,  
−
new AdLocusLayout(this,
+
                                          AdLocusLayout.AD_SIZE_BANNER, //廣告大小, 可參考下表的ADSIZE, 非平板建議使用此項即可
−
AdLocusLayout.AD_SIZE_BANNER, //設定廣告大小,通常為 Banner
+
                                          "your app key",               //app key
−
your app key, //填入 app key
+
                                          15                           //輪播時間,最低 15 秒,-1 為不輪播只顯示一則
−
15); //設定輪播時間,最低 15 秒,-1 為不輪播只顯示一則
+
                        );
  
−
// 設定輪播動畫,預設為淡入,範例設定為隨機動畫
+
// 設定輪播動畫: 隨機, 置中
−
adlocusLayout.setTransitionAnimation(AdLocusLayout.ANIMATION_RANDOM);  
+
alLayout.setTransitionAnimation(AdLocusLayout.ANIMATION_RANDOM);
−
LinearLayout.LayoutParams adlocusLayoutParams = new LinearLayout.LayoutParams(
+
LinearLayout.LayoutParams alParams = new LinearLayout.LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT,ViewGroup.LayoutParams.WRAP_CONTENT);
−
ViewGroup.LayoutParams.WRAP_CONTENT,  
+
alParams.gravity = Gravity.CENTER;
−
ViewGroup.LayoutParams.WRAP_CONTENT);
+
 
−
// 設定置中
+
// 監聽廣告可加入下方範例
−
adlocusLayoutParams.gravity = Gravity.CENTER;
+
 
−
// 加入到你的 layout 中
+
// 加入至您的Layout中
−
yourLayout.addView(adlocusLayout, adlocusLayoutParams);
+
yourLayout.addView(alLayout, alParams);
 
yourLayout.setGravity(Gravity.CENTER_HORIZONTAL);
 
yourLayout.setGravity(Gravity.CENTER_HORIZONTAL);
 
yourLayout.invalidate();
 
yourLayout.invalidate();
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
AD SIZE 說明:
+
* AD SIZE 說明
−
AdSize Constant Size (WxH) Availability
+
{| class="wikitable"
−
# AD_SIZE_BANNER 320x50 (dp) 手機及平板
+
|-
−
# AD_SIZE_IAB_MRECT 300x250 (dp) 平板
+
| scope="col"| Constant
−
# AD_SIZE_IAB_LEADERBOARD 728x90 (dp) 平板
+
| scope="col"| Size (WxH)
 +
| scope="col"| Availability
 +
|-
 +
| AD_SIZE_BANNER
 +
| 320x50 (dp)
 +
| 手機及平板
 +
|-
 +
| AD_SIZE_IAB_MRECT
 +
| 300x250 (dp)
 +
| 平板
 +
|-
 +
| AD_SIZE_IAB_LEADERBOARD
 +
| 728x90 (dp)
 +
| 平板
 +
|}
  
 
注意 : 請確保 layout 的空間大於等於您所設定的 AD size,否則將不會展示廣告。
 
注意 : 請確保 layout 的空間大於等於您所設定的 AD size,否則將不會展示廣告。
  
 
== 若您需要監聽廣告互動結果 ==
 
== 若您需要監聽廣告互動結果 ==
−
加入以下程式碼即可監聽相關事件
+
透過 setListener 監測廣告運行結果
 +
 
 +
* onReceiveAd
 +
* onFailedToReceiveAd
 +
** NO_FILL 
 +
** INVAILD_KEY
 +
** NETWORK_ERROR
 +
** SERVICE_ERROR
 +
 
 +
=== Sample Code ===
 
<syntaxhighlight lang="java">
 
<syntaxhighlight lang="java">
−
adlocusLayout.setListener(new AdListener()
+
ALLayout.setListener(new AdListener()
 
{
 
{
 
     @Override
 
     @Override
Line 42: Line 69:
  
 
     @Override
 
     @Override
−
     public void onFailedToReceiveAd(Ad adView, AdLocusLayout$ErrorCode errorCode)
+
     public void onFailedToReceiveAd(Ad adView, AdLocusLayout.ErrorCode errorCode)
 
     {
 
     {
 
         AdLocusLayout layout = (AdLocusLayout)adView; //casting,  
 
         AdLocusLayout layout = (AdLocusLayout)adView; //casting,  

Latest revision as of 16:25, 25 February 2016

前言

InApp 版位為最常見的版位,AdLocus 提供您 320x50, 300x250, 728x90 三種不同尺寸的選擇。

設定

  • 在 InApp 的Activity 中加入以下程式碼
import com.adlocus.*;
 
AdLocusLayout alLayout = new AdLocusLayout(this, 
                                           AdLocusLayout.AD_SIZE_BANNER, //廣告大小, 可參考下表的ADSIZE, 非平板建議使用此項即可
                                           "your app key",               //app key
                                           15                            //輪播時間,最低 15 秒,-1 為不輪播只顯示一則
                         );
 
// 設定輪播動畫: 隨機, 置中
alLayout.setTransitionAnimation(AdLocusLayout.ANIMATION_RANDOM);
LinearLayout.LayoutParams alParams = new LinearLayout.LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT,ViewGroup.LayoutParams.WRAP_CONTENT);
alParams.gravity = Gravity.CENTER;
 
// 監聽廣告可加入下方範例
 
// 加入至您的Layout中
yourLayout.addView(alLayout, alParams);
yourLayout.setGravity(Gravity.CENTER_HORIZONTAL);
yourLayout.invalidate();
  • AD SIZE 說明
Constant Size (WxH) Availability
AD_SIZE_BANNER 320x50 (dp) 手機及平板
AD_SIZE_IAB_MRECT 300x250 (dp) 平板
AD_SIZE_IAB_LEADERBOARD 728x90 (dp) 平板

注意 : 請確保 layout 的空間大於等於您所設定的 AD size,否則將不會展示廣告。

若您需要監聽廣告互動結果

透過 setListener 監測廣告運行結果

  • onReceiveAd
  • onFailedToReceiveAd
    • NO_FILL
    • INVAILD_KEY
    • NETWORK_ERROR
    • SERVICE_ERROR

Sample Code

ALLayout.setListener(new AdListener()
{
    @Override
    public void onReceiveAd(Ad adView) //取得廣告
    {
        AdLocusLayout layout = (AdLocusLayout)adView; //casting
    }
 
    @Override
    public void onFailedToReceiveAd(Ad adView, AdLocusLayout.ErrorCode errorCode)
    {
        AdLocusLayout layout = (AdLocusLayout)adView; //casting, 
 
        switch (errorCode)
        {
            case NO_FILL:          //無廣告展示.
                break; 
            case INVAILD_KEY:      //錯誤的APP KEY.
                break;
            case NETWORK_ERROR:    //網路連線問題
                break;
            case SERVICE_ERROR:    //伺服器忙碌或維護中
                break;
            default:
                break;
        }
    }
});