概要
Vpon 橫幅廣告 (Banner) 是利用畫面的一小部分展示廣告來吸引使用者點擊,廣告被點擊後即可打開全螢幕呈現更豐富的內容,例如網站或應用程式商店網頁。
完成串接準備
在開始串接廣告之前,請確認您已經將 Vpon SDK 導入您的專案中。若您尚未完成,請先參考串接說明完成相關設定。
開始串接橫幅廣告
Android 應用程式由 View 物件所組成,也就是以文字區域和按鈕等控制項的形式向使用者呈現的 Java 執行個體。VponBanner 是一種 View 子類別,用來顯示由使用者點擊觸發的小型 HTML5 廣告。
和所有的 View 一樣,VpadnBanner 可以使用 Java 撰寫,也可以用 XML 編寫。以下為所需步驟:
- 匯入 com.vpon.ads.*
- 宣告 VponBanner,並指定 License Key
- 建立 VponAdRequest,並請求廣告
- 實作 AdListener
建議您在應用程式的 Activity 內進行上述步驟。
在 MainActivity 中編寫橫幅廣告
請參考以下步驟,在您的 MainActivity 中完成橫幅廣告。
宣告 VponBanner,並請求廣告
import com.vpon.ads.*;
public class MainActivity extends AppCompatActivity {
private RelativeLayout mainLayout;
private VponBanner vponBanner;
private String bannerId = "License Key" ;
// bannerId: Vpon License Key to get ad, please replace with your own one
@Override
protected void onCreate(Bundle savedInstanceState) {
setContentView(R.layout.activity_main);
mainLayout = findViewById(R.id.main_layout);
VponBanner vponBanner = new VponBanner(context, bannerId, adSize);
// adSize: The Banner Ad size that will be displayed
VponAdRequest.Builder builder = new VponAdRequest.Builder();
builder.setAutoRefresh(true);
// Only available for Banner Ad, will auto refresh ad if set true
builder.addTestDevice("your device advertising id");
// Set your test device's GAID here if you're trying to get Vpon test ad
vponBanner.loadAd(builder.build());
// Set ad request and load ad
mainLayout.addView(vponBanner);
}
}
Note: 如果您想要指定更多投放條件,請參考進階設定
在 layout 中編寫橫幅廣告
您也可以直接在 layout 中定義橫幅廣告:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:vpadn="http://schemas.android.com/apk/lib/com.vpadn.ads"
android:id="@+id/mainLayout"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical" >
<RelativeLayout
android:id="@+id/adLayout"
android:layout_width="match_parent"
android:layout_height="wrap_content" >
<!-- Implement Vpon Banner Ad As Below -->
<com.vpon.ads.VponBanner
xmlns:ads="http://schemas.android.com/apk/res-auto"
android:id="@+id/banner"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
vpon:adSize="SMART_BANNER"
vpon:bannerId= "License Key"/>
</LinearLayout>
Note:請記得將 ads:bannerId 改為您的 License Key
實作 AdListener
vponBanner.setAdListener(new VponAdListener() {
@Override
public void onAdLoaded() {
// Invoked if receive ad successfully
}
@Override
public void onAdFailedToLoad(int errorCode) {
// Invoked if received ad fail, check this callback to indicates what type of failure occurred
}
@Override
public void onAdOpened() {
// Invoked if the ad was clicked
}
@Override
public void onAdLeftApplication() {
// Invoked if user leave the app and the current app was backgrounded
}
});
廣告生命週期
為使廣告正常運作,並在適當的時機釋放資源,我們建議可以在 Activity 生命週期中加入以下程式碼:
@Override
protected void onResume() {
super.onResume();
if (vponBanner != null) {
vponBanner.resume();
}
}
@Override
protected void onPause() {
super.onPause();
if (vponBanner != null) {
vponBanner.pause();
}
}
@Override
protected void onDestroy() {
super.onDestroy();
if (vponBanner != null) {
vponBanner.destroy();
vponBanner = null;
}
}
橫幅廣告尺吋
除了支援標準橫幅廣告的尺吋外,Vpon Android SDK 還支援下列幾種尺吋的橫幅廣告:
大小 (寬度x高度) | 說明 | VponAdSize 常數值 |
---|---|---|
320x50 | 標準橫幅廣告 | VponAdSize.BANNER |
300x250 | IAB 中矩形廣告 | VponAdSize.IAB_MRECT |
320x480 | 大型橫幅廣告 | VponAdSize.LARGE_RECTANGLE |
468x60 | IAB 全橫幅廣告 | VponAdSize.IAB_BANNER |
728x90 | IAB 超級橫幅廣告 | VponAdSize.IAB_LEADERBOARD |
Note: Smart Banner 在不同解析度的手機上會產生不同的展示效果,如果您希望展示標準橫幅廣告,我們建議您直接使用
VponAdSize.BANNER
Tips
確認廣告曝光是否成功發送
請注意,Vpon SDK 不允許廣告以以下方式呈現,致使廣告在畫面上可能不可見:
- 將 AdView 設為 Invisible
- 將 AdView 的 Alpha 值設為 < 100%
- AdView 被其它 View(s) 遮蓋住
當廣告露出在頁面上並達到曝光標準後,會印出以下的 Log 代表有送出廣告曝光:
I/VPON: [::Impression::] response.code : 200
Sample Code
如果您想看到完整的串接實例,請參考我們的 Sample Code
適用於 Vpon SDK v4.9 的串接方法
如果您想了解 Vpon SDK v4.9.1 或以下版本的串接方法,請參考橫幅廣告