Parametry żądań specyficznych dla sieci

Niektóre karty sieciowe obsługują dodatkowe parametry, które można przekazywać do karty podczas tworzenia żądania reklamy. Są one nazywane dodatkami sieciowymi.

Wtyczka Google Mobile Ads udostępnia interfejsy API na Androidzie i iOS, które umożliwiają przekazywanie dodatkowych informacji o sieci do adapterów zapośredniczenia. Aby to zrobić, musisz zaimplementować MediationNetworkExtrasProvider na Androidzie i FLTMediationNetworkExtrasProvider na iOS, a następnie zarejestrować implementację dostawcy dodatków w przypadku wtyczki. Następnie wtyczka będzie go używać do przekazywania dodatkowych informacji o sieci podczas tworzenia żądania reklamy na Androidzie lub iOS.

Rejestrowanie MediationNetworkExtrasProvider na Androidzie

Utwórz implementację 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;
  }
}

Następnie zarejestruj go w 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());
  }
}

Informacje o tym, które dodatki są obsługiwane przez poszczególne sieci i jak je tworzyć, znajdziesz w dokumentacji Androida dotyczącej konkretnej sieci.

Rejestrowanie FLTMediationNetworkExtrasProvider w systemie iOS

Utwórz implementację 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

Zarejestruj go w usłudze 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

Informacje o tym, które dodatki są obsługiwane przez poszczególne sieci i jak je tworzyć, znajdziesz w dokumentacji iOS dotyczącej konkretnej sieci.

Pełny przykład w GitHubie

Nasz przykład pokazuje, jak ustawić parametry niestandardowe w AppLovin w ramach integracji.

Mediacja