Z tego przewodnika dowiesz się, jak używać Google Mobile Ads Flutter Plugin do wczytywania i wyświetlania reklam z Moloco za pomocą zapośredniczenia, w tym z integracji z ustalaniem stawek. Dowiesz się, jak dodać Moloco do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Moloco z aplikacją Flutter.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia Ad Managera dla Moloco 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
- Aby wdrożyć aplikację na Androidzie:
- Android API w wersji 23 lub nowszej
- Aby wdrożyć aplikację 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.
- Konfiguracja zapośredniczenia
Krok 1. Skonfiguruj ustawienia w interfejsie Moloco
Zaloguj się w portalu wydawcy Moloco.
Otwórz Przegląd > kartę Aplikacje , a potem kliknij przycisk Dodaj aplikację , aby utworzyć nową aplikację.
Wybierz OS i Ustawienia prywatności aplikacji, wypełnij resztę formularza, a potem kliknij Utwórz.
Android
iOS
Gdy aplikacja zostanie utworzona, wybierz ją na karcie Aplikacje , aby wyświetlić szczegóły, i zanotuj Klucz aplikacji.
Android
iOS
Otwórz Przegląd > kartę Jednostki reklamowe, wybierz aplikację z menu, a potem kliknij Nowa jednostka reklamowa.
Jako Metodę aukcji wybierz Ustalanie stawek w aplikacji i wypełnij resztę formularza. Następnie kliknij Utwórz.
Otwórz nowo utworzoną jednostkę reklamową na karcie Jednostki reklamowe , aby wyświetlić jej szczegóły. Zanotuj Identyfikator jednostki reklamowej.
Krok 2. Skonfiguruj popyt Moloco w interfejsie Ad Managera
Skonfiguruj ustawienia zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego Android.
iOS
Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego iOS.
Dodaj Moloco Ads do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi dotyczącymi prywatności
Wykonaj czynności opisane w sekcjach Ustawienia wymagane przez rozporządzenia europejskie i Ustawienia wymagane przez amerykańskie przepisy stanowe , aby dodać Moloco Ads do listy partnerów reklamowych zachowujących zgodność z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi dotyczącymi prywatności w interfejsie Ad Managera.
Krok 3. Zaimportuj pakiet SDK i adapter Moloco
Integracja przez pub.dev
Dodaj tę zależność z najnowszymi wersjami pakietu SDK i adaptera Moloco Ads SDK w pliku pubspec.yaml pakietu:
dependencies:
gma_mediation_moloco: ^3.4.0
Integracja ręczna
Pobierz najnowszą wersję wtyczki zapośredniczenia Google Mobile Ads dla
pakietu Moloco Ads SDK,
rozpakuj pobrany plik i dodaj rozpakowany folder wtyczki
(wraz z jego zawartością) do projektu Flutter. Następnie dodaj do pliku pubspec.yaml tę zależność:
dependencies:
gma_mediation_moloco:
path: path/to/local/package
Krok 4. Dodaj wymagany kod
Do integracji z Moloco nie jest wymagany żaden dodatkowy kod.
Krok 5. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe w Ad Managerze.
Sprawdź reklamy testowe
Aby sprawdzić, czy otrzymujesz reklamy testowe z pakietu Moloco Ads SDK, włącz testowanie pojedynczych źródeł reklam w inspektorze reklam, korzystając ze źródeł reklam Moloco (ustalanie stawek).
Kody błędów
Jeśli adapter nie otrzyma reklamy z Moloco, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy za pomocą ResponseInfo w tych klasach:
Android
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
iOS
MolocoSDK.MolocoError
GADMediationAdapterMoloco
Oto kody i towarzyszące im komunikaty zwracane przez adapter Moloco, gdy nie uda się wczytać reklamy:
Android
| Kod błędu | Domena | Przyczyna |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Brakujący lub nieprawidłowy klucz aplikacji Moloco. |
| 102 | com.google.ads.mediation.moloco | Brakujący lub nieprawidłowy identyfikator jednostki reklamowej Moloco. |
| 103 | com.google.ads.mediation.moloco | Zwrócony obiekt reklamy Moloco miał wartość null. |
| -1 do 5000 | com.moloco.sdk | Pakiet SDK Moloco zwrócił błąd. Więcej informacji znajdziesz w dokumentacji Moloco. |
iOS
| Kod błędu | Domena | Przyczyna |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Pakiet SDK Moloco nie obsługuje wyświetlania reklam w systemie iOS 12 i starszych. |
| 102 | com.google.ads.mediation.moloco | Brakujący lub nieprawidłowy klucz aplikacji Moloco. |
| 103 | com.google.ads.mediation.moloco | Brakujący lub nieprawidłowy identyfikator jednostki reklamowej Moloco. |
| 104 | com.google.ads.mediation.moloco | Reklama nie jest gotowa do wyświetlenia. |
| 105 | com.google.ads.mediation.moloco | Nie udało się wyświetlić reklamy. |
| 106 | com.google.ads.mediation.moloco | Dane renderowania są niedostępne. |
| -1 do 5000 | Wysłane przez pakiet SDK Moloco | Pakiet SDK Moloco zwrócił błąd. Więcej informacji znajdziesz w dokumentacji Moloco. |
Weryfikacja po stronie serwera w przypadku reklam z nagrodą
Dziennik zmian adaptera zapośredniczenia Moloco Flutter
Wersja 3.4.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 Moloco na Androida w wersji 4.7.0.0.
- Obsługuje adapter Moloco na iOS w wersji 4.5.1.0.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 8.0.0.
Wersja 3.3.0
- Obsługuje adapter Moloco na Androida w wersji 4.5.0.0.
- Obsługuje adapter Moloco na iOS w wersji 4.3.0.2.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 7.0.0.
Wersja 3.2.0
- Obsługuje adapter Moloco na Androida w wersji 4.4.0.0.
- Obsługuje adapter Moloco na iOS w wersji 4.2.0.0.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 7.0.0.
Wersja 3.1.0
- Zaktualizowano minimalną wersję Fluttera do 3.35.1.
- Obsługuje adapter Moloco na Androida w wersji 4.4.0.0.
- Obsługuje adapter Moloco na iOS w wersji 4.1.2.0.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 7.0.0.
Wersja 3.0.0
- Obsługuje adapter Moloco na Androida w wersji 4.3.1.0.
- Obsługuje adapter Moloco na iOS w wersji 4.1.0.0.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 2.1.0
- Obsługuje adapter Moloco na Androida w wersji 4.2.0.0.
- Obsługuje adapter Moloco na iOS w wersji 3.13.0.0.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 2.0.0
- Obsługuje adapter Moloco na Androida w wersji 4.0.0.0.
- Obsługuje adapter Moloco na iOS w wersji 3.13.0.0.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.6.0
- Obsługuje adapter Moloco na Androida w wersji 3.12.0.0.
- Obsługuje adapter Moloco na iOS w wersji 3.12.0.0.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.5.0
- Obsługuje adapter Moloco na Androida w wersji 3.11.0.0.
- Obsługuje adapter Moloco na iOS w wersji 3.11.0.0.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.4.0
- Obsługuje adapter Moloco na Androida w wersji 3.10.0.0.
- Obsługuje adapter Moloco na iOS w wersji 3.10.0.0.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.3.1
- Obsługuje adapter Moloco na Androida w wersji 3.9.0.0.
- Obsługuje adapter Moloco na iOS w wersji 3.9.1.0.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.3.0
- Obsługuje adapter Moloco na Androida w wersji 3.9.0.0.
- Obsługuje adapter Moloco na iOS w wersji 3.9.0.0.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.2.0
- Obsługuje adapter Moloco na Androida w wersji 3.8.0.1.
- Obsługuje adapter Moloco na iOS w wersji 3.8.0.0.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.
Wersja 1.1.0
- Obsługuje adapter Moloco na Androida w wersji 3.7.0.0.
- Obsługuje adapter Moloco na iOS w wersji 3.6.0.0.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 5.3.1.
Wersja 1.0.0
- Pierwsza wersja.
- Obsługuje adapter Moloco na Androida w wersji 3.6.1.0.
- Obsługuje adapter Moloco na iOS w wersji 3.6.0.0.
- Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 5.3.1.