Integracja Maio z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads SDK wczytywać i wyświetlać reklamy z maio przy użyciu zapośredniczenia AdMob, w tym integracji kaskadowych. Wyjaśnia, jak dodać maio do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter maio z aplikacją na iOS.

Interfejs panelu w maio używa japońskiego tekstu w etykietach, przyciskach i opisach, a zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak podane w języku angielskim. Na przykład „URL スキーム” to „URL Scheme”.

Obsługiwane integracje i formaty reklam

Adapter 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 13.0 lub nowszej.

Krok 1. Skonfiguruj ustawienia w interfejsie maio

Najpierw zarejestruj się lub zaloguj na swoje 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 potem kliknij Aktualizuj.

Na stronie Zarządzanie aplikacjami zanotuj identyfikator wydawcy. Będzie on potrzebny do skonfigurowania jednostki reklamowej AdMob w następnej sekcji.

Na stronie Zarządzanie strefami zanotuj identyfikator strefy. Będzie on potrzebny do skonfigurowania jednostki reklamowej AdMob w następnej sekcji.

(Tylko kaskadowe) Oprócz identyfikatora multimediówidentyfikatora strefy do skonfigurowania identyfikatora jednostki reklamowej na potrzeby zapośredniczenia potrzebne będą identyfikator interfejsu APIKLUCZ INTERFEJSU API. Na stronie interfejsu API do raportowania zanotuj identyfikator APIklucz API.

Krok 2. Skonfiguruj popyt z maio w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać maio do konfiguracji mediacji w przypadku jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediacja. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie maio jako źródła 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, 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ą z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Powinna się teraz wyświetlić karta jednostek reklamowych z wybranymi przez Ciebie jednostkami:

Dodawanie maio jako źródła reklam


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

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



Jeśli masz już mapowanie dla maio, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz identyfikator multimediówidentyfikator strefy uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.


Krok 3. Zaimportuj pakiet SDK i adapter maio

Używanie menedżera pakietów Swift

Zanim przejdziesz dalej, musisz mieć minimalną obsługiwaną wersję adaptera 2.2.0.0.

Aby dodać zależność pakietu do projektu, wykonaj te czynności:

  1. W Xcode kliknij File > Add Package Dependencies... (Plik > Dodaj zależności pakietu…).

  2. W wyświetlonym wierszu poleceń wyszukaj ten adres URL pakietu:

    https://github.com/googleads/googleads-mobile-ios-mediation-maio.git
    
  3. W sekcji Reguła zależności wybierz Gałąź.

  4. W polu tekstowym wpisz main.

Korzystanie z CocoaPods

  • 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

Wdrażanie 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 AdMob.

Wydawcy korzystający z pakietu Google Mobile Ads SDK w wersji 7.26.0 lub nowszej 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ódeł reklam maio (kaskadowe).

Kody błędów

Jeśli adapter nie otrzyma reklamy z maio, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, 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 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 tej konfiguracji sieci.
105 Filtruj żądania objęte ograniczeniami wiekowymi w przypadku pakietu SDK maio, ponieważ nie może on odbierać sygnałów dotyczących ograniczeń wiekowych.

Historia zmian adaptera zapośredniczenia maio na iOS

Następna wersja

  • Zaktualizuj minimalną wersję iOS, aby zmniejszyć zależność od pakietu SDK do reklam mobilnych Google i umożliwić korzystanie z wersji podrzędnych.

Wersja 2.2.1.2

  • Filtruj żądania ograniczone ze względu na wiek w przypadku pakietu SDK maio, gdy nowy parametr ageRestrictedTreatment ma wartość GADAgeRestrictedTreatmentChild.

Zaprojektowane i przetestowane z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 13.3.0.
  • Maio SDK w wersji 2.2.1.

Wersja 2.2.1.1

  • Filtruj żądania objęte ograniczeniami wiekowymi w przypadku pakietu SDK maio, ponieważ nie może on odbierać sygnałów dotyczących ograniczeń wiekowych.

Zaprojektowane i przetestowane z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 13.2.0.
  • Maio SDK w wersji 2.2.1.

Wersja 2.2.1.0

  • Zweryfikowana zgodność z pakietem SDK maio w wersji 2.2.1.

Zaprojektowane i przetestowane z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 13.1.0.
  • Maio SDK w wersji 2.2.1.

Wersja 2.2.0.3

  • Dodaliśmy obsługę kaskadowych reklam banerowych.
  • Zaktualizowano zależność pakietu SDK do reklam mobilnych Google do wersji 13.0.0.

Zaprojektowane i przetestowane z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 13.0.0.
  • Maio SDK w wersji 2.2.0.

Wersja 2.2.0.2

  • Zaktualizowano minimalną wersję iOS dla CocoaPods do 13.0.

Zaprojektowane i przetestowane z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 13.0.0.
  • Maio SDK w wersji 2.2.0.

Wersja 2.2.0.1

  • Usunięto implementację ustalania stawek, ponieważ Maio nie obsługuje już ustalania stawek.
  • Zaktualizuj adapter, aby używać protokołu GADMediationAdapter.

Zaprojektowane i przetestowane z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 12.11.0.
  • Maio SDK w wersji 2.2.0.

Wersja 2.2.0.0

  • Zweryfikowana zgodność z pakietem SDK maio w wersji 2.2.0.

Zaprojektowane i przetestowane z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 12.11.0.
  • Maio SDK w wersji 2.2.0.

Wersja 2.1.6.1

  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 12.0.0 lub nowszej.

Zaprojektowane i przetestowane 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.

Zaprojektowane i przetestowane 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.

Zaprojektowane i przetestowane 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.

Zaprojektowane i przetestowane 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.

Zaprojektowane i przetestowane 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

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

Zaprojektowane i przetestowane 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ędniono Info.plist w platformach w ramach MaioAdapter.xcframework.

Zaprojektowane i przetestowane 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

  • Sprawdzona zgodność z pakietem SDK maio w wersji 2.1.2.

Zaprojektowane i przetestowane 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.

Zaprojektowane i przetestowane 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.
  • Wymaga teraz co najmniej iOS w wersji 12.0.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.

Zaprojektowane i przetestowane z użyciem:

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

Zaprojektowane i przetestowane 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.

Zaprojektowane i przetestowane 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.

Zaprojektowane i przetestowane 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.

Zaprojektowane i przetestowane 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.

Zaprojektowane i przetestowane 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.

Zaprojektowane i przetestowane z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 8.13.0.
  • Wymaga teraz systemu iOS w wersji co najmniej 10.0.
  • Maio SDK w wersji 1.6.0.
  • MaioOB SDK w wersji 2.0.0-alpha.

Wersja 1.5.8.0

  • Sprawdzona 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ą.
  • Zmniejszono zależność od pakietu SDK do reklam mobilnych Google w wersji 8.0.0 lub nowszej.

Zaprojektowane i przetestowane 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.

Zaprojektowane i przetestowane 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.

Zaprojektowane i przetestowane 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.

Zaprojektowane i przetestowane 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.

Zaprojektowane i przetestowane 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 platforma MAIO nie będzie miała gotowej do wyświetlenia reklamy.
  • Wycofano obsługę architektury i386.

Zaprojektowane i przetestowane z użyciem:

  • 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 SDK maio w wersji 1.5.3.

Zaprojektowane i przetestowane z użyciem:

  • 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 polegający na tym, że adapter nie wywoływał wywołania zwrotnego -rewardedAdDidPresent:.

Zaprojektowane i przetestowane z użyciem:

  • Wersja pakietu SDK do reklam mobilnych Google 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.

Zaprojektowane i przetestowane z użyciem:

  • Wersja pakietu SDK do reklam mobilnych Google 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.

Zaprojektowane i przetestowane 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 przesłano 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ą.