Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z witryny Maio za pomocą zapośredniczenia w zakresie integracji kaskady. Opisano w nim, jak dodać maio do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter maio z aplikacjąiOS .
Etykiety, przyciski i opisy w interfejsie panelu maio w języku japońskim, a zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku odniesienia do etykiet i przycisków odnoszą się jednak do ich angielskich odpowiedników. np. „URL” („Schemat URL”) i tak dalej.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia AdMob dla Maio udostępnia te możliwości:
Integracja | |
---|---|
Ustalanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Otrzymano | |
Natywna |
Wymagania
- Wartość docelowa wdrożenia iOS w wersji 12.0 lub nowszej
- [Na potrzeby określania stawek]: adapter maio 1.5.8.0 lub nowszy (zalecana najnowsza wersja)
Najnowszy pakiet SDK do reklam mobilnych Google
Skorzystaj z zapośredniczenia Wprowadzenie
Krok 1. Skonfiguruj konfiguracje w interfejsie maio
Najpierw zarejestruj się lub zaloguj na swoje konto maio. Kliknij przycisk Zarządzanie aplikacjami na lewym pasku bocznym i wybierz Nowa aplikacja.
Wybierz kartę odpowiadającą Twojemu preferowanemu Typowi reklamy.
Pełnoekranowa
Wpisz nazwę swojej aplikacji, wybierz platformę i podaj URL aplikacji. Jako Typ reklamy wybierz Pełnoekranowa reklama wideo i kliknij Zaktualizuj.
Otrzymano
Wpisz nazwę swojej aplikacji, wybierz platformę i podaj URL aplikacji. Jako Typ reklamy wybierz Nagrody wideo i kliknij Zaktualizuj.
Na stronie Zarządzanie aplikacją zanotuj identyfikator mediów. W następnej sekcji musisz skonfigurować AdMob jednostkę reklamową.
Na stronie Zone Management (Zarządzanie strefą) zanotuj Identyfikator strefy. W następnej sekcji musisz też skonfigurować AdMob jednostkę reklamową.
(Tylko kaskada) Aby skonfigurować identyfikator jednostki reklamowej na potrzeby zapośredniczenia, oprócz identyfikatora mediów i identyfikatora strefy będziesz potrzebować identyfikatora interfejsu API i klucza interfejsu API. Na stronie interfejsu API do raportowania zanotuj Identyfikator interfejsu API i KLUCZ API.Krok 2. Skonfiguruj popyt na Maio w AdMob interfejsie użytkownika
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
Ustalanie stawek
Na karcie Określanie stawek w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie kliknij maio.
Kliknij Jak podpisać umowę partnerską i zawrzeć umowę partnerską z firmąmaio.
Kliknij Potwierdzam i akceptuję, a następnie kliknij Dalej.
Jeśli masz już mapowanie maio, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.
Następnie wpisz dane Publisher IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.
Ważne: Media ID musi być powiązany z aplikacją docelową, tak jak w interfejsiemaio .Wodospad
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. Zaimportuj pakiet SDK i adapter maio
Używanie 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 maio.
- Pobierz najnowszą wersję adaptera maio, korzystając z linku do pobierania w historii zmian, i połącz
maioAdapter.framework
w swoim projekcie.
Krok 4. Dodaj wymagany kod
Integracja SKAdNetwork
Wykonaj dokumentację maio, aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu.
Krok 5. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby AdMob.
Wydawcy, którzy korzystają z pakietu SDK do reklam mobilnych Google w wersji 7.26.0 lub nowszej, automatycznie będą otrzymywać w żądaniach reklamy testowe z Maio na telefony i tablety zarejestrowane jako urządzenia testowe.
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynymaio, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z maio (Bidding) and maio (Waterfall) źródeł reklam.
Kody błędów
Jeśli adapter nie otrzyma reklamy z maio, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi na żądanie reklamy, korzystając z elementu
GADResponseInfo.adNetworkInfoArray
w tych zajęciach:
Format | Nazwa zajęć |
---|---|
Pełnoekranowa | GADMMaioInterstitialAdapter |
Otrzymano | GADMMaioRewardedAdapter |
Oto kody i powiązane z nimi wiadomości wysyłane przez adapter maio, gdy nie można wczytać reklamy:
Kod błędu | Przyczyna |
---|---|
0-10 | maio zwróciło błąd związany z pakietem SDK. Więcej informacji znajdziesz w code i dokumentacji maio. |
101 | Maio nie ma dostępnej reklamy. |
102 | Nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego). |
103 | Kontekst użyty do wczytania reklamy nie był instancją „Activity”. |
0-10 | maio zwróciło błąd związany z pakietem SDK. Więcej informacji znajdziesz w kodzie 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 żądanego formatu reklamy. |
104 | Reklama dla tej konfiguracji sieci została już wczytana. |
Historia zmian adaptera zapośredniczenia na iOS maio
Wersja 2.1.3.0
- Zweryfikowana zgodność z pakietem maio SDK w wersji 2.1.3.
Stworzone i przetestowane w:
- 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ędniono
Info.plist
w ramach platformyMaioAdapter.xcframework
.
Stworzone i przetestowane w:
- 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 maio SDK w wersji 2.1.2.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
- Maio SDK w wersji 2.1.2.
Wersja 2.1.1.0
- Zweryfikowana zgodność z pakietem maio SDK w wersji 2.1.1.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 10.12.0.
- Maio SDK w wersji 2.1.1.
Wersja 2.0.0.0
- Zweryfikowana zgodność z pakietem maio SDK w wersji 2.0.0.
- Usunięto zależność
MaioOB SDK
. - Usunięto obsługę architektury
armv7
. - Teraz wymagany jest iOS w wersji co najmniej 12.0.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.
Stworzone i przetestowane w:
- 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.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 10.0.0.
- Maio SDK w wersji 1.6.3.
- Pakiet SDK MaioOB w wersji 2.0.0-alfa.
Wersja 1.6.3.0
- Zaktualizowano adapter, aby używał interfejsu
didRewardUser
API. - Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 9.8.0 lub nowszej.
- Zweryfikowana zgodność z pakietem maio SDK w wersji 1.6.3 oraz pakietem maioOB w wersji 2.0.0-alfa.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 9.12.0.
- Maio SDK w wersji 1.6.3.
- Pakiet SDK MaioOB w wersji 2.0.0-alfa.
Wersja 1.6.2.0
- Zweryfikowana zgodność z pakietem maio SDK w wersji 1.6.2 oraz pakietem maioOB w wersji 2.0.0-alfa.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 9.5.0.
- Maio SDK w wersji 1.6.2.
- Pakiet SDK MaioOB w wersji 2.0.0-alfa.
Wersja 1.6.1.0
- Zweryfikowana zgodność z pakietem maio SDK w wersji 1.6.1 oraz pakietem maioOB w wersji 2.0.0-alfa.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 9.2.0.
- Maio SDK w wersji 1.6.1.
- Pakiet SDK MaioOB w wersji 2.0.0-alfa.
Wersja 1.6.0.1
- Zweryfikowana 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.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 9.0.0.
- Maio SDK w wersji 1.6.0.
- Pakiet SDK MaioOB w wersji 2.0.0-alfa.
Wersja 1.6.0.0
- Zweryfikowana zgodność z pakietem maio SDK w wersji 1.6.0 oraz pakietem maioOB w wersji 2.0.0-alfa.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 8.13.0.
- Teraz wymagany jest iOS w wersji co najmniej 10.0.
- Maio SDK w wersji 1.6.0.
- Pakiet SDK MaioOB w wersji 2.0.0-alfa.
Wersja 1.5.8.0
- Zweryfikowana zgodność z pakietem maio SDK w wersji 1.5.8 oraz pakietem maioOB w wersji 2.0.0-alfa.
- Dodaliśmy możliwość określania stawek w adapterze formatów reklam pełnoekranowych i reklam z nagrodą.
- proste zależności od pakietu SDK do reklam mobilnych Google w wersji 8.0.0 lub nowszej.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 8.7.0.
- Maio SDK w wersji 1.5.8.
- Pakiet SDK MaioOB w wersji 2.0.0-alfa.
Wersja 1.5.6.1
- Dodaliśmy standardowe kody błędów i komunikaty o błędach adaptera.
- Zaktualizowano adapter, aby używać formatu
.xcframework
. - Naprawiono błąd, który powodował, że zdarzenia reklamy z nagrodą czasami nie były przekierowywane.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 8.3.0 lub nowszej.
Stworzone i przetestowane w:
- 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 maio SDK w wersji 1.5.6.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.68.0 lub nowszej.
Stworzone i przetestowane w:
- 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 maio SDK w wersji 1.5.5.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.64.0 lub nowszej.
Stworzone i przetestowane w:
- 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 maio SDK w wersji 1.5.4.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.60.0 lub nowszej.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 7.60.0.
- Maio SDK w wersji 1.5.4.
Wersja 1.5.3.1
- Aby ograniczyć limity czasu oczekiwania, żądania reklamy będą teraz kończyć się niepowodzeniem, jeśli maio nie ma reklamy gotowej do wyświetlenia.
- Usunięto obsługę architektury i386.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 7.58.0.
- Maio SDK w wersji 1.5.3.
Wersja 1.5.3.0
- Zweryfikowana zgodność z pakietem maio SDK w wersji 1.5.3.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 7.55.1.
- Maio SDK w wersji 1.5.3.
Wersja 1.5.2.1
- Rozwiązaliśmy problem, który powodował, że adapter nie wywoływał wywołania zwrotnego
-rewardedAdDidPresent:
.
Stworzone i przetestowane w:
- 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 maio SDK w wersji 1.5.2.
Stworzone i przetestowane w:
- 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 maio SDK w wersji 1.5.1.
Stworzone i przetestowane w:
- 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 maio SDK w wersji 1.5.0.
Stworzone i przetestowane
- 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
- Zweryfikowana zgodność z pakietem maio SDK w wersji 1.4.8.
Wersja 1.4.6.0
- Zweryfikowana zgodność z pakietem maio SDK w wersji 1.4.6.
- Zaktualizowano adapter, aby korzystać z nowego interfejsu API z nagrodami.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.42.2 lub nowszej.
Wersja 1.4.2.0
- Zweryfikowana zgodność z pakietem maio SDK w wersji 1.4.2.
Wersja 1.4.1.0
- Zweryfikowana zgodność z pakietem maio SDK w wersji 1.4.1.
- Rozwiązaliśmy problem, który powodował, że adapter maio może działać nieprawidłowo, jeśli podano wiele identyfikatorów MediaId z AdMob.
Wersja 1.4.0.0
- Zweryfikowana zgodność z pakietem maio SDK w wersji 1.4.0.
Wersja 1.3.2.0
- Zweryfikowana zgodność z pakietem maio SDK w wersji 1.3.2.
Wersja 1.3.1.1
- Dodano wywołanie zwrotne
adapterDidCompletePlayingRewardBasedVideoAd:
do adaptera.
Wersja 1.3.1.0
- Zweryfikowana zgodność z pakietem maio SDK w wersji 1.3.1.
Wersja 1.3.0.0
- Zweryfikowana zgodność z pakietem maio SDK w wersji 1.3.0.
Wersja 1.2.19.0
- Zweryfikowana zgodność z pakietem maio SDK w wersji 1.2.19.
Wersja 1.2.18.0
- Pierwsza wersja!
- Dodaliśmy obsługę pełnoekranowych reklam i reklam wideo z nagrodą.