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, a także jak przeprowadzać integrację kaskadową. 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 do 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 zapośredniczenia.
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 następnie kliknij Aktualizuj.
Na stronie Application Management (Zarządzanie aplikacjami) zanotuj Media ID (Identyfikator multimediów). Jest on potrzebny do skonfigurowania jednostki reklamowej Ad Managera w następnej sekcji.
Na stronie Zarządzanie strefami zanotuj Identyfikator strefy. Będzie ona też potrzebna do skonfigurowania jednostki reklamowej Ad Managera w następnej sekcji.
Krok 2. Skonfiguruj popyt na platformie maio w interfejsie Ad Managera
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Zaloguj się na konto Ad Managera.
Kliknij kolejno Wyświetlanie > Grupy zysku i przycisk Nowa grupa zysku.
Wpisz unikalną nazwę grupy zysku, ustaw stan na Aktywny, wybierz format reklamy i ustaw typ zasobów reklamowych na Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w obszarach 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 przypadku maio, możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.
Wybierz maio jako sieć reklamową, wpisz unikalną nazwę i włącz zapośredniczanie.
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 Rodzaj integracji, iOS jako Platformę i Aktywny jako Stan. Wpisz identyfikator multimediów i identyfikator strefy uzyskane w poprzedniej sekcji. Następnie wpisz wartość Domyślna stawka CPM.
Gdy skończysz, u dołu strony kliknij Zapisz.
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.framework
w projekcie.
Krok 4. Dodaj wymagany kod
Integracja z 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 Ad Managerze.
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 w inspektorze reklam testowanie pojedynczego źródła reklam za pomocą źródła 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
Następna wersja
- Włącz opcje -fobjc-arc i -fstack-protector-all.
Wersja 2.1.6.1
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 12.0.0 lub nowszej.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- 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.plist
w platformach w ramachMaioAdapter.xcframework
.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 10.10.0.
- Maio SDK w wersji 2.0.0.
Wersja 1.6.3.1
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.0.0 lub nowszej.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- 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.
- Dodaliśmy 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.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 7.60.0.
- Pakiet Maio SDK 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.
Zaprojektowano i przetestowano z użyciem:
- 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.
Zaprojektowano i przetestowano z użyciem:
- 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:
.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 7.53.1.
- Maio SDK w wersji 1.5.2.
Wersja 1.5.2.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.5.2.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 7.53.1.
- Maio SDK w wersji 1.5.2.
Wersja 1.5.1.0
- Zweryfikowana zgodność z pakietem SDK maio w wersji 1.5.1.
Zaprojektowano i przetestowano z użyciem:
- 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ą.