Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

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, co obejmuje integracje kaskadowe. 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ą
Rodzimy użytkownik

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

iOS w wersji 15.0 lub nowszej.

Najnowsza wersja Google Mobile Ads SDK.
Skonfiguruj zapośredniczenie.

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 następnie kliknij Aktualizuj.

Na stronie Application Management (Zarządzanie aplikacjami) zanotuj Media ID (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 zapisz identyfikator interfejsu API i klucz interfejsu 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 unikalną nazwę i włącz zapośredniczenie.

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ślny 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ć co najmniej minimalną obsługiwaną wersję adaptera, czyli 2.2.0.0.

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

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

W wyświetlonym oknie wyszukaj ten adres URL pakietu:

https://github.com/googleads/googleads-mobile-ios-mediation-maio.git

W sekcji Reguła zależności wybierz Gałąź.
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ć błąd w odpowiedzi na reklamę, używając metody 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.