Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z maio przy użyciu mediacji AdMob, w tym integracji kaskadowych. Wyjaśnia, jak dodać maio do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter maio z aplikacją na iOS.
Interfejs panelu platformy maio używa tekstu w języku japońskim w przypadku etykiet, przycisków i opisów, a zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak podawane w języku angielskim. „URL スキーム” to na przykład „URL Scheme”.
Obsługiwane integracje i formaty reklam
Adapter mediacji w przypadku maio ma te możliwości:
| Integracja | |
|---|---|
| Określanie stawek | |
| Wodospad | |
| Formaty | |
| Baner | |
| Pełnoekranowa | |
| Z nagrodą | |
| Natywna | |
Wymagania
- iOS w wersji 12.0 lub nowszej
Najnowszy pakiet SDK do reklam mobilnych Google.
Zapoznaj się z przewodnikiem dla początkujących dotyczącym mediacji.
Krok 1. Skonfiguruj ustawienia w interfejsie maio
Najpierw zarejestruj się lub zaloguj na konto maio. Na pasku bocznym po lewej stronie kliknij przycisk Zarządzanie aplikacjami, a następnie 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 Aktualizuj.

Z nagrodą
Wpisz nazwę aplikacji, wybierz platformę i podaj adres URL aplikacji. Jako Typ reklamy wybierz Reklamy wideo z nagrodą, a potem kliknij Aktualizuj.

Na stronie Application Management (Zarządzanie aplikacjami) zanotuj Media ID (Identyfikator multimediów). Jest to potrzebne do skonfigurowania jednostki reklamowej AdMob w następnej sekcji.

Na stronie Zarządzanie strefami zanotuj Identyfikator strefy. Będzie on też potrzebny do skonfigurowania jednostki reklamowej AdMob w następnej sekcji.


Krok 2. Skonfiguruj popyt w maio w interfejsie AdMob
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Musisz dodać maio do konfiguracji mediacji w przypadku jednostki reklamowej.
Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediacja. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie maio jako źródła 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, na które chcesz kierować reklamy. Następnie ustaw stan grupy mediacyjnej na Włączona i kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z co najmniej jedną z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Powinna wyświetlić się karta jednostek reklamowych z wybranymi jednostkami:

Dodawanie maio jako źródła reklam
Na karcie Kaskadowe w sekcji Źródła reklam kliknij Dodaj źródło reklam.
Wybierz maio i włącz przełącznik Optymalizuj. Aby skonfigurować optymalizację źródeł reklam w przypadku maio, wpisz identyfikator interfejsu API i klucz interfejsu API uzyskane w poprzedniej sekcji. Następnie wpisz wartość eCPM dla maio i kliknij Dalej.

Jeśli masz już mapowanie dla maio, 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. Zaimportuj pakiet SDK i adapter maio
Korzystanie z CocoaPods (zalecane)
Dodaj do pliku Podfile projektu ten wiersz:
pod 'GoogleMobileAdsMediationMaio'W wierszu poleceń uruchom:
pod install --repo-update
Integracja ręczna
- Pobierz najnowszą wersję pakietu SDK maio.
- Pobierz najnowszą wersję adaptera maio, korzystając z linku do pobierania w dzienniku zmian, i połącz
maioAdapter.frameworkw projekcie.
Krok 4. Dodaj wymagany kod
Integracja SKAdNetwork
Postępuj zgodnie z dokumentacją maio, aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu.
Krok 5. Przetestuj implementację
Włączanie reklam testowych
Upewnij się, że zarejestrowano 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ć z maio reklamy testowe 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ódeł reklam maio (kaskadowe).
Kody błędów
Jeśli adapter nie otrzyma reklamy z maio, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na reklamę, korzystając z GADResponseInfo.adNetworkInfoArray w tych klasach:
| Format | Nazwa zajęć |
|---|---|
| Pełnoekranowa | GADMMaioInterstitialAdapter |
| Z nagrodą | GADMMaioRewardedAdapter |
Oto kody i komunikaty, które są zwracane przez adapter maio, gdy nie uda się wczytać reklamy:
| Kod błędu | Przyczyna |
|---|---|
| 0-10 | maio zwrócił błąd specyficzny dla pakietu SDK. Więcej informacji znajdziesz w kodzie usługi maio. |
| 101 | maio nie ma jeszcze dostępnej reklamy. |
| 102 | Nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego). |
| 103 | Adapter maio nie obsługuje formatu reklamy, o który wysłano żądanie. |
| 104 | Reklama jest już wczytana w przypadku tej konfiguracji sieci. |
Historia zmian adaptera zapośredniczenia maio na iOS
Wersja 2.2.0.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 2.2.0.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 12.11.0.
- Maio SDK w wersji 2.2.0.
Wersja 2.1.6.1
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 12.0.0 lub nowszej.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 12.0.0.
- Maio SDK w wersji 2.1.6.
Wersja 2.1.6.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 2.1.6.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 11.13.0.
- Maio SDK w wersji 2.1.6.
Wersja 2.1.5.1
- Zaktualizowano
CFBundleShortVersionString, aby zawierał 3 komponenty zamiast 4.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 11.10.0.
- Maio SDK w wersji 2.1.5.
Wersja 2.1.5.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 2.1.5.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 11.6.0.
- Maio SDK w wersji 2.1.5.
Wersja 2.1.4.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 2.1.4.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 11.2.0.
- Maio SDK w wersji 2.1.4.
Wersja 2.1.3.0
- Sprawdzona zgodność z pakietem SDK maio w wersji 2.1.3.
Zbudowano i przetestowano przy użyciu:
- 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.plistw platformach w ramachMaioAdapter.xcframework.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
- Maio SDK w wersji 2.1.2.
Wersja 2.1.2.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 2.1.2.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
- Maio SDK w wersji 2.1.2.
Wersja 2.1.1.0
- Sprawdzona zgodność z pakietem SDK maio w wersji 2.1.1.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 10.12.0.
- Maio SDK w wersji 2.1.1.
Wersja 2.0.0.0
- Sprawdzona zgodność z pakietem SDK maio w wersji 2.0.0.
- Usunięto zależność od
MaioOB SDK. - Usunięto obsługę architektury
armv7. - Teraz wymaga minimalnej wersji iOS 12.0.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 10.10.0.
- Wersja pakietu Maio SDK 2.0.0.
Wersja 1.6.3.1
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.0.0 lub nowszej.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 10.0.0.
- Pakiet Maio SDK w wersji 1.6.3.
- MaioOB SDK w wersji 2.0.0-alpha.
Wersja 1.6.3.0
- Zaktualizowano adapter, aby korzystał z interfejsu API
didRewardUser. - Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 9.8.0 lub nowszej.
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.6.3 i pakietem SDK maioOB w wersji 2.0.0-alpha.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 9.12.0.
- Pakiet Maio SDK w wersji 1.6.3.
- MaioOB SDK w wersji 2.0.0-alpha.
Wersja 1.6.2.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.6.2 i pakietem SDK maioOB w wersji 2.0.0-alpha.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 9.5.0.
- Maio SDK w wersji 1.6.2.
- MaioOB SDK w wersji 2.0.0-alpha.
Wersja 1.6.1.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.6.1 i pakietem SDK maioOB w wersji 2.0.0-alpha.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 9.2.0.
- Maio SDK w wersji 1.6.1.
- MaioOB SDK w wersji 2.0.0-alpha.
Wersja 1.6.0.1
- Sprawdzona zgodność 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.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 9.0.0.
- Maio SDK w wersji 1.6.0.
- MaioOB SDK w wersji 2.0.0-alpha.
Wersja 1.6.0.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.6.0 i pakietem SDK maioOB w wersji 2.0.0-alpha.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 8.13.0.
- Teraz wymaga minimalnej wersji iOS 10.0.
- Maio SDK w wersji 1.6.0.
- MaioOB SDK w wersji 2.0.0-alpha.
Wersja 1.5.8.0
- Zweryfikowana 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ą.
- Zmniejszyliśmy zależność od pakietu SDK do reklam mobilnych Google w wersji 8.0.0 lub nowszej.
Zbudowano i przetestowano przy użyciu:
- 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-alpha.
Wersja 1.5.6.1
- Dodano standardowe kody błędów i komunikaty o błędach dotyczące adapterów.
- Zaktualizowano adapter, aby używał formatu
.xcframework. - Naprawiliśmy błąd, który powodował, że czasami nie przekazywano zdarzeń związanych z reklamami z nagrodą.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 8.3.0 lub nowszej.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 8.3.0.
- Maio SDK w wersji 1.5.6.
Wersja 1.5.6.0
- Zweryfikowana 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.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 7.68.0.
- Maio SDK w wersji 1.5.6.
Wersja 1.5.5.0
- Zweryfikowana 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.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 7.64.0.
- Maio SDK w wersji 1.5.5.
Wersja 1.5.4.0
- Zweryfikowana 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.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 7.60.0.
- Pakiet SDK Maio w wersji 1.5.4.
Wersja 1.5.3.1
- Aby ograniczyć przekroczenia limitu czasu, żądania reklamy będą teraz natychmiast kończyć się niepowodzeniem, jeśli maio nie ma gotowej do wyświetlenia reklamy.
- Wycofano obsługę architektury i386.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 7.58.0.
- Pakiet Maio SDK w wersji 1.5.3.
Wersja 1.5.3.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.5.3.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 7.55.1.
- Pakiet Maio SDK w wersji 1.5.3.
Wersja 1.5.2.1
- Rozwiązaliśmy problem polegający na tym, że adapter nie wywoływał wywołania zwrotnego
-rewardedAdDidPresent:.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 7.53.1.
- Pakiet Maio SDK w wersji 1.5.2.
Wersja 1.5.2.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.5.2.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 7.53.1.
- Pakiet Maio SDK w wersji 1.5.2.
Wersja 1.5.1.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.5.1.
Zbudowano i przetestowano przy użyciu:
- Pakiet SDK do reklam mobilnych Google w wersji 7.52.0.
- Maio SDK w wersji 1.5.1.
Wersja 1.5.0.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.5.0.
Zaprojektowano i przetestowano z użyciem
- Pakiet SDK do reklam mobilnych Google w wersji 7.51.0.
- Pakiet SDK do wyświetlania reklam Maio w wersji 1.5.0.
Wersja 1.4.8.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.4.8.
Wersja 1.4.6.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.4.6.
- Zaktualizowaliśmy adapter, aby korzystał z nowego interfejsu API reklam z nagrodą.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.42.2 lub nowszej.
Wersja 1.4.2.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.4.2.
Wersja 1.4.1.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.4.1.
- Rozwiązaliśmy problem, który powodował, że adapter maio mógł ulec awarii, jeśli z AdMob otrzymywano wiele identyfikatorów multimediów.
Wersja 1.4.0.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.4.0.
Wersja 1.3.2.0
- Sprawdzona 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
- Sprawdzona zgodność z pakietem SDK maio w wersji 1.3.1.
Wersja 1.3.0.0
- Sprawdzona zgodność z pakietem SDK maio w wersji 1.3.0.
Wersja 1.2.19.0
- Sprawdzona 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ą.