如何使用Eclipse在全應用中集成移動廣告平臺SDK 並在應用中展現橫幅廣告

一:前提條件
1.運行 Eclipse 3.7.2 (Indigo) 或更高版本
2.Eclipse JDT 插件（大多數 Eclipse IDE 程序包中都提供）
3.適用於 Eclipse 的 Android 插件
4.Android SDK


二:建立新項目
在此步驟中，咱們將在 Eclipse 中建立一個全新的項目，以在咱們的快速入門教程中使用。打開 Eclipse，系統將顯示空白工做區，請從菜單中選擇「File」（文件）>「New」（新建）>「Project...」（項目...）。

選擇 Android 文件夾，而後選擇 Android Application Project（Android 應用項目）並點擊「Next」（下一步）。

輸入「BannerExample」做爲應用和項目名稱，並輸入您一般使用的程序包名稱。接下來，爲項目指定必需的最低 SDK 版本 9。該版本是 Google 移動廣告 SDK 支持的最低版本。

爲了讓此快速入門教程簡單易懂，咱們取消選中「Create custom launcher icon」（建立自定義啓動器圖標）複選框。其餘內容可保持不變。

此屏幕中的默認設置便可知足要求。您須要選中「Create Activity」（建立活動）複選框並選擇列表中的「Blank Activity」（空白活動）選項。

一樣，此處的默認選項便是您所需的設置。只需點擊「Finish」（完成），而後 Eclipse 將會建立新項目的源代碼。
Eclipse 完成操做後，您能夠嘗試編譯並運行您的新應用。此時您將會在另外一個空的灰色屏幕上看到一條「Hello world!」消息。


三:下載 Google Play 服務 SDK
Google Play 服務 SDK 包含多個類和資源，您的應用能夠用它們來請求和展現廣告。請打開SDK Manager以確保您使用的是最新版本。您能夠經過選擇「Window」（窗口）>「Android SDK Manager」來查看您的 SDK Manager 是不是最新版本。

在 Android SDK Manager 窗口中，請選擇Extras文件夾下的Google Play services，而後按「Install Packages」（安裝程序包）並接受許可協議以開始下載。若是「Install Packages」（安裝程序包）按鈕不能使用，請不要擔憂。這偏偏說明您已經擁有最新的版本，所以無需在 SDK Manager 中進行任何操做。


四:加入 Google Play 服務庫
下載 Google Play 服務 SDK 後，您能夠在項目中引用它。請從菜單中選擇「File」（文件）>「New」（新建）>「Project…」（項目…）。

選擇 Android 文件夾，而後選擇其中的 Android Project from Existing Code（從現有代碼建立 Android 項目）。


如今您只需告知 Eclipse 庫所在的位置。選擇「Browse」（瀏覽）按鈕並轉到<android-sdk>/extras/google/google_play_services/libproject/google-play-services_lib/，而後點擊「OK」（肯定）按鈕。瀏覽對話框關閉後，您能夠在「Projects」（項目）列表中看到一個條目。請確保選中該條目旁邊的複選框，而後點擊「Finish」（完成）以使用導入的代碼建立一個新項目。


五:引用導入的項目
建立新項目後，您能夠在應用的代碼中引用它。在 Package Explorer 中右鍵點擊 BannerExample，而後選擇「Properties」（屬性）。

選擇左側屬性列表部分中的 Android 選項，而後點擊「Add…」（添加…）按鈕。

您將在列表視圖中看到google-play-services_lib。選擇該選項，而後點擊「OK」（肯定）關閉選擇對話框，而後再關閉屬性對話框。您的應用如今包含對Google Play 服務庫項目的引用，這意味着您的應用可使用 Google Play 服務 SDK 中包含的類和資源。
請嘗試從新構建和運行您的應用，以確保一切正常。您將不會看到任何變化，但添加 Google Play 服務是在應用中投放廣告的第一步。


六:修改清單文件
您已擁有一個包含Google Play服務且可正常運行的應用，如今須要修改該應用的清單文件，以加入移動廣告 SDK 所需的權限、版本號和活動定義。請打開 BannerExample 項目的 Android 清單AndroidManifest.xml以進行修改。該清單位於BannerExample/src/文件夾中，但具體路徑取決於您設置項目時選擇的程序包名稱。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.google.android.gms.example.bannerexample" >

<uses-sdk android:minSdkVersion="9"android:targetSdkVersion="21" />

<!-- Include required permissions for Google Mobile Ads to run-->
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

<application android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >

<!--This meta-data tag is required to use Google Play Services.-->

<meta-data android:name="com.google.android.gms.version"
android:value="@integer/google_play_services_version" />

<activity android:name=".MainActivity"
android:label="@string/app_name" >

        <intent-filter>

<action android:name="android.intent.action.MAIN" />

<category android:name="android.intent.category.LAUNCHER" />

      </intent-filter>

      </activity>

<!--Include the AdActivity configChanges and theme. -->

<activity android:name="com.google.android.gms.ads.AdActivity"
android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"
android:theme="@android:style/Theme.Translucent" />

   </application>

     </manifest>

您須要完成如下三項更改：
1.爲INTERNET和ACCESS_NETWORK_STATE 添加兩個<uses-permission> 標記。INTERNET的標記是必需的，用於訪問互聯網以發送廣告請求。ACCESS_NETWORK_STATE是可選的，用於在發出廣告請求前檢查是否有可用的互聯網鏈接。

2.添加一個引用 Google Play 服務版本的<meta-data>標記。這會讓 Android 知道您的應用但願使用哪一個版本的服務。

3.添加具備configChanges和theme屬性的<activity>元素。當橫幅廣告被點擊或展現插頁式廣告時，SDK 會使用此活動，並且與其餘活動同樣，必須在展現以前在清單中聲明此活動。


七:爲應用指定廣告單元 ID
廣告單元 ID 是爲您的應用中展現廣告的位置指定的惟一標識符。若是您的應用包含兩個活動（每一個活動分別展現一個橫幅廣告），則會有兩個廣告單元，各自擁有本身的 ID。
爲了讓您的新應用展現廣告，您須要在其中加入廣告單元 ID。請打開應用的字符串資源文件，該文件位於BannerExample/res/values/strings.xml。
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="app_name">My Application</string>
    <string name="hello_world">Hello world!</string>
    <string name="action_settings">Settings</string>
    <string name="banner_ad_unit_id">ca-app-pub-3940256099942544/6300978111</string>
</resources>
添加一個新的<string>標記（如上所示）。請注意，上面提供的廣告單元 ID 僅用於測試。經過它您能夠獲取一個橫幅廣告示例，並確保您的實現正確無誤。在開發和測試您的應用時，您應該始終使用測試廣告，使用已發佈的廣告進行測試會違反 AdMob 政策，可能會致使您的賬戶被暫停。請參見addTestDevice 方法的文檔，以詳細瞭解如何使用您的廣告單元 ID 得到測試廣告。


八:在主活動佈局中放置 AdView
還須要執行兩個步驟，您的應用就能夠展現廣告了。首先，您須要修改主活動的佈局以加入一個AdView。請在編輯器中打開BannerExample/res/layout/activity_main.xml。
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent"
xmlns:ads="http://schemas.android.com/apk/res-auto"
android:layout_height="match_parent" android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
android:paddingBottom="@dimen/activity_vertical_margin"
tools:context=".MainActivity">

<TextView android:text="@string/hello_world" android:layout_width="wrap_content"
android:layout_height="wrap_content" />

<com.google.android.gms.ads.AdView
android:id="@+id/adView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerHorizontal="true"
android:layout_alignParentBottom="true"
ads:adSize="BANNER"
ads:adUnitId="@string/banner_ad_unit_id">
</com.google.android.gms.ads.AdView>

</RelativeLayout>
將如下兩項內容添加到 XML：
1.一個用於廣告的命名空間：http://schemas.android.com/apk/res-auto。
2.一個針對 AdView 的新元素。系統會要求您提供layout_width和layout_height。您能夠將這兩項都設置爲wrap_content。在AdView標記中，將adSize設置爲BANNER並將adUnitId設置爲@string/banner_ad_unit_id。


八 :在 MainActivity 類中加載廣告
您須要完成的最後一項更改是嚮應用的主活動類添加一些 Java 代碼，以便將廣告加載到AdView。
打開您的MainActivity.java文件。該文件位於BannerExample/src/文件夾中，但具體的子目錄路徑取決於您在上文中建立項目時使用的網域。在編輯器中打開該文件後，在MainActivity類中查找 onCreate 方法：
package ...

import ...
import ...
import com.google.android.gms.ads.AdRequest;
import com.google.android.gms.ads.AdView;

public class MainActivity extends ActionBarActivity {

protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        AdView mAdView = (AdView) findViewById(R.id.adView);
        AdRequest adRequest = new AdRequest.Builder().build();
        mAdView.loadAd(adRequest);
    }

    ...

}


請執行如下兩項更改：
1.導入AdRequest和AdView類。
2.添加將在佈局中找到AdView的代碼，並建立AdRequest，而後使用它將廣告加載到AdView中。

完成這兩項更改後，您已大功告成！如今您應用的主活動中包含一個具備完整功能的AdView。

九:享用新加載的廣告


KeyMob集合了多個主流的平臺，在幫助開發者輕鬆集成多家廣告平臺的同時，平臺隨意切換而且還能夠方便的進行應用交叉推廣，大幅提升廣告填充率，實現廣告收益最大化。