Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam w Maio za pomocą zapośredniczenia obejmujących integracje kaskadowe. Przewodnik zawiera informacje o dodawaniu pakietu SDK maio do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera maio z aplikacjąiOS .
Interfejs panelu sterowania maio zawiera etykiety, przyciski i opisy w języku japońskim. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak opisane w języku angielskim. Na przykład „URL スキーム” to „URL Scheme”.
Obsługiwane integracje i formaty reklam
Adapter pośrednictwa dla maio ma te możliwości:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Natywna |
Wymagania
- docelowa wersja iOS 12.0 lub nowsza
Najnowsza wersja pakietu SDK do reklam mobilnych Google
Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.
Krok 1. Skonfiguruj konfiguracje w interfejsie maio
Najpierw zarejestruj się lub zaloguj się na swoje konto maio. Na pasku bocznym po lewej stronie kliknij kolejno Zarządzanie aplikacjami i Nowa aplikacja.
Wybierz kartę odpowiadającą preferowanemu typowi reklamy.
Pełnoekranowa
Wpisz nazwę aplikacji, wybierz platformę i podaj adres URL aplikacji. Jako Typ reklamy wybierz Reklama pełnoekranowa z wideo, a potem kliknij Zaktualizuj.
Z nagrodą
Wpisz nazwę aplikacji, wybierz platformę i podaj adres URL aplikacji. Jako Typ reklamy wybierz Nagrody za filmy, a następnie kliknij Zaktualizuj.
Na stronie Zarządzanie aplikacjami zanotuj identyfikator mediów. W następnej sekcji musisz skonfigurować jednostkę reklamową AdMob.
Na stronie Zarządzanie strefami zanotuj identyfikator strefy. Będzie ona też potrzebna do skonfigurowania jednostki reklamowej AdMob w następnym rozdziale.
(Tylko kaskada) Aby skonfigurować identyfikator jednostki reklamowej na potrzeby zapośredniczenia, oprócz identyfikatora multimediów i identyfikatora strefy musisz podać identyfikator API i klucz API. Na stronie interfejsu API do raportowania zanotuj identyfikator API i klucz API.Krok 2. Skonfiguruj zamówienia maio w interfejsie Ad Manager
Krok 3. Zaimportuj pakiet SDK i adapter maio
Za pomocą CocoaPods (zalecane)
Dodaj ten wiersz do pliku Podfile projektu:
pod 'GoogleMobileAdsMediationMaio'
W wierszu poleceń uruchom:
pod install --repo-update
Integracja ręczna
- Pobierz najnowszą wersję pakietu SDK Mapy Google.
- Pobierz najnowszą wersję interfejsu maio za pomocą linku do pobrania w Changelogu i uwzględnij link
maioAdapter.framework
w projekcie.
Krok 4. Dodaj wymagany kod
Integracja z SKAdNetwork
Aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu, postępuj zgodnie z dokumentacją maia.
Krok 5. Przetestuj implementację
Włącz reklamy testowe
Pamiętaj, aby zarejestrować urządzenie testowe w AdMob.
Wydawcy korzystający z wersji 7.26.0 lub nowszej pakietu SDK do reklam mobilnych Google będą automatycznie otrzymywać reklamy testowe z maiO na telefonach i tabletach zarejestrowanych jako urządzenia testowe podczas wysyłania żądań.
Zweryfikuj reklamy testowe
Aby sprawdzić, czy otrzymujesz reklamy testowe z Maio, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, używając źródeł reklam maio (wodospad).
Kody błędów
Jeśli adapter nie otrzyma reklamy z maia, wydawcy mogą sprawdzić błąd w odpowiedzi reklamy, korzystając z
GADResponseInfo.adNetworkInfoArray
w tych klasach:
Format | Nazwa zajęć |
---|---|
Pełnoekranowa | GADMMaioInterstitialAdapter |
Z nagrodą | GADMMaioRewardedAdapter |
Oto kody i odpowiednie komunikaty generowane przez adapter maio, gdy nie udaje się załadować reklamy:
Kod błędu | Przyczyna |
---|---|
0-10 | maio zwrócił błąd związany z pakietem SDK. Więcej informacji znajdziesz w kodzie maio. |
101 | maio nie ma jeszcze reklamy. |
102 | nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego). |
103 | Adapter maio nie obsługuje żądanego formatu reklamy. |
104 | Reklama została już wczytana na potrzeby tej konfiguracji sieci. |
Historia zmian adaptera zapośredniczenia iOS (maio)
Wersja 2.1.5.1
- Zaktualizowano zasadę
CFBundleShortVersionString
, by zawierała 3 komponenty zamiast 4.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 11.10.0.
- Wersja pakietu SDK Maio: 2.1.5.
Wersja 2.1.5.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 2.1.5.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 11.6.0.
- Wersja pakietu SDK Maio: 2.1.5.
Wersja 2.1.4.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 2.1.4.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 11.2.0.
- Wersja pakietu SDK Maio: 2.1.4.
Wersja 2.1.3.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 2.1.3.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 11.1.0.
- Maio SDK w wersji 2.1.3.
Wersja 2.1.2.1
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 11.0 lub nowszej.
- Uwzględnij
Info.plist
w ramachMaioAdapter.xcframework
.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
- Maio SDK w wersji 2.1.2.
Wersja 2.1.2.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 2.1.2.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
- Wersja pakietu SDK Maio: 2.1.2.
Wersja 2.1.1.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 2.1.1.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 10.12.0.
- Wersja pakietu SDK Maio: 2.1.1.
Wersja 2.0.0.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 2.0.0.
- Usunięto zależność od
MaioOB SDK
. - Usunięto obsługę architektury
armv7
. - Teraz wymagana jest co najmniej wersja 12.0 systemu iOS.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 10.10.0.
- Maio SDK w wersji 2.0.0.
Wersja 1.6.3.1
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.0.0 lub nowszej.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 10.0.0.
- Maio SDK w wersji 1.6.3.
- MaioOB SDK w wersji 2.0.0-alfa.
Wersja 1.6.3.0
- Zaktualizowano adapter, aby używał interfejsu API
didRewardUser
. - Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 9.8.0 lub nowszej.
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.6.3 i pakietem SDK maioOB w wersji 2.0.0-alpha.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 9.12.0.
- Maio SDK w wersji 1.6.3.
- Pakiet SDK MaioOB w wersji 2.0.0-alpha.
Wersja 1.6.2.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.6.2 i pakietem SDK maioOB w wersji 2.0.0-alpha.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 9.5.0.
- Pakiet SDK Maio w wersji 1.6.2.
- Pakiet SDK MaioOB w wersji 2.0.0-alpha.
Wersja 1.6.1.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.6.1 i pakietem SDK MaioOB w wersji 2.0.0-alfa.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 9.2.0.
- Wersja pakietu SDK Maio: 1.6.1.
- Pakiet SDK MaioOB w wersji 2.0.0-alpha.
Wersja 1.6.0.1
- Wersja zweryfikowana pod kątem zgodności z pakietem SDK do reklam mobilnych Google w wersji 9.0.0.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 9.0.0 lub nowszej.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 9.0.0.
- Wersja pakietu SDK Maio: 1.6.0.
- Pakiet SDK MaioOB w wersji 2.0.0-alpha.
Wersja 1.6.0.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.6.0 i pakietem SDK maioOB w wersji 2.0.0-alpha.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 8.13.0.
- Teraz wymaga to systemu iOS w wersji co najmniej 10.0.
- Maio SDK w wersji 1.6.0.
- Pakiet SDK MaioOB w wersji 2.0.0-alpha.
Wersja 1.5.8.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.8 i pakietem SDK maioOB w wersji 2.0.0-alpha.
- Dodano do adaptera możliwość określania stawek w przypadku formatów reklam pełnoekranowych i reklam z nagrodą.
- Zmniejszona zależność od pakietu SDK do reklam mobilnych Google w wersji 8.0.0 lub nowszej.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 8.7.0.
- Maio SDK w wersji 1.5.8.
- MaioOB SDK w wersji 2.0.0-alfa.
Wersja 1.5.6.1
- Dodano standardowe kody błędów i komunikaty dotyczące adaptera.
- Zaktualizowano adapter, aby używał formatu
.xcframework
. - Naprawiliśmy błąd, który powodował, że czasami nie były przesyłane zdarzenia związane z reklamami z nagrodą.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 8.3.0 lub nowszej.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 8.3.0.
- Maio SDK w wersji 1.5.6.
Wersja 1.5.6.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.6.
- Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 7.68.0 lub nowszej.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 7.68.0.
- Wersja pakietu SDK Maio: 1.5.6.
Wersja 1.5.5.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.5.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.64.0 lub nowszej.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 7.64.0.
- Wersja pakietu SDK Maio: 1.5.5.
Wersja 1.5.4.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.4.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.60.0 lub nowszej.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 7.60.0.
- Wersja pakietu SDK Maio: 1.5.4.
Wersja 1.5.3.1
- Aby ograniczyć limity czasu, żądania reklamy będą się teraz natychmiast kończyć niepowodzeniem, jeśli maio nie ma reklamy gotowej do wyświetlenia.
- Wycofano obsługę architektury i386.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 7.58.0.
- Wersja pakietu SDK Maio: 1.5.3.
Wersja 1.5.3.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.5.3.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 7.55.1.
- Maio SDK w wersji 1.5.3.
Wersja 1.5.2.1
- Rozwiązaliśmy problem, który powodował, że adapter nie wywoływał funkcji zwracającej wywołanie zwrotne
-rewardedAdDidPresent:
.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 7.53.1.
- Pakiet SDK Maio w wersji 1.5.2.
Wersja 1.5.2.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.2.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 7.53.1.
- Pakiet SDK Maio w wersji 1.5.2.
Wersja 1.5.1.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.1.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 7.52.0.
- Wersja pakietu SDK Maio: 1.5.1.
Wersja 1.5.0.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.0.
Został opracowany i przetestowany z użyciem
- Pakiet SDK do reklam mobilnych Google w wersji 7.51.0.
- Pakiet SDK Maio Ads w wersji 1.5.0.
Wersja 1.4.8.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.4.8.
Wersja 1.4.6.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.4.6.
- Zaktualizowano adapter, aby korzystał z nowego interfejsu API nagród.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.42.2 lub nowszej.
Wersja 1.4.2.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.4.2.
Wersja 1.4.1.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.4.1.
- Rozwiązaliśmy problem, który powodował, że adapter maio mógł nie działać, jeśli w AdMob podano wiele identyfikatorów MediaId.
Wersja 1.4.0.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.4.0.
Wersja 1.3.2.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.3.2.
Wersja 1.3.1.1
- Dodano do adaptera wywołanie zwrotne
adapterDidCompletePlayingRewardBasedVideoAd:
.
Wersja 1.3.1.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.3.1.
Wersja 1.3.0.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.3.0.
Wersja 1.2.19.0
- Zweryfikowano zgodność z pakietem SDK maio w wersji 1.2.19.
Wersja 1.2.18.0
- Pierwsza wersja
- Dodaliśmy obsługę reklam pełnoekranowych i reklam wideo z nagrodą.