פרמטרי בקשה ספציפיים לרשת

מתאמי רשת מסוימים תומכים בפרמטרים נוספים שניתן להעביר למתאם כשנוצרת הבקשה להצגת מודעה. הן נקראות 'תוספות רשת'.

הפלאגין של Google Mobile Ads מספק ממשקי API ב-Android וב-iOS שמאפשרים להעביר תוספות לרשת למתאמים של תהליך בחירת הרשת. לשם כך, עליכם להטמיע את MediationNetworkExtrasProvider ב-Android ואת FLTMediationNetworkExtrasProvider ב-iOS, ולאחר מכן לרשום את ההטמעה של ספק התוספות באמצעות הפלאגין. לאחר מכן הפלאגין ישתמש בו כדי להעביר תוספות רשת בזמן שהוא יוצר את הבקשה להצגת מודעה ב-Android או ב-iOS.

רישום של MediationNetworkExtrasProvider ב-Android

יצירת יישום של 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 של הרשת הספציפית, תוכלו לראות אילו תוספות נתמכות ברשתות שונות ואיך ליצור אותן.

רישום של FLTMediationNetworkExtrasProvider ב-iOS

יצירת יישום של 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 של הרשת הספציפית תוכלו לראות אילו תוספות נתמכות ברשתות שונות ואיך ליצור אותן.

דוגמה מלאה ב-GitHub

הדוגמה שלנו מדגימה איך להגדיר פרמטרים מותאמים אישית ב-AppLovin בשילוב.

תהליך בחירת הרשת (Mediation)