KivMob项目教程：在Kivy应用中集成AdMob广告

项目概述

KivMob是一个专门为Kivy框架设计的AdMob广告集成库，它让开发者能够轻松地在Kivy应用中展示各种类型的广告。Kivy是一个流行的Python框架，用于开发跨平台的移动应用和多点触控应用。通过KivMob，开发者可以方便地在应用中实现广告变现功能。

安装指南

KivMob可以通过Python包管理工具pip进行安装。以下是安装步骤：

pip3 install kivmob

或者，你也可以从源代码安装：

python3 setup.py install --user

Android平台配置

要在Android平台上使用KivMob，需要对buildozer.spec文件进行以下配置：

requirements = python3, kivy, android, jnius, kivmob
...
android.permissions = INTERNET, ACCESS_NETWORK_STATE
android.api = 33
android.minapi = 21
android.sdk = 33
android.ndk = 25b
android.gradle_dependencies = com.google.firebase:firebase-ads:21.4.0
android.enable_androidx = True
p4a.branch = master
# 测试广告使用此应用ID
android.meta_data = com.google.android.gms.ads.APPLICATION_ID=你的AdMob应用ID

注意：在正式发布应用前，请确保将测试ID替换为你自己的AdMob应用ID。

横幅广告集成

横幅广告是最常见的广告形式之一，通常显示在屏幕顶部或底部。以下是如何在Kivy应用中集成横幅广告的示例：

from kivmob import KivMob, TestIds
from kivy.app import App
from kivy.uix.label import Label

class BannerApp(App):
    """在屏幕顶部显示横幅广告的示例应用"""
    
    def build(self):
        # 初始化广告系统
        self.ads = KivMob(TestIds.APP)
        # 创建顶部横幅广告
        self.ads.new_banner(TestIds.BANNER, top_pos=True)
        # 请求广告
        self.ads.request_banner()
        # 显示广告
        self.ads.show_banner()
        return Label(text='横幅广告演示')
        
    def on_pause(self):
        # 应用暂停时暂停广告
        return True

if __name__ == "__main__":
    BannerApp().run()

要将横幅广告显示在屏幕底部，只需将top_pos参数设置为False。

插页式广告集成

插页式广告是全屏广告，通常在应用自然过渡点（如关卡之间）展示。以下是集成示例：

from kivmob import KivMob, TestIds
from kivy.app import App
from kivy.uix.button import Button

class InterstitialApp(App):
    """点击按钮显示插页式广告的示例应用"""
    
    def build(self):
        self.ads = KivMob(TestIds.APP)
        # 创建插页式广告
        self.ads.new_interstitial(TestIds.INTERSTITIAL)
        # 请求广告
        self.ads.request_interstitial()
        # 按钮点击时显示广告
        return Button(text='显示插页式广告',
                      on_release=lambda a:self.ads.show_interstitial())
    
    def on_resume(self):
        # 应用恢复时重新请求广告
        self.ads.request_interstitial()

if __name__ == "__main__":
    InterstitialApp().run()

激励视频广告集成

激励视频广告允许用户观看视频来换取应用内奖励。KivMob提供了回调功能来处理奖励发放：

from kivmob import KivMob, TestIds, RewardedListenerInterface
from kivy.app import App
from kivy.uix.button import Button

class RewardListener(RewardedListenerInterface):
    """自定义奖励回调处理类"""
    
    def on_rewarded(self, reward_type, reward_amount):
        print(f"用户获得奖励: {reward_amount} {reward_type}")
    
    def on_rewarded_ad_left_application(self):
        print("用户离开了应用")
    
    def on_rewarded_ad_closed(self):
        print("广告已关闭")
    
    def on_rewarded_ad_failed_to_load(self, error_code):
        print(f"广告加载失败，错误代码: {error_code}")
    
    def on_rewarded_ad_loaded(self):
        print("广告加载成功")
    
    def on_rewarded_ad_opened(self):
        print("广告已打开")

class RewardedApp(App):
    """点击按钮显示激励视频广告的示例应用"""
    
    def build(self):
        self.ads = KivMob(TestIds.APP)
        # 加载激励视频广告
        self.ads.load_rewarded_ad(TestIds.REWARDED_VIDEO)
        # 设置奖励回调监听器
        self.ads.set_rewarded_ad_listener(RewardListener())
        # 按钮点击时显示广告
        return Button(text='显示激励广告',
                      on_release=lambda a:self.ads.show_rewarded_ad())
    
    def on_resume(self):
        # 应用恢复时重新加载广告
        self.ads.load_rewarded_ad(TestIds.REWARDED_VIDEO)

if __name__ == "__main__":
    RewardedApp().run()

最佳实践建议

1. 广告展示时机：合理安排广告展示时机，避免影响用户体验。插页式广告适合在关卡之间或任务完成后展示。

2. 测试广告：开发阶段务必使用测试广告ID，避免点击自己的广告导致账号被封。

3. 广告加载：提前加载广告，确保用户需要时能够立即展示。

4. 错误处理：实现适当的错误处理逻辑，处理广告加载失败等情况。

5. 用户选择：特别是对于激励视频广告，确保用户明确知道观看广告能获得什么奖励。

通过本教程，你应该已经掌握了如何在Kivy应用中使用KivMob集成各种类型的AdMob广告。合理使用广告功能，可以在提升用户体验的同时实现应用变现。