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ą:

Zapoznałeś się już z zaproszeniem? Przeczytaj Wprowadzenie do zapośredniczenia.

Inicjowanie pakietu SDK do reklam mobilnych

W tym przewodniku znajdziesz informacje o tym, jak inicjować pakiet 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

Do projektów na Androida i iOS trzeba dodać pośredniczące adaptery reklamowe 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 AndroidiOS 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.

Dowiedz się więcej o włączaniu ograniczonego przetwarzania danych (RDP) i uzyskiwaniu zgody na podstawie RODO za pomocą pakietu SDK User Messaging Platform (UMP) od Google.