معلَمات الطلب الخاصة بالشبكة

تتيح بعض محوّلات الشبكة استخدام معلّمات إضافية يمكن تمريرها إلى المحوّل عند إنشاء طلب عرض الإعلان. ويُشار إليها باسم "تفاصيل إضافية خاصة بالشبكة".

توفّر مكوّنة Google Mobile Ads الإضافية واجهات برمجة تطبيقات على 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 في عملية دمج.

التوسّط