Integracja Maio z zapośredniczeniem

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 AdMob, uwzględniając integracje kaskadowe. 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

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 kroku musisz skonfigurować jednostkę reklamową AdMob.

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

(Tylko kaskada) Aby skonfigurować identyfikator jednostki reklamowej na potrzeby zapośredniczenia, oprócz identyfikatora multimediówidentyfikatora strefy musisz podać identyfikator APIklucz API. Na stronie interfejsu API do raportowania zanotuj identyfikator APIklucz API.

Krok 2. Skonfiguruj popyt maio w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać maio do konfiguracji pośrednictwa dla danej jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediation (Mediacja). Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, a potem przejdź do sekcji Dodaj maio jako źródło 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 docelowe. Następnie ustaw stan grupy zapośredniczenia na Włączona, a potem kliknij Dodaj jednostki reklamowe.

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

Powinna się teraz wyświetlić karta Jednostki reklamowe z wybranymi przez Ciebie jednostkami reklamowymi:

Dodawanie maio jako źródła reklam


Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie kliknij maio.

Wybierz maio i włącz przełącznik Optymalizuj. Aby skonfigurować optymalizację źródła reklam dla maio, wpisz identyfikator API i klucz API uzyskane w poprzedniej sekcji. Następnie wpisz wartość eCPM dla mai.io i kliknij Dalej.



Jeśli masz już mapowanie dla konta mai., 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. Importuj pakiet SDK i adapter maio

  • 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

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob.

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 ramowych MaioAdapter.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ą.