Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Mintegral przy użyciu mediacji. Obejmuje on zarówno integrację z metodą kaskadową, jak i z metodą ustalania stawek. Przewodnik zawiera informacje o dodawaniu pakietu Mintegral do konfiguracji zapośredniczenia jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera Mintegral z aplikacją Flutter .
Obsługiwane integracje i formaty reklam
AdMob Adapter pośredniczący dla sieci Mintegral ma te funkcje:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Otwarcie aplikacji | 1 |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Reklama pełnoekranowa z nagrodą | |
Natywna | 2 |
1 Wersja beta integracji ustalania stawek i kaskady dla formatu reklamy wyświetlanej przy otwarciu aplikacji jest dostępna w ramach zamkniętych testów beta.
2 W przypadku formatu reklamy natywnej integracje z ustalaniem stawek i kaskadą są dostępne w otwartej wersji beta.
Wymagania
- Najnowsza wersja pakietu SDK do reklam mobilnych Google
- Flutter 3.7.0 lub nowszy
- Aby wdrożyć to na Androidzie:
- Poziom interfejsu API 21 lub nowszy
- Aby wdrożyć aplikację na iOS:
- docelowa wersja iOS 12.0 lub nowsza
- Działający Flutter projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
- Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.
Krok 1. Skonfiguruj konfiguracje w interfejsie Mintegral
Zarejestruj lub zaloguj się na konto Mintegral.
Znajdowanie klucza aplikacji
Otwórz kartę Ustawienia aplikacji i zapisz klucz aplikacji.
Dodawanie nowej aplikacji
Na karcie Ustawienia aplikacji kliknij przycisk Dodaj aplikację.
Wybierz Platformę i wypełnij resztę formularza. Następnie kliknij Zapisz.
Android
iOS
Zapisz identyfikator aplikacji.
Android
iOS
Tworzenie miejsca docelowego reklamy
Po utworzeniu aplikacji przejdź na kartę Miejsca docelowe i jednostki i kliknij przycisk Dodaj miejsce docelowe, jak pokazano poniżej, aby utworzyć miejsce docelowe reklamy.
Android
iOS
Wpisz nazwę miejsca docelowego i format reklamy.
Określanie stawek
Jako Typ określania stawek wybierz Określanie stawek przez kod w nagłówku. Wypełnij pozostałe pola formularza i kliknij Zapisz.
Wodospad
W polu Typ ustalania stawek wybierz Tradycyjne. Wypełnij resztę formularza i kliknij Zapisz.
Po utworzeniu miejsca docelowego reklamy zanotuj jego identyfikator.
Android
iOS
Kliknij menu 1 jednostki reklamowe i zanotuj identyfikator jednostki reklamowej.
Android
iOS
Znajdowanie klucza interfejsu API do raportowania Mintegral
Określanie stawek
Ten krok nie jest wymagany w przypadku integracji określania stawek.
Wodospad
Do skonfigurowania identyfikatora jednostki reklamowej AdMob potrzebny będzie klucz interfejsu API do raportowania Mintegral. Kliknij Konto > Narzędzia API. Zanotuj wartości Skey i Secret (Skey).
Krok 2. Skonfiguruj zapotrzebowanie Mintegral w AdMob UI
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 instrukcji na Androida.
iOS
Instrukcje znajdziesz w kroku 2 przewodnika po iOS.
Dodawanie partnerów reklamowych do listy zgodnej z RODO i przepisami stanowymi w USA
Aby dodać Mobvistę/Mintegral do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA w interfejsie AdMob, wykonaj czynności opisane w ustawieniach dotyczących RODO i amerykańskich przepisów stanowych.
Krok 3. Zaimportuj pakiet SDK i adapter Mintegral
Integracja za pomocą pub.dev
Dodaj te zależności z najnowszymi wersjami pakietuMintegral SDK i adaptera w pliku pubspec.yaml
pakietu:
dependencies:
gma_mediation_mintegral: ^1.0.0
Integracja ręczna
Pobierz najnowszą wersję wtyczki reklam mobilnych Google do pośrednictwa Mintegral, wyodrębnij pobrany plik i dodaj wyodrębniony folder wtyczki (oraz jego zawartość) do projektu Flutter. Następnie w pliku pubspec.yaml
dodaj odwołanie do wtyczki, dodając tę zależność:
dependencies:
gma_mediation_mintegral:
path: path/to/local/package
Krok 4. Dodaj wymagany kod
Android
Integracja Mintegral nie wymaga dodatkowego kodu.
iOS
Integracja z SKAdNetwork
Postępuj zgodnie z dokumentacją Mintegral, aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu.
Krok 5. Przetestuj implementację
Włączanie reklam testowych
Pamiętaj, by zarejestrować urządzenie testowe w AdMob.
Aby wyświetlać reklamy testowe Mintegral w formatach banerów, reklam pełnoekranowych, reklam z nagrodą i reklam natywnych, Mintegral zaleca korzystanie z kluczy aplikacji, identyfikatorów aplikacji, identyfikatorów miejsc docelowych i identyfikatorów jednostek reklamowych podanych na stronie z identyfikatorem testowym Mintegral.
Weryfikowanie reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z Mintegral, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, używając źródeł reklam Mintegral (z określaniem stawek) i Mintegral (wodospad).
Kody błędów
Jeśli adapter nie otrzyma reklamy od Mintegral, wydawcy mogą sprawdzić błąd podstawowy w odpowiedzi reklamy, korzystając z interfejsu ResponseInfo
w ramach tych klas:
Android
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
Oto kody i dołączone komunikaty z adaptera Mintegral, które pojawiają się, gdy nie udaje się załadować reklamy:
Android
Kod błędu | Domena | Przyczyna |
---|---|---|
101 | com.google.ads.mediation.mintegral | nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub miejsca docelowego); |
102 | com.google.ads.mediation.mintegral | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Mintegral. |
103 | com.google.ads.mediation.mintegral | Brakująca lub nieprawidłowa odpowiedź na zapytanie o stawki. |
104 | com.google.ads.mediation.mintegral | Pakiet SDK Mintegral zwrócił błąd dotyczący braku wypełnienia. |
iOS
Kod błędu | Domena | Przyczyna |
---|---|---|
101 | com.google.mediation.mintegral | nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub miejsca docelowego); |
102 | com.google.mediation.mintegral | Pakiet SDK Mintegral zwrócił błąd dotyczący braku wypełnienia. |
103 | com.google.mediation.mintegral | Pakiet Mintegral SDK nie wyświetlił reklamy. |
104 | com.google.mediation.mintegral | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Mintegral. |
Historia zmian adaptera Mintegral Flutter Mediation
Następna wersja
- Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.2.0.
1.1.0
- Zweryfikowano zgodność z adapterem Mintegral do Androida w wersji 16.8.31.0.
- Weryfikowana zgodność z adapterem Mintegral na iOS w wersji 7.7.1.0.
- Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.
1.0.0
- Pierwsza wersja.
- Weryfikowana zgodność z adapterem Mintegral na Androida w wersji 16.7.21.0.
- Weryfikowana zgodność z adapterem Mintegral na iOS w wersji 7.6.3.0.
- Utworzono i przetestowano z użyciem wtyczki Google Mobile Ads Flutter w wersji 5.1.0.