如何使用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集合了多个主流的平台，在帮助开发者轻松集成多家广告平台的同时，平台随意切换并且还可以方便的进行应用交叉推广，大幅提高广告填充率，实现广告收益最大化。