Z tego przewodnika dowiesz się, jak zintegrować adapter do zapośredniczenia z aplikacją na platformę Flutter.
Wymagania wstępne
Zanim zintegrujesz mediację z formatem reklamy, musisz zintegrować ten format reklamy z aplikacją:
- Banery reklamowe
- Reklamy pełnoekranowe
- Reklamy natywne
- Reklamy z nagrodą
- Reklamy pełnoekranowe z nagrodą
Dopiero 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 mediacji. Aby mieć pewność, że w pierwszym żądaniu reklamy uczestniczą wszystkie sieci reklamowe, 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)
Dodaj do pliku settings.gradle te wiersze, aby móc korzystać z interfejsów Android API wtyczki:
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 w przypadku sieci partnerów
Adaptery do zapośredniczenia i ich zależności należy dodać do projektów na Androida i iOS. Możesz je dodać, aktualizując plik build.gradle
na poziomie aplikacji na Androidzie i Podfile na iOS. Google ma na GitHubie adaptery open source zarówno na Android, jak i na iOS.
Szczegółowe instrukcje dodawania adaptera do aplikacji znajdziesz w dokumentacji poszczególnych sieci partnerskich:AndroidiOS
Sprawdzanie, która klasa adaptera sieci reklamowej wczytała reklamę
Poniższy 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 z zapośredniczeniem
Pamiętaj, aby wyłączyć odświeżanie w interfejsach wszystkich zewnętrznych źródeł reklam w przypadku jednostek reklamowych z banerami używanych w zapośredniczeniu. Zapobiega 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 w ramach zapośredniczenia
Oto kilka sprawdzonych metod, które warto wziąć pod uwagę podczas wdrażania mediacji natywnej.
- Zasady dotyczące prezentowania reklam natywnych
- Każda sieć reklamowa ma własne zasady. Pamiętaj, że podczas korzystania z zapośredniczenia aplikacja nadal musi przestrzegać zasad 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 sekcjach Ustawienia dotyczące przepisów stanowych USA lub Ustawienia RODO, aby dodać partnerów do zapośredniczenia do listy partnerów reklamowych w narzędziu Prywatność i wyświetlanie wiadomości w Ad Managerze. 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) od Google.