Integracja Maio z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads SDK do wczytywania i wyświetlania reklam z maio za pomocą zapośredniczenia, w tym integracji kaskadowych. Dowiesz się z niego, jak dodać maio do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter maio z aplikacją na iOS.

Interfejs panelu maio zawiera japońskie etykiety, przyciski i opisy, a zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak określane za pomocą ich angielskich odpowiedników. Na przykład „URL スキーム” to „URL Scheme” (schemat URI adresu URL).

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia maio ma te możliwości:

Integracja
Określanie stawek
Kaskada
Formaty
Baner
Pełnoekranowa
Z nagrodą
Natywna

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź, czy:

  • iOS w wersji 15.0 lub nowszej.

Krok 1. Skonfiguruj ustawienia w interfejsie maio

Najpierw zarejestruj się lub zaloguj się na 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 Pełnoekranowa reklama wideo, a potem 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 zapisz identyfikator multimediów. Będzie on potrzebny do skonfigurowania jednostki reklamowej Ad Managera w następnej sekcji.

Na stronie Zone Management (Zarządzanie strefą) zanotuj Zone ID (Identyfikator strefy). Będzie on też potrzebny do skonfigurowania jednostki reklamowej Ad Managera w następnej sekcji.

(Tylko kaskada) 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 żądania maio w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij kolejno Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku.

Wpisz unikalną nazwę grupy zysku, ustaw stan na aktywny, wybierz format reklamy i ustaw typ zasobów reklamowych na aplikację mobilną. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcji Zasoby reklamowe i aplikację mobilną, do której chcesz dodać zapośredniczenie.

Następnie kliknij przycisk Dodaj partnera zysku.

Jeśli masz już partnera zysku dla maio, możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.

Wybierz maio jako Sieć reklamową, wpisz niepowtarzalną Nazwę i włącz Mediację.

Włącz Automatyczne zbieranie danych i wpisz identyfikator interfejsu API oraz klucz interfejsu API uzyskane w poprzedniej sekcji.

Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako Typ integracji, iOS jako Platformę i Aktywny jako Stan. Wpisz identyfikator multimediów i identyfikator strefy uzyskane w poprzedniej sekcji. Następnie wpisz wartość domyślnego CPM.

Gdy skończysz, u dołu strony kliknij Zapisz.

Krok 3. Zaimportuj pakiet SDK i adapter maio

Używanie Swift Package Managera

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

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

  1. W Xcode kliknij File (Plik) > Add Package Dependencies... (Dodaj zależności pakietów).

  2. W wyświetlonym oknie 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.

Używanie 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 pobierania w historii zmian, i połącz maioAdapter.framework w projekcie.

Krok 4. Dodaj wymagany kod

Wdrażanie SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją maio.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że urządzenie testowe jest zarejestrowane w usłudze Ad Manager.

Wydawcy korzystający z pakietu Google Mobile Ads SDK w wersji 7.26.0 lub nowszej będą automatycznie otrzymywać reklamy testowe z sieci maio na telefonach i tabletach zarejestrowanych jako urządzenia testowe podczas wysyłania żądań.

Sprawdzanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z maio, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając ze źródeł reklam maio (kaskada).

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 klasy
Pełnoekranowa GADMMaioInterstitialAdapter
Z nagrodą GADMMaioRewardedAdapter

Oto kody i powiązane z nimi komunikaty, które adapter maio wyświetla, gdy nie uda się wczytać reklamy:

Kod błędu Przyczyna
0-10 maio zwrócił błąd związany z pakietem 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 dla tej konfiguracji sieci.
105 Filtruj żądania z ograniczeniem wiekowym w przypadku pakietu SDK maio, ponieważ nie może on odbierać sygnałów z ograniczeniem wiekowym.

Historia zmian adaptera zapośredniczenia maio na iOS

Wersja 2.2.3.0

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

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 13.9.0.
  • Pakiet SDK Maio w wersji 2.2.3.

Wersja 2.2.2.0

  • Zweryfikowano zgodność z pakietem SDK maio w wersji 2.2.2.
  • Teraz wymagana jest minimalna wersja iOS 15.0.
  • Zaktualizowano minimalną wersję iOS, aby złagodzić zależność od pakietu SDK do reklam mobilnych Google i umożliwić korzystanie z wersji podrzędnych.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 13.7.0.
  • Pakiet SDK Maio w wersji 2.2.2.

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.

Zbudowano i przetestowano z:

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

Wersja 2.2.1.1

  • Filtruj żądania z ograniczeniem wiekowym w przypadku pakietu SDK maio, ponieważ nie może on odbierać sygnałów z ograniczeniem wiekowym.

Zbudowano i przetestowano z:

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

Wersja 2.2.1.0

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

Zbudowano i przetestowano z:

  • 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 banerów reklamowych.
  • Zaktualizowano zależność pakietu SDK do reklam mobilnych Google do wersji 13.0.0.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 2.2.0.2

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

Zbudowano i przetestowano z:

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

Wersja 2.2.0.1

  • Usunęliśmy implementację określania stawek, ponieważ Maio nie obsługuje już określania stawek.
  • Zaktualizuj adapter, aby używał protokołu GADMediationAdapter.

Zbudowano i przetestowano z:

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

Wersja 2.2.0.0

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

Zbudowano i przetestowano z:

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

Wersja 2.1.6.1

  • Teraz wymagany jest pakiet 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.
  • Pakiet SDK Maio w wersji 2.1.6.

Wersja 2.1.6.0

  • Zweryfikowano 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.
  • Pakiet SDK Maio w wersji 2.1.6.

Wersja 2.1.5.1

  • Zaktualizowano CFBundleShortVersionString, aby zawierał 3 komponenty zamiast 4.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.10.0.
  • Pakiet SDK Maio w wersji 2.1.5.

Wersja 2.1.5.0

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

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.6.0.
  • Pakiet SDK Maio w wersji 2.1.5.

Wersja 2.1.4.0

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

Zbudowano i przetestowano z:

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

Wersja 2.1.3.0

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

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.1.0.
  • Pakiet SDK Maio 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 MaioAdapter.xcframework.

Zbudowano i przetestowano z:

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

Zbudowano i przetestowano z:

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

Wersja 2.1.1.0

  • Zweryfikowana 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.
  • Pakiet SDK Maio w wersji 2.1.1.

Wersja 2.0.0.0

  • Zweryfikowana 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 systemu iOS w wersji co najmniej 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.
  • Pakiet SDK Maio 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.

Zbudowano i przetestowano z:

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

Wersja 1.6.3.0

  • Zaktualizowano adapter, aby korzystał z interfejsu didRewardUser API.
  • Teraz wymagany jest pakiet 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-alpha.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 9.12.0.
  • Pakiet SDK Maio w wersji 1.6.3.
  • MaioOB SDK 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-alpha.

Zbudowano i przetestowano z:

  • 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

  • Zweryfikowano zgodność z pakietem SDK maio w wersji 1.6.1 i pakietem SDK maioOB w wersji 2.0.0-alpha.

Zbudowano i przetestowano z:

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

Zbudowano i przetestowano z:

  • 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.
  • Pakiet MaioOB SDK w wersji 2.0.0-alpha.

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

Zbudowano i przetestowano z:

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

Wersja 1.5.6.0

  • Zweryfikowana zgodność z pakietem SDK maio w wersji 1.5.6.
  • Teraz wymagany jest pakiet 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.

Zbudowano i przetestowano z:

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

Wersja 1.5.3.1

  • Aby ograniczyć przekroczenia limitu czasu, żądania reklamy będą teraz natychmiast odrzucane, jeśli maio nie ma reklamy gotowej do wyświetlenia.
  • Usunięto obsługę architektury i386.

Zbudowano i przetestowano z:

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

Wersja 1.5.3.0

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

Zbudowano i przetestowano z:

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

Zbudowano i przetestowano z:

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

Wersja 1.5.2.0

  • Zweryfikowana zgodność z pakietem maio SDK 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.

Zbudowano i przetestowano z:

  • 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 przy użyciu

  • 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

  • Zweryfikowano zgodność z pakietem maio SDK 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ł nie działać, jeśli z AdMob podano kilka 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 maio SDK 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

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