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ą:
- Banery reklamowe
- Reklamy pełnoekranowe
- Reklamy natywne
- Reklamy z nagrodą
- Reklamy pełnoekranowe z nagrodą
Zapoznałeś/-aś się już z zaposzredniczeniem? Przeczytaj Wprowadzenie do zapośredniczenia.
Inicjowanie pakietu SDK do reklam mobilnych
W tym przewodniku dowiesz się, 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 plugina na Androida, dodaj do pliku settings.gradle
te wiersze:
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 partnerskich
Do projektów na Androida i iOS trzeba dodać pośredniczące adaptery reklam 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 Android i iOS poszczególnych sieci partnerskich.
Sprawdzanie, która klasa adaptera sieci reklamowej 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 w ramach 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średniczenia 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 w 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ć swoich partnerów z domeny pośrednictwa do listy partnerów reklamowych w sekcji Prywatność i wyświetlanie wiadomości w Ad Managerze, którzy podlegają przepisom stanowym w 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.