W tym przewodniku dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z maioo za pomocą zapośredniczenia AdMob, w ramach integracji kaskadowych. 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 .
Etykiety, przyciski i opisy w interfejsie panelu maio są zapisane w języku japońskim. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku nazwy etykiet i przycisków mają swoje odpowiedniki 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
- Cel wdrożenia iOS w wersji 12.0 lub nowszej
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.
Zanotuj identyfikator multimediów na stronie Zarządzanie aplikacjami. W następnym kroku musisz skonfigurować jednostkę reklamową AdMob.
Na stronie Zone Management (Zarządzanie strefą) zanotuj identyfikator strefy. Będzie ona też potrzebna do skonfigurowania jednostki reklamowej AdMob w następnym rozdziale.
Krok 2. Skonfiguruj zamówienia maio w interfejsie AdMob
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Musisz dodać maio do konfiguracji zapośredniczenia jednostki reklamowej.
Najpierw zaloguj się na swoje konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź od razu do sekcji Dodawanie maio jako źródła reklam.
Aby utworzyć nową grupę zapośredniczenia, wybierz Utwórz grupę zapośredniczenia.
Podaj format reklamy i platformę, a następnie kliknij Dalej.
Nazwij grupę zapośredniczenia i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.
Powiąż tę grupę zapośredniczenia z co najmniej jedną istniejącą jednostką reklamowąAdMob . Następnie kliknij Gotowe.
Na karcie jednostek reklamowych powinny się pojawić wybrane przez Ciebie jednostki reklamowe:
Dodaj maio jako źródło reklam
Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklamy. Następnie kliknij maio.
Kliknij maio i włącz przełącznik Optymalizuj. Wpisz API ID and API KEYuzyskane w poprzedniej sekcji, aby skonfigurować optymalizację źródła reklam dla:maio. Następnie wpisz wartość eCPM dlamaio i kliknij Dalej.
Jeśli masz już mapowanie maio, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.
Następnie wpisz dane Media ID and Zone IDotrzymane 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ń:
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.frameworkw 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 pakietu SDK do reklam mobilnych Google w wersji 7.26.0 lub nowszej będą automatycznie otrzymywać reklamy testowe z Maio na telefony i tablety zarejestrowane 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
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 kodach 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 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.
- 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.plistw ramachMaioAdapter.xcframework.
Został opracowany i przetestowany z:
- 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.
Zaprojektowane i przetestowane:
- 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:
- 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.
- 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.
- Pakiet SDK MaioOB w wersji 2.0.0-alpha.
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.
- 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:
- 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:
- 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
- Zweryfikowano zgodność z pakietem SDK do reklam mobilnych Google w wersji 9.0.0.
- Teraz wymaga 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 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.
- 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 zdarzenia reklamy z nagrodą czasem nie były przekazywane.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 8.3.0 lub nowszej.
Zaprojektowane i przetestowane:
- 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.
- 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.
- Maio SDK w wersji 1.5.5.
Wersja 1.5.4.0
- Zweryfikowano 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.
Zaprojektowane i przetestowane:
- 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.
Zaprojektowane i przetestowane:
- 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:
- 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:
- 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
- Zweryfikowano 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 wywołanie zwrotne
adapterDidCompletePlayingRewardBasedVideoAd:do adaptera.
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ą.