CocosCreator接入GoogleAdMob激励广告

以你之姓@ 2022-02-03 12:15 1674阅读 0赞

我们的App需要通过接入广告的方式来赚取收入，其中GoogleAdMob就是比较简单容易实现的一种。

我在文章中接入GoogleAdmob的方式是通过AndroidStudio原生来接入的。

# #

## 一、前提条件 ##

*  使用 Android Studio 1.0 或更高版本
 *  定位到 Android API 级别 14 或更高级别
 *  推荐：[创建 Google AdMob 帐号][Google AdMob]并[注册应用][Link 1]。

# #

## 二、广告类型 ##

### 横幅广告 ###

![20190509144956228.png][]横幅广告是在应用布局中占据一处位置的矩形图片或文字广告。用户与应用互动时，这类广告会停留在屏幕上，并且可在一段时间后自动刷新。如果您刚开始接触移动广告，建议从横幅广告着手。

### 插页式广告 ###

![20190509145124203.png][]插页式广告是全屏广告，它会覆盖整个应用界面，直到用户将其关闭。在应用执行流程的自然停顿点，例如游戏的不同关卡之间，或一项任务完成后，最适合投放这类广告。

### 原生广告 ###

![20190509145211724.png][]原生广告是一种基于组件的广告格式，可让您自由地自定义素材资源（如标题和号召性用语）在应用中的呈现方式。通过自行选择字体、颜色和其他详细信息，您可以呈现出自然而不突兀的广告展示效果，进而提供更丰富的用户体验。

目前，原生广告尚处于封闭测试阶段，仅面向部分发布商提供。

### 激励广告 ###

![20190509145302944.png][]激励视频广告是一种全屏视频广告，用户可选择使用全屏模式观看，以换取应用内奖励。

下面，我们将开展激励广告的接入方式。

## 三、初始化全局SDK ##

**1.在app文件夹外部的build.gradle文件中增加这两行**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70][]

allprojects {
        repositories {
            google()
            jcenter()
        }
    }

当然，如果有了就不用加了。

**2.在app文件夹内部的build.gradle文件中增加这一行**

![20190509152153784.png][]

implementation 'com.google.android.gms:play-services-ads:17.2.0'

输入这行后同步一下：![20190509154523955.png][]

**3.在AndroidManifest.xml里增加以下内容：**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 1][]

其中的YOUR\_ADMOB\_APP\_ID就是上图中你的AdMob账号中的“应用ID”。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 2][]

**4.初始化MobileAds**

加载广告之前，请先使用AdMob“应用ID”调用MobileAds.initialize()，以便让应用初始化移动广告SDK。此操作仅需要执行一次，最好是在应用启动时执行。

在AppActivity.java中加入以下代码：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 3][]

package ...
    import ...
    import com.google.android.gms.ads.MobileAds;
    
    public class MainActivity extends AppCompatActivity {
        ...
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
    
            // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
            MobileAds.initialize(this, "YOUR_ADMOB_APP_ID");
        }
        ...
    }

至此，初始化已经完成了，如果要接入不同类型的广告，就可以直接接入。

## 四、接入激励广告SDK ##

当我们接到需要接入广告的需求的时候，可能我们App功能还没开发完成，还没上线到商店里，这样也可以接入广告测试吗？

答案当然是可以。

GoogleAdMob提供了测试广告ID：

<table> 
 <thead> 
  <tr> 
   <th>广告格式</th> 
   <th style="width:596px;">示例广告单元 ID</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><a href="https://developers.google.com/admob/android/banner#add_adview" rel="nofollow">横幅广告</a></td> 
   <td style="width:596px;"><code>ca-app-pub-3940256099942544/6300978111</code></td> 
  </tr> 
  <tr> 
   <td><a href="https://developers.google.com/admob/android/interstitial#create_an_interstitial_ad_object" rel="nofollow">插页式广告</a></td> 
   <td style="width:596px;"><code>ca-app-pub-3940256099942544/1033173712</code></td> 
  </tr> 
  <tr> 
   <td><a href="https://developers.google.com/admob/android/interstitial#create_an_interstitial_ad_object" rel="nofollow">插页式视频广告</a></td> 
   <td style="width:596px;"><code>ca-app-pub-3940256099942544/8691691433</code></td> 
  </tr> 
  <tr> 
   <td><a href="https://developers.google.com/admob/android/rewarded-video#request_rewarded_video_ad" rel="nofollow">激励视频广告</a></td> 
   <td style="width:596px;"><code>ca-app-pub-3940256099942544/5224354917</code></td> 
  </tr> 
  <tr> 
   <td><a href="https://developers.google.com/admob/android/native-advanced#build_an_adloader" rel="nofollow">原生高级广告</a></td> 
   <td style="width:596px;"><code>ca-app-pub-3940256099942544/2247696110</code></td> 
  </tr> 
  <tr> 
   <td><a href="https://developers.google.com/admob/android/native-advanced#build_an_adloader" rel="nofollow">原生高级视频广告</a></td> 
   <td style="width:596px;"><code>ca-app-pub-3940256099942544/1044960115</code></td> 
  </tr> 
 </tbody> 
</table>

在这里，我们首先初始化激励广告的SDK功能：

**1.在AppActivity.java中加入以下代码**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 4][]

public class AppActivity extends Cocos2dxActivity {
    
        private RewardedVideoAd mRewardedVideoAd;
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            // Workaround in https://stackoverflow.com/questions/16283079/re-launch-of-activity-on-home-button-but-only-the-first-time/16447508
            if (!isTaskRoot()) {
                // Android launched another instance of the root activity into an existing task
                //  so just quietly finish and go away, dropping the user back into the activity
                //  at the top of the stack (ie: the last state of this task)
                // Don't need to finish it again since it's finished in super.onCreate .
                return;
            }
            // DO OTHER INITIALIZATION BELOW
            
            SDKWrapper.getInstance().init(this);
            CAAgent.enableDebug(false);
    
            // Sample AdMob app ID:
            MobileAds.initialize(this, "不能说");
    
    
            // Use an activity context to get the rewarded video instance.
            mRewardedVideoAd = MobileAds.getRewardedVideoAdInstance(this);
            mRewardedVideoAd.setRewardedVideoAdListener(this);
    
            loadRewardedVideoAd();
        }
    
        private void loadRewardedVideoAd() {
            mRewardedVideoAd.loadAd("ca-app-pub-3940256099942544/5224354917",
                    new AdRequest.Builder().build());
        }
    
        @Override
        public void onRewarded(RewardItem reward) {
            Toast.makeText(this, "onRewarded! currency: " + reward.getType() + "  amount: " +
                    reward.getAmount(), Toast.LENGTH_SHORT).show();
            // Reward the user.
        }
    
        .....
    }

**2.实现RewardedVideoAdListener接口**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 5][]

public class AppActivity extends Cocos2dxActivity implements RewardedVideoAdListener

@Override
        public void onRewarded(RewardItem reward) {
            Toast.makeText(this, "onRewarded! currency: " + reward.getType() + "  amount: " +
                    reward.getAmount(), Toast.LENGTH_SHORT).show();
            // Reward the user.
        }
    
        @Override
        public void onRewardedVideoAdLeftApplication() {
            Toast.makeText(this, "onRewardedVideoAdLeftApplication",
                    Toast.LENGTH_SHORT).show();
        }
    
        @Override
        public void onRewardedVideoAdClosed() {
            Toast.makeText(this, "onRewardedVideoAdClosed", Toast.LENGTH_SHORT).show();
        }
    
        @Override
        public void onRewardedVideoAdFailedToLoad(int errorCode) {
            Toast.makeText(this, "onRewardedVideoAdFailedToLoad", Toast.LENGTH_SHORT).show();
        }
    
        @Override
        public void onRewardedVideoAdLoaded() {
            Toast.makeText(this, "onRewardedVideoAdLoaded", Toast.LENGTH_SHORT).show();
        }
    
        @Override
        public void onRewardedVideoAdOpened() {
            Toast.makeText(this, "onRewardedVideoAdOpened", Toast.LENGTH_SHORT).show();
        }
    
        @Override
        public void onRewardedVideoStarted() {
            Toast.makeText(this, "onRewardedVideoStarted", Toast.LENGTH_SHORT).show();
        }
    
        @Override
        public void onRewardedVideoCompleted() {
            Toast.makeText(this, "onRewardedVideoCompleted", Toast.LENGTH_SHORT).show();
        }

**3.反复播放广告**

把上面的onRewardedVideoAdClosed方法修改一下：

@Override
    public void onRewardedVideoAdClosed() {
        // Load the next rewarded video ad.
        loadRewardedVideoAd();
    }

然后再在我们需要弹出广告的地方调用以下方法：

if (mRewardedVideoAd.isLoaded()) {
        mRewardedVideoAd.show();
    }

注意：我们需要在广告加载完成，也就是isLoaded()为true的时候调用。

至此，我们调用广告的功能就完成了！！！。。。。

**4.做一个优化：有用的回调**

要将父级 Activity 的生命周期事件转发给 `RewardedVideoAd` 对象，可在父级 Activity 的 `onResume()`、`onPause()` 和 `onDestroy()` 方法中分别调用 `resume()`、`pause()` 和 `destroy()` 方法。

@Override
    public void onResume() {
        mRewardedVideoAd.resume(this);
        super.onResume();
    }
    
    @Override
    public void onPause() {
        mRewardedVideoAd.pause(this);
        super.onPause();
    }
    
    @Override
    public void onDestroy() {
        mRewardedVideoAd.destroy(this);
        super.onDestroy();
    }

这一个生命周期的回调有挺大的用处的，大家可以思考一下这个用处是什么。

[Google AdMob]: https://support.google.com/admob/answer/2784575
[Link 1]: https://support.google.com/admob/answer/2773509
[20190509144956228.png]: /images/20220203/1db84842012a47a5ac96cf52c36a5807.png
[20190509145124203.png]: /images/20220203/78281c2cd15745c7afd27372af98ea99.png
[20190509145211724.png]: /images/20220203/5e86536158af45d29f6890263e5b54f5.png
[20190509145302944.png]: /images/20220203/a266f5651057410ab626f853b83876cd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70]: /images/20220203/67ca1128b2b84791b9005ebd9a44ae6e.png
[20190509152153784.png]: /images/20220203/80c952f10b1d4ef78a921a271881d52d.png
[20190509154523955.png]: /images/20220203/f2868b5b7d2e4ab58ebe3e5ab503a345.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 1]: /images/20220203/cd24d520c93e41b49dbd73930984fb89.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 2]: /images/20220203/7198e9237c7d45b1a77ce2ef4e65ba2c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 3]: /images/20220203/d77dedf8eb954959b0f935473421bc44.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 4]: /images/20220203/2f9f9cdb2b634b67a0c02fe2f9c23503.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 5]: /images/20220203/77c9119300a64294831245280dc1a171.png