Zintegruj Mintegral z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Mintegral z wykorzystaniem zapośredniczenia w ramach integracji kaskadowej i określania stawek. Omawiamy w nim, jak dodać Mintegral do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Mintegral z aplikacją na Unity.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dla Mintegral ma te możliwości:

Integracja
Ustalanie stawek		^1
Wodospad		^2
Formaty
Otwarcie aplikacji	^1  ^2
Baner
Pełnoekranowa
Otrzymano
Pełnoekranowa z nagrodą

¹ Integracja kaskadowa tego formatu jest obecnie w fazie zamkniętych testów beta.

² Integracja ustalania stawek w tym formacie jest dostępna w ramach zamkniętych testów beta.

Wymagania

• Unity w wersji 5.6 lub nowszej
• Najnowszy pakiet SDK do reklam mobilnych Google
• Aby przeprowadzić wdrożenie na Androidzie:
  • Interfejs API Androida na poziomie 19 lub wyższym
• Aby wdrożyć w iOS:
  • Wartość docelowa wdrożenia iOS w wersji 12.0 lub nowszej
• Działający projekt na Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
• Wykonaj czynności dotyczące zapośredniczenia Wprowadzenie

Krok 1. Skonfiguruj konfiguracje w interfejsie Mintegral

Zarejestruj się lub zaloguj na konto Mintegral.

Znajdź klucz aplikacji

Przejdź do karty Ustawienia aplikacji i zanotuj klawisz aplikacji.

Dodaj nową aplikację

Na karcie Ustawienia aplikacji kliknij przycisk Dodaj APLIKACJĘ.

Wybierz Platformę i wypełnij resztę formularza. Następnie kliknij Zapisz.

Android

iOS

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

Ważne: w przypadku formatu reklamy natywnej jako Format reklamy wybierz Natywna (renderowanie niestandardowe).

Ustalanie 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 określania stawek wybierz Tradycyjne. Wypełnij resztę formularza i kliknij Zapisz.

Po utworzeniu miejsca docelowego reklamy zanotuj Identyfikator miejsca docelowego.

Android

iOS

Kliknij menu 1 AD units (1 jednostka AD) i zanotuj AD Unit ID (Identyfikator jednostki AD).

Android

iOS

Znajdowanie klucza interfejsu Mintegral Reporting API

Ustalanie stawek

W przypadku integracji określania stawek ten krok nie jest wymagany.

Wodospad

Aby skonfigurowaćAdMob identyfikator jednostki reklamowej, będziesz potrzebować klucza interfejsu Mintegral Reporting API. Kliknij Account (Konto) > API Tools (Narzędzia interfejsu API). Zwróć uwagę na ustawienia Skey i Secret.

Krok 2. Skonfiguruj żądania Mintegral w interfejsie AdMob

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.

Dodaj Mintegral do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi

Ważne: sprawdź, czy masz uprawnienia Zarządzanie kontem, aby dokończyć konfigurowanie opcji uzyskiwania zgody użytkowników z UE, RODO, ustawy CPRA i platformy do przesyłania wiadomości użytkownikom. Więcej informacji znajdziesz w artykule Zarządzanie dostępem użytkowników do konta.

Wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia amerykańskich przepisów stanowych , aby dodać Mintegral do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w AdMob UI.

Krok 3. Zaimportuj pakiet SDK i adapter Mintegral

Uwaga: jeśli nie zintegrujesz zgodnej wersji Mintegral i pakietu SDK do reklam mobilnych Google, mogą wystąpić problemy z kompilacją.

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla Mintegral z linku do pobierania w historii zmian i wyodrębnij GoogleMobileAdsMintegralMediation.unitypackage z pliku ZIP.

W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsMintegralMediation.unitypackage. Zaznacz wszystkie pliki i kliknij Importuj.

Następnie wybierz Zasoby > Program do rozpoznawania Usług Google Play > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka programu do rozpoznawania zależności usług Unity Play zajmie się rozpoznawaniem zależności od zera i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android aplikacji Unity.

Krok 4. Dodaj wymagany kod

Android

Integracja Mintegral nie wymaga dodatkowego kodu.

iOS

Integracja SKAdNetwork

Postępuj zgodnie z dokumentacją Mintegral, aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu.

Krok 5. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby AdMob.

Aby uzyskać reklamy testowe Mintegral na potrzeby 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 jednostek reklamowych podanych na Strona Mintegral Test ID.

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy AdMob iMintegral .

Weryfikacja reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyMintegral, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z Mintegral (Bidding) and Mintegral (Waterfall) źródeł reklam.

Kody błędów

Jeśli adapter nie otrzyma reklamy z Mintegral, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi reklamy, korzystając z ResponseInfo w tych klasach:

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 można wczytać reklamy:

Android

Kod błędu	Domena	Przyczyna
101	com.google.ads.mediation.mintegral	Nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub identyfikatora miejsca docelowego).
102	com.google.ads.mediation.mintegral	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Mintegral.
103	com.google.ads.mediation.mintegral	Brak odpowiedzi na pytanie o stawkę lub jest ona nieprawidłowa.
104	com.google.ads.mediation.mintegral	Pakiet Mintegral SDK zwrócił błąd „brak wypełnienia”.

iOS

Kod błędu	Domena	Przyczyna
101	com.google.mediation.mintegral	Nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub identyfikatora miejsca docelowego).
102	com.google.mediation.mintegral	Pakiet Mintegral SDK zwrócił błąd „brak wypełnienia”.
103	com.google.mediation.mintegral	Mintegral SDK nie wyświetlił(a) reklamy.
104	com.google.mediation.mintegral	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Mintegral.

Historia zmian wtyczki Mintegral Unity Mediation

Wersja 1.4.0

• Obsługuje Mintegral adapter Android w wersji 16.6.34.0.
• Obsługuje adapter Mintegral na iOS w wersji 7.5.6.0.
• Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.7.0.

Wersja 1.3.0

• Obsługuje Mintegral adapter Android w wersji 16.5.91.0.
• Obsługuje adapter Mintegral na iOS w wersji 7.5.3.0.
• Dodano do klasy Mintegral te metody:
  • SetConsentStatus(bool)
  • SetDoNotTrackStatus(bool)
• Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.6.0.

Wersja 1.2.1

• Obsługuje Mintegral adapter Android w wersji 16.4.61.0.
• Obsługuje Mintegral adapter iOS w wersji 7.3.8.0.
• Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.3.0.

Wersja 1.2.0

• Treści adaptera zostały przeniesione do: GoogleMobileAds/Mediation/Mintegral/.
• Obsługuje Mintegral adapter Android w wersji 16.4.41.0.
• Obsługuje Mintegral adapter iOS w wersji 7.3.6.0.
• Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.3.0.

Wersja 1.1.0

• Obsługuje Mintegral adapter Android w wersji 16.3.61.0.
• Obsługuje adapter Mintegral na iOS w wersji 7.2.9.1.
• Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.4.1.

Wersja 1.0.0

• Pierwsza wersja!
• Obsługuje Mintegral adapter Android w wersji 16.2.61.0.
• Obsługuje Mintegral adapter iOS w wersji 7.2.6.0.
• Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.3.1.