Z tego przewodnika dowiesz się, jak zintegrować adapter do zapośredniczenia z aplikacją na Flatterze.
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 pakietu SDK do reklam mobilnych
Z tego krótkiego przewodnika dowiesz się, jak zainicjować pakiet SDK do reklam mobilnych. Podczas tego wywołania inicjującego inicjowane są też adaptery mediacji. Aby mieć pewność, że każda sieć reklamowa w pełni uczestniczy w pierwszym żądaniu reklamy, przed wczytaniem reklam poczekaj na zakończenie inicjowania.
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 na Androidzie)
Dodaj do pliku settings.gradle
te wiersze, aby móc korzystać z interfejsów API Androida w tej wtyczce:
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
Do projektów na Androida i iOS musisz dodać adaptery do mediacji i ich zależności. Możesz je dodać, aktualizując plik build.gradle
na poziomie aplikacji na Androidzie i Podfile
na iOS. Google udostępnia na GitHubie adaptery open source na Android i 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 w zapośredniczeniu
Pamiętaj, aby wyłączyć odświeżanie w interfejsach wszystkich zewnętrznych źródeł reklam w przypadku jednostek reklamowych banerów 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 przestrzegać amerykańskich przepisów stanowych o ochronie prywatności lub Ogólnego rozporządzenia o ochronie danych (RODO), wykonaj czynności opisane w sekcjach Ustawienia dotyczące przepisów stanowych USA lub Ustawienia dotyczące RODO, aby dodać partnerów do mediacji na listach partnerów reklamowych w sekcji Prywatność i wyświetlanie wiadomości w usłudze Ad Manager. 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 wymaganej przez RODO za pomocą pakietu SDK platformy do personalizowania wiadomości wyświetlanych użytkownikom (UMP) od Google.