AdMob Mediation + Vungle SDK v.1.0-v.4.1 (Android) 快速入门指南

本指南介绍了快速将 Vungle Android SDK 添加到 AdMob 中介层的方法。在 AdMob 中介中添加 Vungle 广告要求集成 Vungle 适配器,从而支持 AdMob SDK 与 Vungle SDK 之间的通信。  

目录

1. 开始之前...

2. 将应用添加到 AdMob 仪表板中

3. 将 AdMob SDK 集成到 Android 项目

4. 将 Vungle 适配器和 SDK 集成到 Android 项目

5. Vungle 现在已在 AdMob 中介中

6. 高级功能(可选):解析其他参数

1. 开始之前…

  • 开始学习本教程之前必须先设置 AdMob。要开始设置,请执行以下操作:注册一个 AdMob 帐户.
  • Vungle AdMob Android 适配器同时支持插页式和奖励视频展示位置。

    • 插页式视频广告可在所选展示位置自动播放。Vungle 会调用这些非奖励广告
    • 奖励视频广告由用户选择播放,并且用户在观看广告后可获得奖励。Vungle 会调用这些奖励广告

  • 如果尚未执行此操作,请前往 Vungle 仪表板,并将应用添加到您的帐户。这是获取 Vungle 应用程序 ID 必须执行的操作。您需要使用 Vungle 应用程序 ID 在 AdMob 中初始化 Vungle。

2. 将应用添加到 AdMob 仪表板

  1. 登录 AdMob 仪表板并单击 + 通过新应用获利

  2. 步骤 1 中 - 选择一个应用,如果您的应用在 Google Play Store 中,请单击搜索应用。如果您手动添加应用,请确保选择 Android 作为平台

  3. 步骤 2 中 - 选择广告格式和广告单元

    • 对于插页式广告,请确保选中视频选项,因为所有 Vungle 广告都是视频。



    • 对于奖励插页式广告,请选中设置奖励选项并在奖励金额奖励项目字段中分别输入一个值。Vungle 支持使用第三方广告网络设置功能。

  4. 添加应用后,请按照本指南将 Vungle 添加为广告网络

    • 单击 + 新建广告网络并从左侧面板中选择 Vungle。在 Vungle 仪表板中找到您的 Vungle 应用程序 ID(Vungle 对插页式广告和奖励插页式广告使用同一个应用程序 ID)。

    • 对于广告网络优化(可选),请输入报告 API 密钥,以通过 Vungle 报告 API 将 AdMob 访问权限分配给 eCPM。(如果没有密钥,请参阅如何申请报告 API 密钥?

3. 将 AdMob SDK 集成到 Android 项目

请按照 AdMob 的 Android Studio 入门指南将 AdMob SDK 集成到 Android 项目,然后继续按照 AdMob 的插页式广告指南和/或奖励广告:广告发布商入门指南申请和展示广告。

4. 将 Vungle 适配器和 SDK 集成到 Android 项目

  1. 下载 Vungle AdMob 适配器
  2. 下载 Vungle Android SDK
  3. 将 Vungle AdMob 适配器(一个 .aar 文件)和 Vungle SDK(三个 .jar 文件)添加到项目库:



  4. 更新 build.gradle 文件:
    dependencies {
      compile fileTree(dir: 'libs', include: ['*.jar'])  // Vungle SDK
      compile(name:'VungleAdapter', 'ext':'aar')  //AdMob Vungle 适配器
    }
    repositories {
      jcenter()
      flatDir {
          dirs 'libs'
      }
    }
  5. 更新 AndroidManifest.xml 文件中的 Vungle 权限和活动:

    <manifest>
    ...
    <!-- 下载和缓存要播放的视频广告的权限 -->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"android:maxSdkVersion="18"/> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

    <application>
    ...
    <!-- 播放 Vungle 视频广告的必要活动 -->

    <activity android:name="com.vungle.publisher.VideoFullScreenAdActivity"
    android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize"
    android:theme="@android:style/Theme.NoTitleBar.Fullscreen"/>
    <activity android:name="com.vungle.publisher.MraidFullScreenAdActivity"
    android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize"
    android:theme=
    "@android:style/Theme.Translucent.NoTitleBar.Fullscreen"/>
    </application>
    </manifest>

5. Vungle 现在已在 AdMob 中介中

Vungle 现在与您选择的其他广告网络在一起,均在默认 AdMob 瀑布中。现在,您只需要测试集成,提交应用,然后将 Vungle 和 AdMob 退出测试模式,即可开始投放!

有关 Vungle Android SDK 的一般信息,请参阅以下指南:

* 请注意,当点击广告并启动浏览器/应用商店时,不会调用 onAdLeftApplication() 回调。

6. 高级功能(可选):传递其他参数

Android SDK v4.0.3 和 AdMob 适配器 v2.1.0 支持附加参数。

方法 

说明

setUserId

设置要传递给 Vungle SDK 的唯一用户 ID,以在非奖励广告的服务器到服务器回调中使用。

setSoundEnabled

设置广告的启动声音状态。如果设置为“假”,视频启动时将保持静音,但用户可修改。

集成代码示例:


// 构架网络附加捆绑
Bundle extras = new VungleExtrasBuilder()
       .setUserId("userId")
       .setSoundEnabled(false)
       .build();
// 构建奖励广告的请求
AdRequest rewardedAdRequest = new AdRequest.Builder()
       .addNetworkExtrasBundle(VungleAdapter.class, extras)
       .build();
rewardedAd.loadAd(REWARDED_AD_UNIT_ID, rewardedAdRequest);
// 或对于插页式广告
AdRequest interstitialAdRequest = new AdRequest.Builder()
       .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras)
       .build();
// 加载广告
interstitialAd.loadAd(interstitialAdRequest);
还有其它问题?提交请求

评论