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

Obsługiwane integracje i formaty reklam

AdMob Adapter pośredniczący dla sieci 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 3.7.0 lub nowszy
  • Aby wdrożyć to na Androidzie:
    • Poziom interfejsu API 21 lub nowszy
  • Aby wdrożyć aplikację na iOS:
    • docelowa wersja iOS 12.0 lub nowsza
  • Działający Flutter projekt 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 przejdź na kartę Miejsca docelowe i jednostki i kliknij przycisk Dodaj miejsce docelowe, jak pokazano poniżej, aby utworzyć miejsce docelowe reklamy.

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 pozostałe pola formularza i kliknij Zapisz.

Wodospad

W polu 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 zanotuj 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. Zanotuj wartości Skey i Secret (Skey).

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

Krok 3. Zaimportuj pakiet SDK i adapter Mintegral

Integracja za pomocą pub.dev

Dodaj te zależności z najnowszymi wersjami pakietuMintegral SDK i adaptera w pliku pubspec.yaml pakietu:

dependencies:
  gma_mediation_mintegral: ^1.0.0

Integracja ręczna

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

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

Krok 4. Dodaj wymagany kod

Android

Integracja Mintegral nie wymaga dodatkowego kodu.

iOS

Integracja z SKAdNetwork

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

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, by 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, używając źródeł reklam Mintegral (z określaniem stawek) i Mintegral (wodospad).

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 pasuje do rozmiaru banera obsługiwanego przez 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 Mintegral SDK nie wyświetlił reklamy.
104 com.google.mediation.mintegral Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Mintegral.

Historia 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

  • Zweryfikowano zgodność z adapterem Mintegral do Androida w wersji 16.8.31.0.
  • 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.
  • Utworzono i przetestowano z użyciem wtyczki Google Mobile Ads Flutter w wersji 5.1.0.