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 maio przy użyciu mediacji AdMob. Wyjaśnia, jak dodać maio do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter maio z aplikacją na iOS.

Interfejs panelu platformy maio używa tekstu w języku japońskim w przypadku etykiet, przycisków i opisów, a zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak podawane w języku angielskim. „URL スキーム” to na przykład „URL Scheme”.

Obsługiwane integracje i formaty reklam

Adapter do 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 12.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 Zaktualizuj.

Z nagrodą

Wpisz nazwę aplikacji, wybierz platformę i podaj adres URL aplikacji. Jako Typ reklamy wybierz Reklamy wideo z nagrodą, a potem kliknij Zaktualizuj.

Na stronie Zarządzanie aplikacjami zanotuj identyfikator multimediów. Jest to potrzebne do skonfigurowania jednostki reklamowej AdMob w następnej sekcji.

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

(Tylko kaskadowe) Oprócz identyfikatora multimediów i identyfikatora strefy do skonfigurowania identyfikatora jednostki reklamowej na potrzeby zapośredniczenia potrzebne będą identyfikator interfejsu API i KLUCZ INTERFEJSU API. Na stronie interfejsu API do raportowania zanotuj identyfikator API i klucz 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 mediacji 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.

Na karcie Jednostki reklamowe powinny się teraz wyświetlać wybrane przez Ciebie jednostki reklamowe:

Dodawanie maio jako źródła reklam


Na karcie Kaskadowe 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 API i klucz 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ów i identyfikator strefy uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.


Krok 3. Zaimportuj pakiet SDK i adapter maio

  • 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

Integracja z 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 SDK do reklam mobilnych Google w wersji 7.26.0 lub nowszej będą automatycznie otrzymywać z maio reklamy testowe 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 w inspektorze reklam testowanie pojedynczego źródła reklam za pomocą źródła reklam maio (kaskadowe).

Kody błędów

Jeśli adapter nie otrzyma reklamy z maio, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na reklamę, 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 usługi 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 przypadku tej konfiguracji sieci.

Historia zmian adaptera zapośredniczenia maio na iOS

Następna wersja

  • Włącz opcje -fobjc-arc i -fstack-protector-all.

Wersja 2.1.6.1

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

Zaprojektowano i przetestowano 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.

Zaprojektowano i przetestowano 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.

Zaprojektowano i przetestowano 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.

Zaprojektowano i przetestowano 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.

Zaprojektowano i przetestowano 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

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

Zaprojektowano i przetestowano 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ędnij Info.plist w platformach w ramach MaioAdapter.xcframework.

Zaprojektowano i przetestowano 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

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

Zaprojektowano i przetestowano 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.

Zaprojektowano i przetestowano 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.
  • Teraz wymaga minimalnej wersji iOS 12.0.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.6.3.1

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

Zaprojektowano i przetestowano 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.

Zaprojektowano i przetestowano 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.

Zaprojektowano i przetestowano 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.

Zaprojektowano i przetestowano 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.

Zaprojektowano i przetestowano 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.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 8.13.0.
  • Teraz wymaga minimalnej wersji iOS 10.0.
  • Maio SDK w wersji 1.6.0.
  • MaioOB SDK w wersji 2.0.0-alpha.

Wersja 1.5.8.0

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

Zaprojektowano i przetestowano 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 adaptera.
  • Zaktualizowano adapter, aby używał formatu .xcframework.
  • Naprawiliśmy błąd, który powodował, że czasami nie były przekazywane zdarzenia związane z reklamami z nagrodą.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 8.3.0 lub nowszej.

Zaprojektowano i przetestowano 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.

Zaprojektowano i przetestowano 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.

Zaprojektowano i przetestowano 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.

Zaprojektowano i przetestowano 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 maio nie ma gotowej do wyświetlenia reklamy.
  • Wycofano obsługę architektury i386.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 7.58.0.
  • Pakiet Maio SDK w wersji 1.5.3.

Wersja 1.5.3.0

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

Zaprojektowano i przetestowano z użyciem:

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

Zaprojektowano i przetestowano z użyciem:

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

Zaprojektowano i przetestowano z użyciem:

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

Zaprojektowano i przetestowano 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 otrzymywał 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ą.