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 obejmującego integrację kaskadową. Dowiesz się z niego, 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 są zapisane w języku japońskim. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku jednak nazwy etykiet i przycisków mają swoje odpowiedniki w języku angielskim. Na przykład „URL 조ーム” to „Schemat URL” itd.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob do Maio:

Integracja
Ustalanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Otrzymano
Natywna

Wymagania

  • Cel wdrożenia iOS w wersji 12.0 lub nowszej
  • [Do określania stawek]: adapter maio w wersji 1.5.8.0 lub nowszej (zalecana najnowsza wersja)

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 żądania reklam 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

  • 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 z linku do pobierania w dzienniku zmian i dodaj link maioAdapter.framework w swoim 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łą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 od Maio, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi za pomocą polecenia GADResponseInfo.adNetworkInfoArray w tych klasach:

Format Nazwa zajęć
Pełnoekranowa GADMMaioInterstitialAdapter
Otrzymano 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 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 Aplikacja maio zwróciła błąd pakietu 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 została już wczytana na potrzeby tej konfiguracji sieci.

Historia zmian adaptera zapośredniczenia iOS maio

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

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

  • Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 11.0 lub nowszej.
  • Uwzględniono Info.plist w platformach MaioAdapter.xcframework.

Zaprojektowane i przetestowane:

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

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
  • Maio SDK w wersji 2.1.2.

Wersja 2.1.1.0

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

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 10.12.0.
  • Maio SDK w wersji 2.1.1.

Wersja 2.0.0.0

  • Zweryfikowano zgodność z pakietem SDK Maio w wersji 2.0.0.
  • Zależność od MaioOB SDK została usunięta.
  • Usunięto obsługę architektury armv7.
  • Teraz wymaga to systemu iOS w wersji co najmniej 12.0.
  • Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 10.10.0.
  • Maio SDK w wersji 2.0.0.

Wersja 1.6.3.1

  • Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 10.0.0 lub nowszej.

Zaprojektowane i przetestowane:

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

Wersja 1.6.3.0

  • Zaktualizowano adapter, aby używał interfejsu API didRewardUser.
  • 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.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 9.12.0.
  • Maio SDK w wersji 1.6.3.
  • MaioOB SDK w wersji 2.0.0-alfa.

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.

Zaprojektowane i przetestowane:

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

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.

Zaprojektowane i przetestowane:

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

Wersja 1.6.0.1

  • Zweryfikowano zgodność z pakietem SDK do reklam mobilnych Google w wersji 9.0.0.
  • Teraz wymaga 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.
  • Maio SDK w wersji 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.

Zaprojektowane i przetestowane:

  • 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.
  • Maio SDK w wersji 1.5.8.
  • MaioOB SDK w wersji 2.0.0-alfa.

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 zdarzenia reklamy z nagrodą czasem nie były przekazywane.
  • Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 8.3.0 lub nowszej.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 8.3.0.
  • Maio SDK w wersji 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.
  • Maio SDK w wersji 1.5.6.

Wersja 1.5.5.0

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

Zaprojektowane i przetestowane:

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

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 7.58.0.
  • Maio SDK w wersji 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.
  • 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:.

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

Wersja 1.4.8.0

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

Wersja 1.4.6.0

  • Zweryfikowano zgodność z pakietem SDK Maio w wersji 1.4.6.
  • Zaktualizowano adapter, aby używał nowego interfejsu API z nagrodą.
  • 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

  • Zweryfikowano 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 wywołanie zwrotne adapterDidCompletePlayingRewardBasedVideoAd: do adaptera.

Wersja 1.3.1.0

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

Wersja 1.3.0.0

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