Zintegruj Mintegral z zapośredniczeniem

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 ten zawiera informacje o dodawaniu pakietu Mintegral do konfiguracji zapośredniczenia jednostki reklamowej oraz o integrowaniu pakietu Mintegral SDK i adaptera z aplikacją Unity.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dla Mintegral ma te funkcje:

Integracja
Określanie stawek
Wodospad
Formaty
Otwarcie aplikacji  1
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą

1 Wersja beta integracji ustalania stawek i kaskady dla formatu reklamy wyświetlanej przy otwarciu aplikacji jest dostępna w ramach zamkniętych testów beta.

Wymagania

  • Najnowsza wersja pakietu SDK do reklam mobilnych Google
    • Unity w wersji 5.6 lub nowszej
    • [Do ustalania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam z określaniem stawek, użyj wtyczki Google Mobile Ads do zapośredniczenia w Mintegral w wersji 1.4.0 lub nowszej (zalecana najnowsza wersja).
    • Aby wdrożyć na Androidzie:
      • poziom interfejsu API 21 lub nowszy,
    • Aby wdrożyć aplikację na iOS:
      • wersja iOS 12.0 lub nowsza,
    • działający projekt Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
    • Przeczytaj Przewodnik dla początkujących na temat zapośredniczenia.

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 Platforma i wypełnij resztę formularza. Następnie kliknij Zapisz.

Android

iOS

Zapisz identyfikator aplikacji.

Android

iOS

Tworzenie miejsca docelowego reklamy

Po utworzeniu aplikacji otwórz kartę Miejsca docelowe i jednostki i kliknij przycisk Dodaj miejsce docelowe, jak pokazano na ilustracji poniżej.

Android

iOS

Wpisz nazwę miejsca docelowego i format reklamy.

Określanie stawek

Jako Typ określania stawek wybierz Określanie stawek przez kod w nagłówku. Wypełnij resztę formularza i kliknij Zapisz.

Wodospad

Jako Typ ustalania stawek wybierz Tradycyjne. Wypełnij resztę 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

Ten krok nie jest wymagany w przypadku integracji określania 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 interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.

Dodawanie firmy Mobvista/Mintegral do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi

Wykonaj czynności opisane w ustawieniach dotyczących europejskich przepisów i ustawień dotyczących przepisów stanowych w USA, aby dodać Mobvistę/Mintegral do listy partnerów reklamowych w Europejskich i Amerykańskich Przepisach Stanowych w interfejsie AdMob.

Krok 3. Zaimportuj pakiet SDK i adapter Mintegral

OpenUPM-CLI

Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę Mintegral Mediation dla Google Mobile Ads na platformie Unity. Aby to zrobić, uruchom 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

Szczegóły UPM

Następnie kliknij Okno > Menedżer pakietów, aby otworzyć Menedżera pakietów Unity, a potem w menu kliknij Moje rejestry.

Rejestry Unity

Wybierz pakiet Google Mobile Ads Mintegral Mediation i kliknij Zainstaluj.

Instalowanie z OpenUPM

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.

Importowanie z Unity

Następnie kliknij Zasoby > Menedżer zewnętrznych zależności > Rozwiązanie Androida > Wymuś rozwiązanie. Biblioteka menedżera zależności zewnętrznych wykona rozwiązywanie zależności od podstaw i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android Twojej aplikacji Unity.

Wymuś rozwiązanie

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, aby zarejestrować urządzenie testowe w AdMob.

Aby wyświetlać reklamy testowe Mintegral w formatach banerów, reklam pełnoekranowych, reklam z nagrodą i reklam natywnych, Mintegral zaleca korzystanie z kluczy aplikacji, identyfikatorów aplikacji, identyfikatorów miejsc docelowych i identyfikatorów jednostek reklamowych podanych na stronie z identyfikatorem testowym Mintegral.

Weryfikacja reklam testowych

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 od Mintegral, wydawcy mogą sprawdzić błąd podstawowy w odpowiedzi reklamy, korzystając z interfejsu ResponseInfo w ramach tych klas:

Android

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

iOS

GADMediationAdapterMintegral

Oto kody i dołączone komunikaty z adaptera Mintegral, które pojawiają się, gdy nie udaje się załadować 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 przez Mintegral rozmiarowi banera.
103 com.google.ads.mediation.mintegral Brakująca lub nieprawidłowa odpowiedź na zapytanie o stawkę.
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 przez Mintegral rozmiarowi banera.

Historia zmian wtyczki Mintegral Unity Mediation

Wersja 1.8.4

Wersja 1.8.3

Wersja 1.8.2

Wersja 1.8.1

Wersja 1.8.0

Wersja 1.7.0

Wersja 1.6.5

Wersja 1.6.4

Wersja 1.6.3

Wersja 1.6.2

Wersja 1.6.1

Wersja 1.6.0

Wersja 1.5.0

Wersja 1.4.0

Wersja 1.3.0

Wersja 1.2.1

Wersja 1.2.0

Wersja 1.1.0

Wersja 1.0.0