Flutter GDPR广告合规插件gdpr_ads的使用

Flutter GDPR广告合规插件gdpr_ads的使用

GDPR服务，GDPR中间页面，Admob管理用于加载和展示广告。

特性

1. GDPR管理器。
2. 广告加载、展示和返回结果。
3. GDPR和广告在失败时优雅地处理。

开始使用

此包包含两个组件：GDPR和广告。两者可以单独使用。下面的例子将结合这两个组件。

步骤：

1. 在Admob账户中创建一个Ad-ID并设置GDPR消息。
2. 更新AndroidManifest.xml和build.gradle文件。
3. 配置MaterialApp(home: GdprScreenManager())。
4. 展示广告。
5. 按需更新或重置GDPR。

初始化GDPR和广告

添加一个导航方法，该方法将在GDPR屏幕后导航到下一个屏幕。在下面的例子中，将AfterGdprScreen()替换为你的自定义小部件。

设置广告单元和测试设备ID。下面的广告单元是Admob演示广告单元，可以安全使用。

如果用户从未与GDPR交互过，则会显示GDPR对话框。

如果用户已经与GDPR交互过，则不会显示GDPR对话框。

void main() async {
  runApp(const MainApp());
}

class MainApp extends StatelessWidget {
  const MainApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: GdprScreenManager(
        (BuildContext context) => 
          Navigator.of(context).pushReplacement(
            MaterialPageRoute(builder: (context) => 
              const AfterGdprScreen())),
        bannerIds: ["ca-app-pub-3940256099942544/6300978111"],
        interstitialIds: ["ca-app-pub-3940256099942544/1033173712"],
        interRewardIds: ["ca-app-pub-3940256099942544/5354046379"],
        debugTestDeviceIds: ["... YOUR TEST DEVICE ID HERE ..."],

        // 测试时强制或取消强制GDPR对话框
        debugGeography: GdprDebugGeography.insideEea,
      ).getInitialGdprScreen(),
    );
  }
}

重新访问GDPR

如果用户从未与GDPR交互过，则会显示GDPR对话框。

如果用户已经与GDPR交互过，则不会显示GDPR对话框。

if(GdprService.isUserUnderGdpr()) {
  Navigator.of(context).pushReplacement(
    MaterialPageRoute(
      builder: (context) =>
          GdprScreenManager.initialGdprScreen(),
    ),
  );
}

更新现有的GDPR

无论用户是否已经与GDPR交互过，都会显示GDPR对话框。

Navigator.of(context).pushReplacement(
  MaterialPageRoute(
    builder: (context) =>
        GdprScreenManager.updateGdprScreen(),
  )
)

重置并重新访问GDPR

无论用户是否已经与GDPR交互过，都会重置GDPR对话框并重新显示GDPR对话框。

Navigator.of(context).pushReplacement(
  MaterialPageRoute(
    builder: (context) =>
        GdprScreenManager.initialResetGdprScreen(),
  ),
)

展示广告

如果没有提供adUnitId，则会显示第一个可用的广告单元。

展示横幅广告

在kDebugMode下，AdBanner将显示额外信息。

Scaffold(body: AdBanner('... Ad ID ...'));

// 或者
Scaffold(body: AdBanner());

展示插屏广告

final ResponseInterstitial result 
  = await AdService().showInterstitial('... Ad ID ...');

// 或者
final ResponseInterstitial result 
  = await AdService().showInterstitial();

展示激励插屏广告

激励插屏广告需要一个带有计时器的对话框。

对话框的外观应与你的应用设计相匹配。

为了方便起见，将类RewardedInterstitialDialog复制到你的项目中，并根据需要美化AlertDialog内部。源码可以在这里找到。

然后，使用以下代码调用AdService().showInterstitialRewarded()，并传递你的对话框作为参数。

final String? adUnitId = null;

final ResponseInterstitialRewarded result 
  = await AdService().showInterstitialRewarded(
      context, 
      const RewardedInterstitialDialog(
        adUnitId: adUnitId, 
        countdownSeconds:5,
      ),
      adUnitId: adUnitId,
    );

响应详情

返回的响应具有详细的状态枚举，描述了结果。

final ResponseInterstitialRewarded result =
    await AdService().showInterstitialRewarded(
  context,
  const RewardedInterstitialDialog(
    countdownSeconds: 5,
  ),
);

if (
    result.status == StatusInterstitialRewarded.displaySuccess ||
    result.status ==
        StatusInterstitialRewarded.displayDeniedProgrammatically ||
    result.status ==
        StatusInterstitialRewarded.displayFailedUnspecificReasons ||
    result.status == StatusInterstitialRewarded.notLoadedInitialized ||
    result.status == StatusInterstitialRewarded.notLoadedAdIdNotSet ||
    result.status == StatusInterstitialRewarded.notLoadedButTryingTo ||
    result.status == StatusInterstitialRewarded.notLoadedGenerally ||
    result.status == StatusInterstitialRewarded.notLoadedAdIdNotSet
  ) {
  // 广告已展示或因某些技术原因不可用
} else {
  // 用户取消了广告
}