將聯播網額外資訊傳遞至轉接程式

部分聯播網轉接程式支援其他參數，可在建立廣告請求時傳遞給轉接程式。這些稱為聯播網額外資訊。

Google Mobile Ads 外掛程式在 Android 和 iOS 平台提供 API，可將聯播網額外資訊傳遞至中介服務轉接程式。如要這麼做，您必須在 Android 上實作 MediationNetworkExtrasProvider，在 iOS 上實作 FLTMediationNetworkExtrasProvider，然後向外掛程式註冊額外資訊供應器實作。之後，外掛程式會在 Android 或 iOS 上建立廣告請求時，使用該方法傳遞聯播網額外參數。

在 Android 上註冊 MediationNetworkExtrasProvider

建立 MediationNetworkExtrasProvider 實作項目：

class MyMediationNetworkExtrasProvider implements MediationNetworkExtrasProvider {

  @Override
  public Map<Class<? extends MediationExtrasReceiver>, Bundle> getMediationExtras(
      String adUnitId, @Nullable String identifier) {
    // This example passes extras to the AppLovin adapter.
    // This method is called with the ad unit of the associated ad request, and
    // an optional string parameter which comes from the dart ad request object.
    Bundle appLovinBundle = new AppLovinExtras.Builder().setMuteAudio(true).build();
    Map<Class<? extends MediationExtrasReceiver>, Bundle> extras = new HashMap<>();
    extras.put(ApplovinAdapter.class, appLovinBundle);
    // Note: You can pass extras to multiple adapters by adding more entries.
    return extras;
  }
}

然後向 GoogleMobileAdsPlugin 註冊：

// Register a MediationNetworkExtrasProvider with the plugin.
public class MainActivity extends FlutterActivity {

  @Override
  public void configureFlutterEngine(@NonNull FlutterEngine flutterEngine) {
    super.configureFlutterEngine(flutterEngine);

    // Register your MediationNetworkExtrasProvider to provide network extras to ad requests.
    GoogleMobileAdsPlugin.registerMediationNetworkExtrasProvider(
        flutterEngine, new MyMediationNetworkExtrasProvider());
  }
}

如要瞭解不同聯播網支援哪些額外資訊，以及如何建構這些資訊，請參閱特定聯播網的 Android 參考資料。

在 iOS 註冊 FLTMediationNetworkExtrasProvider

建立 FLTMediationNetworkExtrasProvider 實作項目：

@implementation MyFLTMediationNetworkExtrasProvider

- (NSArray<id<GADAdNetworkExtras>> *_Nullable)getMediationExtras:(NSString *_Nonnull)adUnitId
                                       mediationExtrasIdentifier:
                                           (NSString *_Nullable)mediationExtrasIdentifier {
  // This example passes extras to the AppLovin adapter.
  // This method is called with the ad unit of the associated ad request, and
  // an optional string parameter which comes from the dart ad request object.
  GADMAdapterAppLovinExtras *appLovinExtras = [[GADMAdapterAppLovinExtras alloc] init];
  appLovinExtras.muteAudio = NO;
  // Note: You can pass extras to multiple adapters by adding more entries.

  return @[ appLovinExtras ];
}
@end

並向 FLTGoogleMobileAdsPlugin 註冊：

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  [GeneratedPluginRegistrant registerWithRegistry:self];

  // Register your network extras provider if you want to provide
  // network extras to specific ad requests.
  MyFLTMediationNetworkExtrasProvider *networkExtrasProvider =
      [[MyFLTMediationNetworkExtrasProvider alloc] init];
  [FLTGoogleMobileAdsPlugin registerMediationNetworkExtrasProvider:networkExtrasProvider
                                                          registry:self];
  return [super application:application didFinishLaunchingWithOptions:launchOptions];
}

@end

如要瞭解不同聯播網支援哪些額外資訊，以及如何建構這些資訊，請參閱特定聯播網的 iOS 參考資料。