Mediacja

Z tego przewodnika dowiesz się, jak zintegrować adapter zapośredniczenia 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ś się już z zaproszeniem? 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 inicjowane są też 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

Do projektów na Androida i iOS trzeba dodać pośredniczące adaptery reklam i ich zależności. 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 zastosowaniem zapośredniczenia

Pamiętaj, aby wyłączyć odświeżanie we wszystkich interfejsach zewnętrznych źródeł reklam w przypadku jednostek banerów reklamowych używanych w ramach zapośredniczenia. 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 reklamowej banera.

Korzystanie z reklam natywnych z zaposobem zapośredniczenia

Poniżej znajdziesz kilka sprawdzonych metod, które warto zastosować podczas wdrażania pośrednictwa w reklamach natywnych.

Zasady dotyczące prezentacji 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ć przepisów stanowych USA o ochronie prywatności lub Ogólnego rozporządzenia o ochronie danych (RODO), wykonaj czynności opisane w sekcji Ustawienia dotyczące przepisów stanowych USA lub Ustawienia dotyczące RODO, aby dodać partnerów pośredniczących do listy partnerów reklamowych w sekcji Prywatność i wyświetlanie wiadomości w usłudze Ad Manager, którzy podlegają przepisom stanowym USA lub RODO. Jeśli tego nie zrobisz, partnerzy mogą nie wyświetlać reklam w Twojej aplikacji.