Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z maia przy użyciu mediacji AdMob, uwzględniając integracje kaskadowe. Przewodnik ten zawiera informacje o dodawaniu pakietu SDK maio do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera maio z aplikacją na 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 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 wideo, a następnie 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ępnym kroku musisz skonfigurować jednostkę reklamową AdMob.
Na stronie Zarządzanie strefami zanotuj identyfikator strefy. Potrzebny będzie też 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 popyt maio w interfejsie AdMob
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Musisz dodać maio do konfiguracji pośrednictwa dla danej jednostki reklamowej.
Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediation (Mediacja). Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, a potem przejdź do sekcji Dodaj maio jako źródło reklam.
Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.
Wpisz format reklamy i platformę, a potem kliknij Dalej.
Nadaj grupie zapośredniczenia nazwę i wybierz lokalizacje docelowe. Następnie ustaw stan grupy zapośredniczenia na Włączona, a potem kliknij Dodaj jednostki reklamowe.
Połącz tę grupę zapośredniczenia z co najmniej jedną z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.
Powinna się teraz wyświetlić karta Jednostki reklamowe z wybranymi przez Ciebie jednostkami reklamowymi:
Dodawanie maio jako źródła reklam
Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie kliknij maio.
Wybierz maio i włącz przełącznik Optymalizuj. Aby skonfigurować optymalizację źródła reklam dla maio, wpisz identyfikator API i klucz API uzyskane w poprzedniej sekcji. Następnie wpisz wartość eCPM dla mai.io i kliknij Dalej.
Jeśli masz już mapowanie dla konta mai., możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.
Następnie wpisz identyfikator multimediów i identyfikator strefy uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.
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ę 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łączanie reklam testowych
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ń.
Weryfikowanie reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z maio, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródła reklam maio (kaskada).
Kody błędów
Jeśli adapter nie otrzyma reklamy z maia, wydawcy mogą sprawdzić błąd w odpowiedzi reklamy, korzystając z usługi GADResponseInfo.adNetworkInfoArray
w ramach tych klas:
Format | Nazwa zajęć |
---|---|
Pełnoekranowa | GADMMaioInterstitialAdapter |
Z nagrodą | GADMMaioRewardedAdapter |
Oto kody i odpowiednie komunikaty z adaptera maio, które pojawiają się, 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 kodach firmy 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ż załadowana w przypadku tej konfiguracji sieci. |
Historia zmian adaptera zapośredniczenia na iOS w wersji maio
Wersja 2.1.5.1
- Zaktualizowaliśmy komponent
CFBundleShortVersionString
, tak aby zawierał 3 elementy zamiast 4.
Został opracowany i przetestowany z użyciem:
- 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 użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 11.6.0.
- Wersja pakietu SDK Maio: 2.1.5.
Wersja 2.1.4.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 2.1.4.
Został opracowany i przetestowany z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 11.2.0.
- Wersja pakietu SDK Maio: 2.1.4.
Wersja 2.1.3.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 2.1.3.
Został opracowany i przetestowany z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 11.1.0.
- Wersja pakietu SDK Maio: 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 ramach ramowychMaioAdapter.xcframework
.
Został opracowany i przetestowany z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
- Wersja pakietu SDK Maio: 2.1.2.
Wersja 2.1.2.0
- Weryfikowana zgodność z pakietem SDK maio w wersji 2.1.2.
Został opracowany i przetestowany z użyciem:
- 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.
Został opracowany i przetestowany z użyciem:
- 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 użyciem:
- 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 użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 10.0.0.
- Wersja pakietu SDK Maio: 1.6.3.
- Pakiet SDK MaioOB w wersji 2.0.0-alpha.
Wersja 1.6.3.0
- Zaktualizowano adapter, aby korzystał z interfejsu
didRewardUser
API. - 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 użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 9.12.0.
- Wersja pakietu SDK Maio: 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.
Został opracowany i przetestowany z użyciem:
- 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
- Weryfikowana zgodność z pakietem SDK maio w wersji 1.6.1 i pakietem SDK maioOB w wersji 2.0.0-alpha.
Został opracowany i przetestowany z użyciem:
- 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 użyciem:
- 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 użyciem:
- 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
- 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 użyciem:
- 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 użyciem:
- 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 użyciem:
- 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 użyciem:
- 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 użyciem:
- 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 usługa maio nie ma gotowej reklamy do wyświetlenia.
- Wycofano obsługę architektury i386.
Został opracowany i przetestowany z użyciem:
- 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 użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 7.55.1.
- Wersja pakietu SDK Maio: 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 użyciem:
- 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.
Został opracowany i przetestowany z użyciem:
- 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.
Został opracowany i przetestowany z użyciem:
- 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
- Weryfikowana 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 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
- Weryfikowana 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ą.