Konfigurowanie zapośredniczenia

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

Wymagania wstępne

Zanim zintegrujesz zapośredniczenie w przypadku formatu reklamy, musisz zintegrować ten format reklamy z aplikacją:

Zaczynasz korzystać z zapośredniczenia? Przeczytaj wprowadzenie do zapośredniczenia.

Inicjowanie Google Mobile Ads Flutter Plugin

Z tego krótkiego przewodnika dowiesz się, jak zainicjować Google Mobile Ads Flutter Plugin. Podczas tego wywołania inicjującego inicjowane są też adaptery zapośredniczenia. Aby sprawdzić pełny udział każdej sieci reklamowej w pierwszym żądaniu reklamy, przed wczytaniem reklam musisz poczekać na zakończenie inicjowania.

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 na Androidzie)

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

def flutterSdkPath = {
    def properties = new Properties()
    file("local.properties").withInputStream { properties.load(it) }
    def flutterSdkPath = properties.getProperty("flutter.sdk")
    assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
    return flutterSdkPath
}()

includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

Dodawanie zależności od sieci partnerskich

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

Szczegółowe instrukcje dotyczące dodawania adaptera do aplikacji znajdziesz w Android i iOS dokumentacji każdej sieci partnerskiej.

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

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

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

W przypadku jednostek banerów reklamowych używanych w zapośredniczeniu wyłącz odświeżanie we wszystkich interfejsach źródeł reklam innych firm. Zapobiega to podwójnemu odświeżaniu, ponieważ Ad Manager też wywołuje odświeżanie na podstawie częstotliwości odświeżania jednostki baneru reklamowego.

Korzystanie z reklam natywnych z zapośredniczeniem

Oto kilka sprawdzonych metod, które warto wziąć pod uwagę podczas wdrażania zapośredniczenia reklam natywnych.

Zasady dotyczące prezentowania reklam natywnych
Każda sieć reklamowa ma własne zasady. Pamiętaj, że gdy korzystasz z zapośredniczenia, Twoja aplikacja nadal musi przestrzegać zasad sieci zapośredniczonej, która wyświetliła reklamę.

Amerykańskie przepisy stanowe o ochronie prywatności i 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 przepisów stanowych USA lub Ustawienia RODO, aby dodać partnerów zapośredniczenia do listy partnerów reklamowych w sekcji Prywatność i wyświetlanie wiadomości w Ad Managerze. W przeciwnym razie partnerzy mogą nie wyświetlać reklam w Twojej aplikacji.

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