Mediacja

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

Wymagania wstępne

Aby zintegrować zapośredniczenie dla danego formatu reklamy, musisz zintegrować ten format z aplikacją:

Dopiero zaczynasz korzystać z zapośredniczenia? Przeczytaj Wprowadzenie do zapośredniczenia.

Zainicjowanie pakietu SDK do reklam mobilnych

Z tego krótkiego przewodnika dowiesz się, jak zainicjować pakiet SDK do reklam mobilnych. W jego trakcie inicjowane są również adaptery zapośredniczenia. Zanim załadujesz reklamy, musisz poczekać na zakończenie inicjalizacji, by w przypadku pierwszego żądania reklamy wszystkie sieci reklamowe były w pełni aktywne.

Poniższy przykładowy kod pokazuje, jak sprawdzić stan inicjowania każdego adaptera 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());
}

Aktualizowanie ustawień Gradle (tylko Android)

Dodaj te wiersze do pliku settings.gradle, aby móc korzystać z interfejsów API Androida wtyczki:

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
}

Dodaj zależności dotyczące sieci partnerskich

Adaptery zapośredniczenia i ich zależności musisz dodać do projektów na Androida i iOS. Aby je dodać, zaktualizuj plik build.gradle na poziomie aplikacji na urządzeniu z Androidem i Podfile na iOS. Google udostępnia w GitHubie adaptery open source do Androida i iOS.

Szczegółowe wskazówki dotyczące dodawania adaptera w aplikacji znajdziesz w dokumentacji dotyczącej sieci Android i iOS.

Sprawdź, która klasa adaptera sieci reklamowej załadowała reklamę

Ten przykładowy kod pokazuje, jak rejestrować nazwę klasy sieci reklamowej w przypadku banera reklamowego:

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

Używanie banerów reklamowych w zapośredniczeniu

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 zapośredniczeniu. Zapobiega to podwójnemu odświeżaniu, ponieważ Ad Manager uruchamia też odświeżanie na podstawie częstotliwości odświeżania jednostki z banerem reklamowym.

Używanie reklam natywnych z zapośredniczeniem

Poniżej znajdziesz kilka sprawdzonych metod, które warto wziąć pod uwagę podczas wdrażania zapośredniczenia natywnego.

Zasady dotyczące prezentacji reklam natywnych
Każda sieć reklamowa ma własne zasady. Podczas korzystania z zapośredniczenia pamiętaj, że Twoja aplikacja musi przestrzegać zasad sieci, która wyświetliła reklamę.

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

Jeśli chcesz zachować zgodność z amerykańskimi przepisami stanowymi o ochronie prywatności lub Ogólnym rozporządzeniem o ochronie danych (RODO), wykonaj czynności opisane w ustawieniach amerykańskich przepisów stanowych lub ustawieniach RODO, aby dodać partnerów zapośredniczenia na liście stanów USA w usłudze Ad Manager lub na liście partnerów reklamowych zgodnych z RODO. Jeśli tego nie zrobisz, partnerzy mogą nie wyświetlać reklam w Twojej aplikacji.

Dowiedz się więcej o włączaniu ograniczonego przetwarzania danych i uzyskiwaniu zgody na wykorzystanie danych zgodnie z RODO za pomocą pakietu SDK platformy do personalizowania wiadomości wyświetlanych użytkownikom (UMP).