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, która obejmuje integrację kaskadową. 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 rozdziale musisz skonfigurować jednostkę reklamową Ad Managera.
Na stronie Zarządzanie strefami zanotuj identyfikator strefy. Potrzebny będzie też w przypadku konfigurowania jednostki reklamowej Ad Managera 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 Ad Managera
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Zaloguj się na konto Ad Managera.
Kliknij Wyświetlanie > Grupy zysku, a potem kliknij przycisk Nowa grupa zysku.
Wpisz unikalną nazwę grupy zysku, ustaw stan na Aktywna, wybierz Format reklamy i ustaw Typ zasobów reklamowych na Aplikacja mobilna. W sekcji Targetowanie > Zasoby wybierz jednostkę reklamową w sekcji Zasoby reklamowe i Aplikacja mobilna, do której chcesz dodać zapośredniczenie.
Następnie kliknij przycisk Dodaj partnera zysku.
Jeśli masz już partnera zysku w maio, możesz go wybrać. W przeciwnym razie wybierz Utwórz nowego partnera zysku.
Jako sieć reklamowa wybierz maio, wpisz unikalną nazwę i włącz zapośredniczenie.
Włącz Automatyczne zbieranie danych i wpisz identyfikator API oraz klucz API uzyskane w poprzedniej sekcji.
Po wybraniu partnera zysku wybierz Zapośredniczenie mobilne SDK jako Typ integracji, iOS jako Platforma i Aktywny jako Stan. Wpisz identyfikator multimediów i identyfikator strefy uzyskane w poprzedniej sekcji. Następnie wpisz wartość Domyślny CPM.
Gdy skończysz, u dołu strony kliknij Zapisz.
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
Upewnij się, że urządzenie testowe jest zarejestrowane w Ad Managerze.
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ą.