Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Mintegral przy użyciu mediacji. Obejmuje on zarówno integrację z metodą kaskadową, jak i z metodą ustalania stawek. Przewodnik zawiera informacje o dodawaniu pakietu Mintegral do konfiguracji zapośredniczenia jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera Mintegral z aplikacją Unity .
Obsługiwane integracje i formaty reklam
AdMob Adapter zapośredniczenia do Mintegral udostępnia te możliwości:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Otwarcie aplikacji | 1 |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Reklama pełnoekranowa z nagrodą |
1 Integracje określania stawek i kaskady reklam wyświetlanych przy otwarciu aplikacji są dostępne w zamkniętej wersji beta.
Wymagania
- Najnowszy pakiet SDK do reklam mobilnych Google
- Unity w wersji 5.6 lub nowszej
- Aby wdrożyć na Androidzie:
- Poziom interfejsu API 21 lub nowszy
- Aby wdrożyć aplikację na iOS:
- Cel wdrożenia iOS w wersji 12.0 lub nowszej
- działający Unity projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
- Wykonaj zapośredniczenie Przewodnik dla początkujących
Krok 1. Skonfiguruj konfiguracje w interfejsie Mintegral
Zarejestruj lub zaloguj się na konto Mintegral.
Znajdowanie klucza aplikacji
Otwórz kartę Ustawienia aplikacji i zapisz klucz aplikacji.
Dodawanie nowej aplikacji
Na karcie Ustawienia aplikacji kliknij przycisk Dodaj aplikację.
Wybierz Platformę i wypełnij resztę formularza. Następnie kliknij Zapisz.
Android
iOS
Zapisz identyfikator aplikacji.
Android
iOS
Tworzenie miejsca docelowego reklamy
Po utworzeniu aplikacji przejdź na kartę Miejsca docelowe i jednostki i kliknij przycisk Dodaj miejsce docelowe, jak pokazano poniżej, aby utworzyć miejsce docelowe reklamy.
Android
iOS
Wypełnij pola Nazwa miejsca docelowego i Format reklamy.
Określanie stawek
Jako Typ określania stawek wybierz Określanie stawek przez kod w nagłówku. Wypełnij pozostałe pola formularza i kliknij Zapisz.
Wodospad
W polu Typ ustalania stawek wybierz Tradycyjne. Wypełnij pozostałe pola formularza i kliknij Zapisz.
Po utworzeniu miejsca docelowego reklamy zanotuj jego identyfikator.
Android
iOS
Kliknij menu 1 Jednostki reklamowe i zapisz Identyfikator jednostki reklamowej.
Android
iOS
Znajdowanie klucza interfejsu API do raportowania Mintegral
Określanie stawek
Nie musisz tego robić w przypadku integracji z określaniem stawek.
Wodospad
Do skonfigurowania identyfikatora jednostki reklamowej AdMob potrzebny będzie klucz interfejsu API do raportowania Mintegral. Kliknij Konto > Narzędzia API. Zapisz klucz dostępu i klucz tajny.
Krok 2. Skonfiguruj zapotrzebowanie Mintegral w AdMob UI
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 instrukcji na Androida.
iOS
Instrukcje znajdziesz w kroku 2 przewodnika po iOS.
Dodawanie partnerów reklamowych do listy zgodnej z RODO i przepisami stanowymi w USA
Aby dodać Mobvistę/Mintegral do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA w interfejsie AdMob, wykonaj czynności opisane w ustawieniach dotyczących RODO i amerykańskich przepisów stanowych.
Krok 3. Zaimportuj pakiet SDK i adapter Mintegral
OpenUPM-CLI
Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować wtyczkę zapośredniczenia Mintegral do reklam mobilnych Google dla Unity w projekcie, wykonując to polecenie w katalogu głównym projektu:
openupm add com.google.ads.mobile.mediation.mintegral
OpenUPM
W edytorze projektu Unity wybierz Edytuj > Ustawienia projektu > Menedżer pakietów, aby otworzyć ustawienia menedżera pakietów Unity.
Na karcie Rejestry ograniczone dodaj OpenUPM jako rejestr ograniczony z tymi informacjami:
- Nazwa:
OpenUPM
- Adres URL:
https://package.openupm.com
- Zakres:
com.google
Następnie kliknij Okno > Menedżer pakietów, aby otworzyć Menedżera pakietów Unity, a potem w menu kliknij Moje rejestry.
Wybierz pakiet Google Mobile Ads Mintegral Mediation i kliknij Zainstaluj.
Pakiet Unity
Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla Mintegral z linku do pobrania w Changelog i rozpakuj plik zipGoogleMobileAdsMintegralMediation.unitypackage
.
W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsMintegralMediation.unitypackage
. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Następnie wybierz Zasoby > Zewnętrzny menedżer zależności > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka menedżera zależności zewnętrznej wykona rozwiązanie zależności od podstaw i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
Twojej aplikacji Unity.
Krok 4. Dodaj wymagany kod
Android
Integracja z Mintegral nie wymaga dodatkowego kodu.
iOS
Integracja z SKAdNetwork
Aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu, postępuj zgodnie z dokumentacją Mintegral.
Krok 5. Przetestuj implementację
Włączanie reklam testowych
Pamiętaj, by zarejestrować urządzenie testowe w AdMob.
Aby uzyskać testowe reklamy Mintegral dotyczące banerów, reklam pełnoekranowych, reklam z nagrodą i reklam natywnych, Mintegral zaleca użycie kluczy aplikacji, identyfikatorów aplikacji, identyfikatorów miejsc docelowych i identyfikatorów jednostki reklamowej podanych na stronie z identyfikatorem testu Mintegral.
Zweryfikuj reklamy testowe
Aby sprawdzić, czy otrzymujesz reklamy testowe z Mintegral, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając z źródeł reklam Mintegral (ustalanie stawek) i Mintegral (kaskada).
Kody błędów
Jeśli adapter nie otrzyma reklamy z Mintegral, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na reklamę, używając polecenia ResponseInfo
z tych klas:
Android
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
Oto kody i powiązane z nimi komunikaty wysyłane przez adapter Mintegral, gdy nie uda się wczytać reklamy:
Android
Kod błędu | Domena | Przyczyna |
---|---|---|
101 | com.google.ads.mediation.mintegral | nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub miejsca docelowego); |
102 | com.google.ads.mediation.mintegral | Żądany rozmiar reklamy nie odpowiada obsługiwanemu rozmiarowi banera w Mintegral. |
103 | com.google.ads.mediation.mintegral | Brakująca lub nieprawidłowa odpowiedź na zapytanie o stawki. |
104 | com.google.ads.mediation.mintegral | Pakiet SDK Mintegral zwrócił błąd dotyczący braku wypełnienia. |
iOS
Kod błędu | Domena | Przyczyna |
---|---|---|
101 | com.google.mediation.mintegral | nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub miejsca docelowego); |
102 | com.google.mediation.mintegral | Pakiet SDK Mintegral zwrócił błąd dotyczący braku wypełnienia. |
103 | com.google.mediation.mintegral | Pakiet SDK Mintegral nie wyświetlił reklamy. |
104 | com.google.mediation.mintegral | Żądany rozmiar reklamy nie odpowiada obsługiwanemu rozmiarowi banera w Mintegral. |
Historia zmian wtyczki Mintegral Unity Mediation
Wersja 1.8.2
- Obsługuje adapter Mintegral do Androida w wersji 16.8.61.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.7.2.1.
- Ta wersja została utworzona i przetestowana za pomocą wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.2.1.
Wersja 1.8.1
- Obsługuje adapter Mintegral na Androida w wersji 16.8.51.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.7.2.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.2.0.
Wersja 1.8.0
- Obsługuje adapter Mintegral do Androida w wersji 16.8.31.0.
- Obsługuje adapter Mintegral do iOS w wersji 7.7.0.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.2.0.
Wersja 1.7.0
- Nazwa
DummyClient
została zmieniona naPlaceholderClient
. - Obsługuje adapter Mintegral do Androida w wersji 16.8.11.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.6.9.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.2.0.
Wersja 1.6.5
- Obsługuje adapter Mintegral na Androida w wersji 16.7.81.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.6.8.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.2.0.
Wersja 1.6.4
- Obsługuje adapter Mintegral na Androida w wersji 16.7.61.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.6.7.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 1.6.3
- Obsługuje adapter Mintegral na Androida w wersji 16.7.41.0.
- Obsługuje adapter Mintegral do iOS w wersji 7.6.6.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.1.0.
Wersja 1.6.2
- Obsługuje adapter Mintegral do Androida w wersji 16.7.41.0.
- Obsługuje adapter Mintegral do iOS w wersji 7.6.4.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.1.0.
Wersja 1.6.1
- Obsługuje adapter Mintegral na Androida w wersji 16.7.21.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.6.3.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.1.0.
Wersja 1.6.0
- Obsługuje adapter Mintegral do Androida w wersji 16.7.11.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.6.2.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.0.0.
Wersja 1.5.0
- Obsługuje adapter Mintegral na Androida w wersji 16.6.71.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.6.0.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.0.0.
Wersja 1.4.0
- Obsługuje adapter Mintegral na Androida w wersji 16.6.34.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.5.6.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.7.0.
Wersja 1.3.0
- Obsługuje adapter Mintegral na Androida w wersji 16.5.91.0.
- Obsługuje adapter Mintegral do iOS w wersji 7.5.3.0.
- Do klasy
Mintegral
dodaliśmy te metody:SetConsentStatus(bool)
SetDoNotTrackStatus(bool)
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.6.0.
Wersja 1.2.1
- Obsługuje adapter Mintegral na Androida w wersji 16.4.61.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.3.8.0.
- Ta wersja została opracowana i przetestowana z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.3.0.
Wersja 1.2.0
- Treści adaptera zostały przeniesione do
GoogleMobileAds/Mediation/Mintegral/
. - Obsługuje adapter Mintegral na Androida w wersji 16.4.41.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.3.6.0.
- Ta wersja została opracowana i przetestowana z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.3.0.
Wersja 1.1.0
- Obsługuje adapter Mintegral na Androida w wersji 16.3.61.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.2.9.1.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.4.1.
Wersja 1.0.0
- Premiera!
- Obsługuje adapter Mintegral na Androida w wersji 16.2.61.0.
- Obsługuje adapter Mintegral na iOS w wersji 7.2.6.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.3.1.