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 „Schemat URL”.
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 konto maio. Kliknij przycisk Zarządzanie aplikacjami na lewym pasku bocznym i wybierz 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 Zone Management (Zarządzanie strefą) zanotuj identyfikator strefy. Konieczne będzie też skonfigurowanie jednostki reklamowej AdMob w następnej sekcji.
(Tylko w przypadku wodospadu) Oprócz identyfikatora mediów i identyfikatora strefy potrzebne są identyfikator interfejsu API i klucz interfejsu API, by skonfigurować identyfikator jednostki reklamowej na potrzeby zapośredniczenia. Na stronie interfejsu API do raportowania zanotuj identyfikator API i klucz API.Krok 2. Skonfiguruj zamówienia maio w interfejsie Ad Manager
Krok 3. Importuj 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ę adaptera Maio z linku do pobierania w dzienniku zmian i dodaj link
maioAdapter.framework
w swoim 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
Zarejestruj urządzenie testowe na potrzeby Ad Manager.
Wydawcy, którzy korzystają z pakietu SDK do reklam mobilnych Google w wersji 7.26.0 lub nowszej, automatycznie będą otrzymywać w żądaniach reklamy testowe z Maio na telefony i tablety zarejestrowane jako urządzenia testowe.
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynymaio, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z maio (Waterfall) źródeł reklam.
Kody błędów
Jeśli adapter nie otrzyma reklamy od Maio, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi za pomocą polecenia
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.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 11.1.0.
- Wersja pakietu SDK Maio: 2.1.3.
Wersja 2.1.2.1
- Teraz wymaga 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.
- Wersja pakietu SDK Maio: 2.1.2.
Wersja 2.1.2.0
- Zweryfikowano 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.
- Maio SDK w wersji 2.1.2.
Wersja 2.1.1.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 2.1.1.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 10.12.0.
- Wersja pakietu SDK Maio: 2.1.1.
Wersja 2.0.0.0
- Zweryfikowano 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.
- Wersja pakietu SDK Maio: 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.
- Wersja pakietu SDK Maio: 1.6.3.
- MaioOB SDK w wersji 2.0.0-alfa.
Wersja 1.6.3.0
- Zaktualizowano adapter, aby korzystał z interfejsu
didRewardUser
API. - Teraz wymaga 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.
- MaioOB SDK w wersji 2.0.0-alfa.
Wersja 1.6.2.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.6.2 i pakietem SDK MaioOB w wersji 2.0.0-alfa.
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.
Został opracowany i przetestowany z:
- 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.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 8.13.0.
- Teraz wymagana jest co najmniej wersja 10.0 systemu iOS.
- Wersja pakietu SDK Maio: 1.6.0.
- Pakiet SDK MaioOB w wersji 2.0.0-alpha.
Wersja 1.5.8.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.5.8 i pakietem SDK MaioOB w wersji 2.0.0-alfa.
- Dodaliśmy możliwość określania stawek w adapterze 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.
- Wersja pakietu SDK Maio: 1.5.8.
- Pakiet SDK MaioOB w wersji 2.0.0-alpha.
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.
- Wersja pakietu SDK Maio: 1.5.6.
Wersja 1.5.6.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.6.
- Wymaga teraz 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.
Został opracowany i przetestowany z:
- 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
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.3.
Został opracowany i przetestowany z:
- 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.
- Maio SDK w wersji 1.5.2.
Wersja 1.5.2.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.2.
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.1.0
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.5.1.
Został opracowany i przetestowany z:
- 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.
Stworzone i przetestowane przy użyciu
- Pakiet SDK do reklam mobilnych Google w wersji 7.51.0.
- Maio Ads SDK 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 używał nowego interfejsu API z nagrodą.
- 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
- Zweryfikowano 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 z AdMob otrzymano 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
- Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.3.0.
Wersja 1.2.19.0
- Weryfikowana 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ą.