Google Mobile Ads SDK

https://developers.google.com/mobile-ads-sdk/docs/?hl=zh-CN

使用入门

Google Mobile Ads SDK可让开发者轻松添加适合在移动设备上显示的文字和图片横幅广告，以及丰富的全屏网络应用（称为插页式广告）。我们支持越来越多由用户触摸操作触发的“号召性”内容，包括直接访问App Store、Google Play、Windows Phone 8 Marketplace、iTunes、地图、视频和拨号器。广告可以根据地理位置和受众特征数据进行定位。以下类型的发布商可以使用Google Mobile Ads SDK：

AdMob发布商

访问Google AdMob广告网络，利用您的应用轻松获利。

DFP广告管理系统用户

利用DFP广告管理系统来定位并投放直销广告，进行广告投放管理。升级版DFP广告管理系统( www.google.com/dfp)用户可以在 Android和 iOS平台上使用SDK。

AdSense发布商

通过Google搜索广告，充分利用您的搜索结果页面进行创收。

请按照下面的说明将Google Mobile Ads SDK加入您的开发环境。首先，选择与您的特定平台对应的标签。

Android (Google Play)Android（6.4.1及更低版本SDK）iOSWindows Phone 8

以下说明与Google Play服务中的Mobile Ads API相关。

Google Play服务中的Google Mobile Ads API目前不支持DFP广告管理系统、Ad Exchange和移动应用版搜索广告。

要求

• 请确保您使用的是最新版本的Android SDK，且编译所针对的至少是Android v3.2（将project.properties中的target设为android-13）。
• Google Mobile Ads SDK（Android版）要求使用Android 2.3或更高版本的运行时文件（在AndroidManifest.xml中至少将android:minSdkVersion设为9）。这表示，您可以使用最新版本的Android SDK进行开发，而您的应用仍能在更早版本的Android（最低2.3版）上运行。

加入SDK

将Google移动广告加入应用是一个简单的过程：

1. 在您的Eclipse工作空间中添加和引用Google Play服务库项目。
2. 在AndroidManifest.xml中添加meta-data标记。
3. 在清单中声明com.google.android.gms.ads.AdActivity。
4. 在清单中设置网络权限。

---

1. 添加和引用Google Play服务库项目

如要了解如何设置Google Play服务SDK，请参阅Android说明。

a. 在Eclipse中右键点击您的应用项目，并选择Properties。

 

b. 选择Android，然后点击Add...。找到google-play-services_lib项目，然后选择OK以添加Google Play服务库。

 

c. 项目现在即会引用Google Play服务库。

 

2. 添加meta-data标记

Google Play服务要求您在应用的AndroidManifest.xml的元素内添加以下meta-data标记：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.company"
          android:versionCode="1" android:versionName="1.0">
  <application android:icon="@drawable/icon" android:label="@string/app_name"
               android:debuggable="true">
    <meta-data android:name="com.google.android.gms.version"
               android:value="@integer/google_play_services_version"/>
    <activity android:label="@string/app_name" android:name="BannerExample">
      <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
      </intent-filter>
    </activity>
  </application>
</manifest>

3. 声明com.google.android.gms.ads.AdActivity

Mobile Ads SDK要求您在应用的AndroidManifest.xml中声明com.google.android.gms.ads.AdActivity：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.company"
          android:versionCode="1" android:versionName="1.0">
  <application android:icon="@drawable/icon" android:label="@string/app_name"
               android:debuggable="true">
    <meta-data android:name="com.google.android.gms.version"
               android:value="@integer/google_play_services_version"/>
    <activity android:label="@string/app_name" android:name="BannerExample">
      <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
      </intent-filter>
    </activity>
    <activity android:name="com.google.android.gms.ads.AdActivity"
             android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"/>
  </application>
</manifest>

4. 设置网络权限

要创建广告请求，必须在清单中声明以下权限：

INTERNET

必需。用于访问互联网以发送广告请求。

ACCESS_NETWORK_STATE

可选。用于在发出广告请求前检查是否有可用的互联网连接。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.company"
          android:versionCode="1" android:versionName="1.0">
  <application android:icon="@drawable/icon" android:label="@string/app_name"
               android:debuggable="true">
    <meta-data android:name="com.google.android.gms.version"
               android:value="@integer/google_play_services_version"/>
    <activity android:label="@string/app_name" android:name="BannerExample">
      <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
      </intent-filter>
    </activity>
    <activity android:name="com.google.android.gms.ads.AdActivity"
              android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"/>
  </application>
  <uses-permission android:name="android.permission.INTERNET"/>
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
</manifest>

现在，您应该可以正确无误地重新生成项目了。

加入SDK后，请查看下篇指南以了解如何在您的应用中启用横幅广告。