Integracja Maio z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam w Maio za pomocą zapośredniczenia AdMob, obejmujących integracje kaskadowe. Dowiesz się z niego, jak dodać maio do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter maio z aplikacją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 „Schemat URL”.

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

• Najnowszy pakiet SDK do reklam mobilnych Google

• Wykonaj zapośredniczenie Przewodnik 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.

Uwaga: reklamy pełnoekranowe z maia są domyślnie możliwe do pominięcia.

Z nagrodą

Wpisz nazwę aplikacji, wybierz platformę i podaj adres URL aplikacji. Jako Typ reklamy wybierz Nagrody wideo, a potem kliknij Aktualizuj.

Uwaga: domyślnie reklam wideo z nagrodą w Maio NIE można pominąć.

Zanotuj identyfikator multimediów na stronie Zarządzanie aplikacjami. W następnej sekcji musisz skonfigurować jednostkę reklamową AdMob.

Na stronie Zarządzanie strefami zanotuj identyfikator strefy. Będzie ona też potrzebna do skonfigurowania jednostki reklamowej AdMob w następnym rozdziale.

(Tylko w przypadku wodospadu) Oprócz identyfikatora mediów i identyfikatora strefy potrzebne są identyfikator interfejsu API i klucz interfejsu API, by skonfigurować identyfikator jednostki reklamowej na potrzeby zapośredniczenia. Na stronie interfejsu API do raportowania zapisz identyfikator interfejsu API i klucz interfejsu API.

Uwaga: (dotyczy tylko metody kaskadowej) jeśli po raz pierwszy konfigurujesz konto maio, musisz skontaktować się z zespołem pomocy tej usługi, aby uzyskać identyfikator API i klucz API.

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.

Uwaga: optymalizację źródeł reklam musisz skonfigurować tylko raz dla każdej sieci.

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.

Ważne: Media ID musi być powiązany z aplikacją docelową, tak jak wmaio interfejsie.

Uwaga: optymalizacja źródła reklam potrzebuje kilku dni na zebranie wystarczającej ilości danych do dokładnego obliczenia eCPM dla sieci zapośredniczenia. Tymczasem stan optymalizacji źródła reklam to PENDING, więc musisz ręcznie ustawić wartość eCPM w sieci. Gdy można już obliczyć eCPM, źródło reklam zacznie je automatycznie aktualizować w Twoim imieniu.

Krok 3. Importuj pakiet SDK i adapter maio

Uwaga: brak integracji zgodnych wersji pakietu SDK do reklam mobilnych Google i MAio może spowodować problemy z kompilacją.

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ę 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

Postępuj zgodnie z 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.

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy AdMob imaio .

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 (Waterfall) źródeł reklam.

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 towarzyszące im komunikaty wysyłane przez adapter Maio, gdy nie uda się wczytać reklamy:

Kod błędu	Przyczyna
0-10	Aplikacja maio zwróciła błąd pakietu 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.

Zaprojektowane i przetestowane:

• 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.
• Maio SDK w wersji 2.1.5.

Wersja 2.1.4.0

• Zweryfikowano zgodność z pakietem SDK Maio w wersji 2.1.4.

Zaprojektowane i przetestowane:

• Pakiet SDK do reklam mobilnych Google w wersji 11.2.0.
• Maio SDK w wersji 2.1.4.

Wersja 2.1.3.0

• Weryfikowana zgodność z pakietem SDK maio w wersji 2.1.3.

Zaprojektowane i przetestowane:

• 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 ramach MaioAdapter.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

• Zweryfikowano zgodność z pakietem SDK Maio w wersji 2.1.2.

Został opracowany i przetestowany z:

• 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.
• Maio SDK w wersji 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 wymaga to systemu iOS w wersji co najmniej 12.0.
• 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.
• 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.

Został opracowany i przetestowany z:

• Pakiet SDK do reklam mobilnych Google w wersji 10.0.0.
• Wersja pakietu SDK Maio: 1.6.3.
• MaioOB SDK w wersji 2.0.0-alfa.

Wersja 1.6.3.0

• Zaktualizowano adapter, aby korzystał z interfejsu didRewardUser API.
• Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 9.8.0 lub nowszej.
• Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.6.3 i pakietem SDK MaioOB w wersji 2.0.0-alfa.

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

• Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.6.2 i pakietem SDK MaioOB w wersji 2.0.0-alfa.

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

• Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.6.1 i pakietem SDK MaioOB w wersji 2.0.0-alfa.

Został opracowany i przetestowany z:

• 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-alpha.

Wersja 1.6.0.1

• Zweryfikowano 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.

Zaprojektowane i przetestowane:

• Pakiet SDK do reklam mobilnych Google w wersji 9.0.0.
• Wersja pakietu SDK Maio: 1.6.0.
• MaioOB SDK w wersji 2.0.0-alfa.

Wersja 1.6.0.0

• Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.6.0 i pakietem SDK MaioOB w wersji 2.0.0-alfa.

Został opracowany i przetestowany z:

• Pakiet SDK do reklam mobilnych Google w wersji 8.13.0.
• Teraz wymaga to systemu iOS w wersji co najmniej 10.0.
• Maio SDK w wersji 1.6.0.
• MaioOB SDK w wersji 2.0.0-alfa.

Wersja 1.5.8.0

• Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.5.8 i pakietem SDK 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ą.
• Łagodzenie uzależnienia od pakietu SDK do reklam mobilnych Google w wersji 8.0.0 lub nowszej.

Zaprojektowane i przetestowane:

• 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

• Dodaliśmy ujednolicone kody błędów i komunikaty o błędach 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ą.
• Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 8.3.0 lub nowszej.

Został opracowany i przetestowany z:

• Pakiet SDK do reklam mobilnych Google w wersji 8.3.0.
• Wersja pakietu SDK Maio: 1.5.6.

Wersja 1.5.6.0

• Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.5.6.
• Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 7.68.0 lub nowszej.

Zaprojektowane i przetestowane:

• 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.
• Teraz wymaga 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.
• Maio SDK w wersji 1.5.4.

Wersja 1.5.3.1

• Aby ograniczyć czasy oczekiwania, żądania reklamy będą teraz natychmiast kończyć się niepowodzeniem, jeśli maio nie ma reklamy gotowej do wyświetlenia.
• Zakończyliśmy 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

• Zweryfikowano 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:.

Zaprojektowane i przetestowane:

• Pakiet SDK do reklam mobilnych Google w wersji 7.53.1.
• Maio SDK w wersji 1.5.2.

Wersja 1.5.2.0

• Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.5.2.

Zaprojektowane i przetestowane:

• 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.

Zaprojektowane i przetestowane:

• 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.

Stworzone i przetestowane przy użyciu

• 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.
• Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 7.42.2 lub nowszej.

Wersja 1.4.2.0

• Zweryfikowano 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 w AdMob podano wiele identyfikatorów MediaId.

Wersja 1.4.0.0

• Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.4.0.

Wersja 1.3.2.0

• Zweryfikowano 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

• Zweryfikowano zgodność z pakietem SDK maio w wersji 1.2.19.

Wersja 1.2.18.0

• Pierwsza wersja!
• Dodaliśmy obsługę pełnoekranowych reklam wideo z nagrodą.