Mediacja

Z tego przewodnika dowiesz się, jak zintegrować adapter mediacji z aplikacją Flutter.

Wymagania wstępne

Zanim zintegrujesz mediację z danym formatem reklamy, musisz go zintegrować z aplikacją:

• Banery reklamowe
• Reklamy pełnoekranowe
• Reklamy natywne
• Reklamy z nagrodą
• Reklamy pełnoekranowe z nagrodą

Zapoznałeś/-aś się już z zaposzredniczeniem? Przeczytaj Wprowadzenie do zapośredniczenia.

Inicjowanie pakietu SDK do reklam mobilnych

Przewodnik szybkiego startu zawiera instrukcje inicjowania pakietu SDK do reklam mobilnych. Podczas tego wywołania inicjalizacji są też inicjowane adaptery mediacji. Zanim zaczniesz wczytywać reklamy, musisz poczekać na zakończenie inicjowania, aby mieć pewność, że każda sieć reklamowa będzie w pełni uczestniczyć w procesie po pierwszym żądaniu reklamy.

Poniższy przykładowy kod pokazuje, jak sprawdzić stan inicjowania poszczególnych adapterów przed wysłaniem żądania reklamy.

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  MobileAds.instance.initialize()
    .then((initializationStatus) {
      initializationStatus.adapterStatuses.forEach((key, value) {
        debugPrint('Adapter status for $key: ${value.description}');
      });
  });
  
  runApp(MyApp());
}

Zaktualizuj ustawienia Gradle (tylko na urządzeniach z Androidem)

Aby móc korzystać z interfejsów API interfejsu Androida w pluginie, dodaj do pliku settings.gradle te wiersze:

def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withInputStream { stream -> plugins.load(stream) }
}

plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}

Dodawanie zależności dla sieci partnerskich

Adaptery zapośredniczenia i ich zależności muszą zostać dodane do projektów na Androida i iOS. Możesz je dodać, aktualizując plik build.gradle na poziomie aplikacji na Androida i Podfile na iOS. Google udostępnia na GitHubie adaptery open source do Android i iOS.

Szczegółowe instrukcje dodawania adaptera do aplikacji znajdziesz w dokumentacji Android i iOS poszczególnych sieci partnerskich.

Sprawdzanie klasy adaptera sieci reklamowej, która wczytała reklamę

Poniższy przykładowy kod pokazuje, jak rejestrować nazwę klasy sieci reklamowej w przypadku reklamy typu baner:

final bannerAd = AdManagerBannerAd(
      size: [AdSize.banner],
      adUnitId: '<your-ad-unit>',
      listener: AdManagerBannerAdListener(
        onAdLoaded: (ad) {
          debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
        },
      ),
      request: AdManagerAdRequest(),
    );

Korzystanie z banerów reklamowych z pośrednictwem

Pamiętaj, aby wyłączyć odświeżanie we wszystkich interfejsach zewnętrznych źródeł reklam w przypadku jednostek reklam banerowych używanych w zapośredniczeniu. Zapobiega to podwójnemu odświeżaniu, ponieważ Ad Manager również uruchamia odświeżanie na podstawie częstotliwości odświeżania jednostki z banerem reklamowym.

Korzystanie z reklam natywnych z zapośredniczeniem

Oto kilka sprawdzonych metod, które warto wziąć pod uwagę podczas wdrażania pośrednictwa w reklamach natywnych.

Zasady dotyczące wyświetlania reklam natywnych

Każda sieć reklamowa ma własne zasady. Pamiętaj, że korzystając z zapośredniczenia, musisz przestrzegać zasad sieci zapośredniczącej, która dostarczyła reklamę.

Amerykańskie przepisy stanowe o ochronie prywatności a RODO

Jeśli musisz przestrzegać amerykańskich przepisów stanowych o ochronie prywatności lub Ogólnego rozporządzenia o ochronie danych (RODO), wykonaj czynności opisane w sekcji Ustawienia dotyczące amerykańskich przepisów stanowych lub Ustawienia dotyczące RODO, aby dodać swoich partnerów pośredniczących do listy partnerów reklamowych w sekcji Prywatność i wyświetlanie wiadomości w Ad Managerze obejmującej stany w USA lub RODO. Jeśli tego nie zrobisz, partnerzy mogą nie wyświetlać reklam w Twojej aplikacji.