Flutter Pangle Global Ads 技术文档

【免费下载链接】flutter_pangle_global_ads 🔥🔥🔥 Flutter 广告插件 -- 穿山甲国际版（支持开屏、插屏、激励视频、Banner、信息流）【持续更新】 项目地址: https://gitcode.com/FlutterAdss/flutter_pangle_global_ads

1. 安装指南

环境要求

• Flutter SDK 3.0.0 或更高版本
• Android 5.0 (API level 21) 或更高版本
• iOS 10.0 或更高版本

依赖安装

在项目的 pubspec.yaml 文件中添加以下依赖：

dependencies:
  flutter_pangle_global_ads: ^最新版本号

然后运行以下命令：

flutter pub get

2. 项目使用说明

初始化SDK

在应用启动时初始化广告SDK：

import 'package:flutter_pangle_global_ads/flutter_pangle_global_ads.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  // 初始化Pangle Global SDK
  FlutterPangleGlobalAds.init(
    appId: '您的应用ID',
    isDebug: true, // 调试模式
  );
  runApp(MyApp());
}

广告类型使用

开屏广告

FlutterPangleGlobalAds.showSplashAd(
  slotId: '开屏广告位ID',
  logo: '底部logo图片路径', // 可选
  timeout: 5000, // 超时时间(毫秒)
);

插屏广告

FlutterPangleGlobalAds.showInterstitialAd(
  slotId: '插屏广告位ID',
);

激励视频广告

FlutterPangleGlobalAds.showRewardedVideoAd(
  slotId: '激励视频广告位ID',
  rewardCallback: (rewardVerify, rewardAmount, rewardName) {
    // 奖励回调处理
  },
);

3. 项目API使用文档

主要API方法

初始化方法

static Future<void> init({
  required String appId,
  bool isDebug = false,
})

广告加载状态监听

FlutterPangleGlobalAds.setAdListener(
  onAdLoaded: (adType) => print('广告加载成功'),
  onAdFailed: (adType, error) => print('广告加载失败: $error'),
  onAdClicked: (adType) => print('广告被点击'),
);

横幅广告

FlutterPangleGlobalAds.showBannerAd(
  slotId: '横幅广告位ID',
  width: 300, // 广告宽度
  height: 50, // 广告高度
  position: BannerPosition.bottom, // 位置(top/bottom)
);

4. 项目安装方式

Android配置

在 AndroidManifest.xml 中添加以下权限：

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

iOS配置

在 Info.plist 中添加以下配置：

<key>NSAppTransportSecurity</key>
<dict>
  <key>NSAllowsArbitraryLoads</key>
  <true/>
</dict>

注意事项

1. 确保已正确配置应用ID和广告位ID
2. 测试时使用测试ID，上线前替换为正式ID
3. iOS平台需要配置SKAdNetwork以支持广告归因
4. 遵守各平台的广告政策和使用条款

【免费下载链接】flutter_pangle_global_ads 🔥🔥🔥 Flutter 广告插件 -- 穿山甲国际版（支持开屏、插屏、激励视频、Banner、信息流）【持续更新】 项目地址: https://gitcode.com/FlutterAdss/flutter_pangle_global_ads