Z tego przewodnika dowiesz się, jak używać Google Mobile Ads Flutter Plugin do wczytywania i wyświetlania reklam z Mintegral za pomocą zapośredniczenia, omówimy integrację z wodospadem i określanie stawek. Dowiesz się, jak dodać Mintegral do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Mintegral z aplikacją Flutter.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia AdMob dla Mintegral ma te możliwości:
| Integracja | |
|---|---|
| Określanie stawek | |
| Wodospad | |
| Formaty | |
| Otwarcie aplikacji | |
| Baner | |
| Pełnoekranowa | |
| Z nagrodą | |
| Reklama pełnoekranowa z nagrodą | |
| Natywna | |
Wymagania
- Najnowsza Google Mobile Ads Flutter Plugin
- Flutter 3.7.0 lub nowszy
- [W przypadku określania stawek] Aby zintegrować wszystkie obsługiwane formaty reklam w określeniu stawek, użyj wtyczki zapośredniczenia reklam mobilnych Google dla Mintegral w wersji 1.4.0 lub nowszej (zalecana jest najnowsza wersja).
- Aby wdrożyć na Androidzie:
- Android API w wersji 23 lub nowszej
- Aby wdrożyć na iOS:
- iOS w wersji 13.0 lub nowszej
- Działający projekt Flutter skonfigurowany za pomocą Google Mobile Ads Flutter Plugin. Więcej informacji znajdziesz w artykule Konfigurowanie Google Mobile Ads Flutter Plugin.
- Skonfiguruj zapośredniczenie AdMob
Krok 1. Skonfiguruj ustawienia w interfejsie Mintegral
Zarejestruj się lub zaloguj na konto Mintegral.
Znajdź klucz aplikacji
Otwórz kartę Ustawienia aplikacji i zapisz klucz aplikacji.

Dodaj nową aplikację
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 otwórz 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 resztę formularza i kliknij Zapisz.

Wodospad
Jako typ określania stawek wybierz Wodospad. Wypełnij resztę formularza i kliknij Zapisz.

Po utworzeniu miejsca docelowego reklamy zapisz identyfikator miejsca docelowego.
Android
iOS
Kliknij menu 1 jednostka reklamowa i zapisz identyfikator jednostki reklamowej.
Android
iOS
Znajdź klucz interfejsu API raportowania Mintegral
Określanie stawek
Ten krok nie jest wymagany w przypadku integracji z określeniem stawek.
Wodospad
Do skonfigurowania identyfikatora jednostki reklamowej AdMob potrzebny będzie klucz interfejsu API raportowania Mintegral. Otwórz Konto > Narzędzia API. Zapisz Skey i Secret.

Zaktualizuj plik app-ads.txt
Authorized Sellers for Apps (czyli plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje
zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec utracie przychodów z reklam, użyj pliku app-ads.txt.
Jeśli jeszcze tego nie zrobisz,
skonfiguruj plik app-ads.txt dla swojej aplikacji.
Aby wdrożyć app-ads.txt w Mintegral, przeczytaj artykuł
Jak plik app-ads.txt może pomóc w walce z oszustwami reklamowymi.
Krok 2. Skonfiguruj popyt Mintegral w interfejsie AdMob
Skonfiguruj ustawienia zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 przewodnika dla Android.
iOS
Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.
Dodaj Mobvista/Mintegral do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi dotyczącymi prywatności
Aby dodać Mobvista/Mintegral do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi dotyczącymi prywatności w interfejsie AdMob, wykonaj czynności opisane w artykułach Ustawienia wymagane przez rozporządzenia europejskie i Ustawienia wymagane przez amerykańskie przepisy stanowowe.
Krok 3. Zaimportuj pakiet SDK i adapter Mintegral
Integracja przez pub.dev
Dodaj tę zależność z najnowszymi wersjami pakietu SDK i adaptera Mintegral w pliku pubspec.yaml pakietu:
dependencies:
gma_mediation_mintegral: ^2.1.1
Integracja ręczna
Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla
Mintegral,
rozpakuj pobrany plik i dodaj rozpakowany folder wtyczki
(oraz jego zawartość) do projektu Flutter. Następnie dodaj do pliku pubspec.yaml tę zależność:
dependencies:
gma_mediation_mintegral:
path: path/to/local/package
Krok 4. Dodaj wymagany kod
Android
W przypadku integracji z Mintegral nie jest wymagany żaden dodatkowy kod.
iOS
Integracja SKAdNetwork
Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją Mintegral.
Krok 5. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe w AdMob.
Aby otrzymywać reklamy testowe Mintegral w formatach banerów, reklam pełnoekranowych, reklam z nagrodą i reklam natywnych, Mintegral zaleca używanie kluczy aplikacji, identyfikatorów aplikacji, identyfikatorów miejsc docelowych i identyfikatorów jednostek reklamowych podanych na stronie identyfikatorów testowych Mintegral.
Sprawdź reklamy testowe
Aby sprawdzić, czy otrzymujesz reklamy testowe z Mintegral, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, używając Mintegral (określanie stawek) i Mintegral (wodospad) źródeł reklam.
Kody błędów
Jeśli adapter nie otrzyma reklamy z Mintegral, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy za pomocą ResponseInfo w tych klasach:
Android
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
Oto kody i towarzyszące im komunikaty zwracane przez adapter Mintegral, gdy nie uda się wczytać reklamy:
Android
| Kod błędu | Domena | Przyczyna |
|---|---|---|
| 101 | com.google.ads.mediation.mintegral | Nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub identyfikatora 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 pytanie o stawkę. |
| 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 identyfikatora miejsca docelowego). |
| 102 | com.google.mediation.mintegral | Pakiet SDK Mintegral zwrócił błąd dotyczący braku wypełnienia. |
| 103 | com.google.mediation.mintegral | Pakietowi SDK Mintegral nie udało się wyświetlić reklamy. |
| 104 | com.google.mediation.mintegral | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Mintegral. |
Dziennik zmian adaptera zapośredniczenia Mintegral dla Fluttera
Wersja 2.1.1
- Obsługuje adapter Mintegral na Androida w wersji 17.1.61.1.
- Obsługuje adapter Mintegral na iOS w wersji 8.1.5.0.
- Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 9.0.0.
Wersja 2.1.0
- Zaktualizowano minimalną wersję Fluttera do 3.38.1.
- Zaktualizowano obsługę wtyczki reklam mobilnych Google do Fluttera w wersji 8.0.0.
- Obsługuje adapter Mintegral na Androida w wersji 17.1.41.0.
- Obsługuje adapter Mintegral na iOS w wersji 8.1.1.0.
- Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 8.0.0.
Wersja 2.0.3
- Obsługuje adapter Mintegral na Androida w wersji 17.0.61.0.
- Obsługuje adapter Mintegral na iOS w wersji 8.0.5.1.
- Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 7.0.0.
Wersja 2.0.2
- Zaktualizowano minimalną wersję Fluttera do 3.35.1.
- Zaktualizowano obsługę wtyczki reklam mobilnych Google do Fluttera w wersji 7.0.0.
- Obsługuje adapter Mintegral na Androida w wersji 17.0.41.0.
- Obsługuje adapter Mintegral na iOS w wersji 8.0.4.0.
- Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 2.0.1
- Obsługuje adapter Mintegral na Androida w wersji 17.0.31.0.
- Obsługuje adapter Mintegral na iOS w wersji 8.0.3.0.
- Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 2.0.0
- Obsługuje adapter Mintegral na Androida w wersji 17.0.21.0.
- Obsługuje adapter Mintegral na iOS w wersji 8.0.2.0.
- Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.2.6
- Obsługuje adapter Mintegral na Androida w wersji 16.9.91.1.
- Obsługuje adapter Mintegral na iOS w wersji 7.7.9.1.
- Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.2.5
- Obsługuje adapter Mintegral na Androida w wersji 16.9.91.1.
- Obsługuje adapter Mintegral na iOS w wersji 7.7.9.0.
- Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.2.4
- Obsługuje adapter Mintegral na Androida w wersji 16.9.91.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.7.9.0.
- Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.2.3
- Obsługuje adapter Mintegral na Androida w wersji 16.9.71.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.7.8.0.
- Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.2.2
- Obsługuje adapter Mintegral na Androida w wersji 16.9.71.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.7.7.0.
- Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.2.1
- Obsługuje adapter Mintegral na Androida w wersji 16.9.61.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.7.7.0.
- Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.2.0
- Obsługuje adapter Mintegral na Androida w wersji 16.9.41.1.
- Obsługuje adapter Mintegral na iOS w wersji 7.7.7.0.
- Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 5.3.1.
Wersja 1.1.0
- Wtyczka na iOS jest teraz frameworkiem statycznym.
- Obsługuje adapter Mintegral na Androida w wersji 16.8.61.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.7.5.0.
- Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 5.3.1.
Wersja 1.0.0
- Pierwsza wersja.
- Obsługuje adapter Mintegral na Androida w wersji 16.7.21.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.6.3.0.
- Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 5.1.0.