Trusted Arbiter

import 'package:cloudx_flutter/cloudx.dart';
import 'package:flutter/foundation.dart';

// cloudXAd 是您在 onAdLoaded 中收到的 CloudXAd，请原样传入。
final result = await CloudX.arbiter(CloudXArbiterConfiguration(bids: [
  CloudXArbiterBid.cloudX(cloudXAd),
  CloudXArbiterBid.adMob(adUnitId: adMobAdUnitId),
]));

debugPrint('选中的平台：${result.platform}');

if (result.platform == CloudXArbiterPlatform.cloudX) {
  // 展示 CloudX 广告
} else if (result.platform == CloudXArbiterPlatform.adMob) {
  // 展示您的 AdMob 广告
}

CloudXArbiterResult? nextWinner;
int arbiterRound = 0;

// 两侧都有结果后运行，早于广告位。
// 只有真正加载成功的候选才会成为出价：为加载失败的广告单元出价，可能凭价格历史
// 胜出，最终却没有广告可展示。
Future<void> prepareWinner(CloudXAd? cloudXAd, String? loadedAdMobAdUnitId) async {
  /*
   * 广告位可以在本次调用尚未返回时先展示单个候选并启动下一轮，因此多轮可能重
   * 叠。为每一轮编号，并且只允许最新的一轮写入结果：否则较早的一轮会最后返回，
   * 用已经展示过的广告覆盖当前胜出方。
   */
  final round = ++arbiterRound;

  // 新的一轮意味着候选已经变化，上一轮留在这里的结果指向的广告已不存在。请立即
  // 清空，避免本轮还在进行时广告位展示它。
  nextWinner = null;

  final bids = <CloudXArbiterBid>[
    if (cloudXAd != null) CloudXArbiterBid.cloudX(cloudXAd),
    if (loadedAdMobAdUnitId != null)
      CloudXArbiterBid.adMob(adUnitId: loadedAdMobAdUnitId),
  ];
  if (bids.isEmpty) {
    return; // 两侧都没有填充，无需仲裁
  }

  try {
    final result =
        await CloudX.arbiter(CloudXArbiterConfiguration(bids: bids));
    if (round != arbiterRound) {
      return; // 本轮进行期间已开始更新的一轮，以新的一轮结果为准
    }

    // none 不是胜出方：保存它会导致既没有可展示的广告，也没有需要重新加载的
    // 广告，因为两侧都还持有各自的填充。
    nextWinner = result.platform == CloudXArbiterPlatform.none ? null : result;
  } catch (error) {
    // 该方法由加载回调触发，没有任何代码在等待它：未捕获的平台通道异常会变成
    // 未处理的异步错误。已加载的广告仍然保留，下一轮可以重新运行。
    if (round == arbiterRound) {
      nextWinner = null;
    }
    debugPrint('仲裁失败：$error');
  }
}

// 在广告位处运行，这里没有网络请求。
void showAd(String cloudXAdUnitId) {
  final winner = nextWinner;
  nextWinner = null;

  /*
   * 广告位结束了本轮周期，因此让仍在进行的轮次失效。否则在广告位之前启动的那一
   * 轮返回时仍是最新一轮，会写入一个指向本次已展示或已跳过的广告的胜出方。
   */
  arbiterRound++;

  if (winner == null) {
    return; // 没有准备好的胜出方，继续流程即可
  }
  if (winner.platform == CloudXArbiterPlatform.cloudX) {
    // 本轮准备的是插屏广告。激励视频广告的流程完全相同，只需改用
    // showRewarded，并传入激励视频广告的广告单元 ID。
    CloudX.showInterstitial(adUnitId: cloudXAdUnitId);
  } else if (winner.platform == CloudXArbiterPlatform.adMob) {
    // 展示您的 AdMob 插屏广告
  } else {
    // 本示例只提交 CloudX 和 AdMob 两种出价。您新增的每个工厂都需要在这里补上
    // 自己的分支，否则它获胜时什么都不会展示。
    debugPrint('没有对应的展示分支：${winner.platform}');
  }
}

// networkName 为可选；当 Google 提供竞得的广告来源时可以传入。
final adMobBid = CloudXArbiterBid.adMob(
  adUnitId: adMobAdUnitId,
  networkName: adMobAdSourceName,
);

// Ad Manager 的广告单元 ID 形如 /NNNNNNN/placement/name。
final adManagerBid = CloudXArbiterBid.gam(
  adUnitId: '/21775744923/example/interstitial',
);

final result = await CloudX.arbiter(CloudXArbiterConfiguration(bids: [
  CloudXArbiterBid.cloudX(cloudXAd),
  adMobBid,
  adManagerBid,
]));

import 'package:cloudx_flutter/cloudx.dart';
import 'package:flutter/foundation.dart';
import 'package:google_mobile_ads/google_mobile_ads.dart';

// 把它挂到您加载的广告上，并传入该出价对应的平台和广告单元 ID：AdMob 单元配
// CloudXRevenuePlatform.adMob，Ad Manager 单元配 CloudXRevenuePlatform.gam。
// 两者始终成对出现，因此 Ad Manager 的展示不会被上报成 AdMob。adFormat 是这条
// 广告的格式：'banner'、'mrec'、'interstitial' 或 'rewarded'。
void reportGooglePaidEvents(
  Ad ad,
  CloudXRevenuePlatform platform,
  String googleAdUnitId,
  String adFormat,
) {
  ad.onPaidEvent = (paidAd, valueMicros, precision, currencyCode) async {
    try {
      final accepted = await CloudX.reportRevenueData(CloudXRevenueData(
        platform: platform,
        revenue: valueMicros / 1000000.0,
        adFormat: adFormat,
        currencyCode: currencyCode,
        precision: _cloudXPrecision(precision),
        adUnitId: googleAdUnitId,
      ));
      if (!accepted) {
        debugPrint('CloudX 丢弃了本次收入上报');
      }
    } catch (error) {
      // 该回调由 Google 触发，没有任何代码等待它，未捕获的平台通道异常会变成
      // 未处理的异步错误。
      debugPrint('reportRevenueData 失败：$error');
    }
  };
}

CloudXRevenuePrecision _cloudXPrecision(PrecisionType precision) {
  switch (precision) {
    case PrecisionType.precise:
      return CloudXRevenuePrecision.exact;
    case PrecisionType.estimated:
      return CloudXRevenuePrecision.estimated;
    case PrecisionType.publisherProvided:
      return CloudXRevenuePrecision.publisherDefined;
    case PrecisionType.unknown:
      return CloudXRevenuePrecision.undefined;
  }
}

final adMobBid = CloudXArbiterBid.adMob(
  adUnitId: adMobAdUnitId,
  manualRevenuePerImpressionUSD: preBidPricePerImpressionUSD,
);

CloudX.createBanner(
  adUnitId: adUnitId,
  position: CloudXAdViewPosition.bottomCenter,
);
// 创建广告就会启动刷新循环，因此紧接着停止它。
CloudX.stopBannerAutoRefresh(adUnitId: adUnitId);

final levelPlayBid = CloudXArbiterBid.levelPlay(
  networkName: levelPlayAdInfo.adNetwork,
  revenue: levelPlayAdInfo.revenue,
  precision: levelPlayAdInfo.precision,
);

final pubMaticBid = CloudXArbiterBid.pubMatic(
  price: pubMaticPrice,
  partnerName: pubMaticPartnerName,
);

final customBid = CloudXArbiterBid.custom(
  platformName: 'my_mediation_platform',
  networkName: 'winning_demand_source',
  revenuePerImpressionUSD: 0.00125,
  precision: CloudXArbiterPrecision.exact,
  extras: {'ad_unit': 'third-party-ad-unit-id'},
);

final result = await CloudX.arbiter(CloudXArbiterConfiguration(bids: [
  CloudXArbiterBid.cloudX(cloudXAd),
  customBid,
]));