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ą Flutter.

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ą
Natywna  2

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.

2 W przypadku formatu reklamy natywnej integracje z ustalaniem stawek i kaskadą są dostępne w otwartej wersji beta.

Wymagania

  • Najnowsza wersja pakietu SDK do reklam mobilnych Google
  • Flutter w wersji 3.7.0 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:
    • docelowa wersja iOS 12.0 lub nowsza
  • działający projekt Flutter skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • Przejdź przez proces zapośredniczenia, korzystając z przewodnika 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 otwórz kartę Miejsca docelowe i jednostki i kliknij przycisk Dodaj miejsce docelowe, jak pokazano na ilustracji poniżej.

Android

iOS

Wpisz nazwę miejsca docelowegoformat 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 Mintegral do raportowania

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 w przewodniku dotyczącym iOS.

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

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 RODOamerykańskich przepisów stanowych.

Krok 3. Zaimportuj pakiet SDK i adapter Mintegral

Integracja przez pub.dev

Dodaj w pliku pubspec.yaml pakietu następującą zależność z najnowszymi wersjami pakietu SDK i adaptera Mintegral:

dependencies:
  gma_mediation_mintegral: ^1.0.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki pośredniczącej reklam mobilnych Google do Mintegral, wyodrębnij pobrany plik i dodaj wyodrębniony folder wtyczki (oraz jego zawartość) do projektu Flutter. Następnie odwołuj się do wtyczki w pliku pubspec.yaml, dodając tę zależność:

dependencies:
  gma_mediation_mintegral:
    path: path/to/local/package

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.

Weryfikowanie 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 odpowiednie 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 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.

Zmiana w historii zmian adaptera Mintegral Flutter Mediation

Następna wersja

  • Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.2.0.

1.1.0

  • Wersja 16.8.31.0 adaptera Mintegral na Androida została zweryfikowana pod kątem zgodności.
  • Weryfikowana zgodność z adapterem Mintegral na iOS w wersji 7.7.1.0.
  • Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.

1.0.0

  • Pierwsza wersja.
  • Weryfikowana zgodność z adapterem Mintegral na Androida w wersji 16.7.21.0.
  • Weryfikowana zgodność z adapterem Mintegral na iOS w wersji 7.6.3.0.
  • Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.