Konfigurowanie zapośredniczenia

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

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

Wymagania wstępne

Zanim zintegrujesz zapośredniczenie w przypadku danego formatu reklamy, musisz zintegrować ten format w aplikacji:

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

Zainicjuj Google Mobile Ads Flutter Plugin

Z krótkiego przewodnika dowiesz się, jak zainicjować Google Mobile Ads Flutter Plugin. Podczas tego wywołania inicjowane są też adaptery zapośredniczenia. Ważne jest, aby przed wczytaniem reklam poczekać na zakończenie inicjowania, aby mieć pewność, że wszystkie sieci reklamowe będą w pełni uczestniczyć w pierwszym żądaniu reklamy.

Poniższy przykładowy kod pokazuje, jak przed wysłaniem żądania reklamy sprawdzić stan inicjowania każdego adaptera.

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 do pliku settings.gradle te wiersze, aby móc korzystać z interfejsów API wtyczki na Androida:

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 dla sieci partnerów

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

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

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

Poniższy przykładowy kod pokazuje, jak zarejestrować 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(),
    );

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. Zapobiegnie to podwójnemu odświeżaniu, ponieważ Ad Manager również wywołuje odświeżanie na podstawie częstotliwości odświeżania jednostki banera 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 prezentacji reklam natywnych
Każda sieć reklamowa ma własne zasady. Podczas korzystania z zapośredniczenia należy pamiętać, że aplikacja musi być zgodna z zasadami sieci zapośredniczonej, która dostarczyła reklamę.

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

Jeśli musisz 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 sekcji Ustawienia dotyczące przepisów stanowych w USA lub Ustawienia dotyczące 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 i uzyskiwaniu zgody na wykorzystanie danych zgodnie z RODO za pomocą pakietu SDK platformy do personalizowania wiadomości wyświetlanych użytkownikom (UMP) od Google.

Dalej
Wybieranie źródeł reklam