Zintegruj Mintegral z zapośredniczeniem

Wybierz platformę: Android Nowy Android iOS Unity Flutter

Z tego przewodnika dowiesz się, jak używać Google Mobile Ads Flutter Plugin do wczytywania i wyświetlania reklam z Mintegral za pomocą zapośredniczenia, omówimy integrację z wodospadem i określanie stawek. Dowiesz się, jak dodać Mintegral do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Mintegral z aplikacją Flutter.

Obsługiwane integracje i formaty reklam

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

Integracja
Określanie stawek  1
Wodospad
Formaty
Otwarcie aplikacji
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Natywna
1 Integracja określania stawek jest w otwartej wersji beta.

Wymagania

  • Najnowsze Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 lub nowszy
  • [W przypadku określania stawek] Aby zintegrować wszystkie obsługiwane formaty reklam w określanie stawek, użyj wtyczki zapośredniczenia reklam mobilnych Google dla Mintegral w wersji 1.4.0 lub nowszej (zalecana jest najnowsza wersja).
  • Aby wdrożyć na Androidzie:
    • Android API w wersji 23 lub nowszej
  • Aby wdrożyć na iOS:
    • iOS w wersji 13.0 lub nowszej
  • Działający projekt Flutter skonfigurowany za pomocą Google Mobile Ads Flutter Plugin. Więcej informacji znajdziesz w artykule Konfigurowanie Google Mobile Ads Flutter Plugin.
  • Konfiguracja zapośredniczenia

Krok 1. Skonfiguruj ustawienia w interfejsie Mintegral

Zarejestruj się lub zaloguj na konto Mintegral.

Znajdź klucz aplikacji

Otwórz kartę APP Setting (Ustawienia aplikacji) i zanotuj APP Key (Klucz aplikacji).

Dodaj nową aplikację

Na karcie APP Setting (Ustawienia aplikacji) kliknij przycisk Add APP (Dodaj aplikację).

Wybierz Platform (Platforma) i wypełnij resztę formularza. Następnie kliknij Save (Zapisz).

Android

iOS

Zanotuj APP ID (Identyfikator aplikacji).

Android

iOS

Tworzenie miejsca docelowego reklamy

Po utworzeniu aplikacji otwórz kartę Placements &Units (Miejsca docelowe i jednostki) i kliknij przycisk Add Placement (Dodaj miejsce docelowe), jak pokazano poniżej, aby utworzyć miejsce docelowe reklamy.

Android

iOS

Wpisz Placement Name (Nazwa miejsca docelowego) i AD Format (Format reklamy).

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

Po utworzeniu miejsca docelowego reklamy zanotuj Placement ID (Identyfikator miejsca docelowego).

Android

iOS

Kliknij menu 1 AD Units (1 jednostka reklamowa) i zanotuj AD Unit ID (Identyfikator jednostki reklamowej).

Android

iOS

Znajdź klucz 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 Ad Managera potrzebny będzie klucz interfejsu API do raportowania Mintegral. Kliknij Account (Konto) > API Tools (Narzędzia API). Zanotuj Skey (Klucz sesji) i Secret (Tajny klucz).

Zaktualizuj plik app-ads.txt

Authorized Sellers for Apps (czyli plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec utracie przychodów z reklam, użyj pliku app-ads.txt. Jeśli jeszcze tego nie zrobisz, utwórz plik app-ads.txt dla Ad Managera.

Aby wdrożyć app-ads.txt w Mintegral, przeczytaj artykuł Jak plik app-ads.txt może pomóc w walce z oszustwami reklamowymi.

Krok 2. Skonfiguruj popyt Mintegral w interfejsie Ad Managera

Skonfiguruj ustawienia zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 przewodnika dla Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.

Dodaj Mobvista/Mintegral do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi dotyczącymi prywatności

Aby dodać Mobvista/Mintegral do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi dotyczącymi prywatności w interfejsie Ad Managera, wykonaj czynności opisane w sekcjach Ustawienia wymagane przez rozporządzenia europejskie i Ustawienia wymagane przez amerykańskie przepisy stanowowe.

Krok 3. Zaimportuj pakiet SDK i adapter Mintegral

Integracja przez pub.dev

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

dependencies:
  gma_mediation_mintegral: ^2.1.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla Mintegral, rozpakuj pobrany plik i dodaj rozpakowany folder wtyczki (wraz z jego zawartością) do projektu Flutter. Następnie dodaj do pliku pubspec.yaml tę zależność:

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

Krok 4. Dodaj wymagany kod

Android

W przypadku integracji z Mintegral nie jest wymagany żaden dodatkowy kod.

iOS

Integracja SKAdNetwork

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

Krok 5. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe w Ad Managerze.

Aby otrzymywać reklamy testowe Mintegral w formatach banerów, reklam pełnoekranowych, reklam z nagrodą i reklam natywnych, Mintegral zaleca używanie kluczy aplikacji, identyfikatorów aplikacji, identyfikatorów miejsc docelowych i identyfikatorów jednostek reklamowych podanych na stronie Mintegral Test ID.

Sprawdź reklamy testowe

Aby sprawdzić, czy otrzymujesz reklamy testowe z Mintegral, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, używając Mintegral (określanie stawek) i Mintegral (wodospad) źródeł reklam.

Kody błędów

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

Android

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

iOS

GADMediationAdapterMintegral

Oto kody i towarzyszące im komunikaty zwracane 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 identyfikatora miejsca docelowego).
102 com.google.ads.mediation.mintegral Żądany rozmiar reklamy nie pasuje do obsługiwanego przez Mintegral rozmiaru banera.
103 com.google.ads.mediation.mintegral Brak odpowiedzi na pytanie o stawkę lub jest ona nieprawidłowa.
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 identyfikatora miejsca docelowego).
102 com.google.mediation.mintegral Pakiet SDK Mintegral zwrócił błąd dotyczący braku wypełnienia.
103 com.google.mediation.mintegral Pakietowi SDK Mintegral nie udało się wyświetlić reklamy.
104 com.google.mediation.mintegral Żądany rozmiar reklamy nie pasuje do obsługiwanego przez Mintegral rozmiaru banera.

Dziennik zmian adaptera zapośredniczenia Mintegral do Fluttera

Wersja 2.1.0

Wersja 2.0.3

Wersja 2.0.2

Wersja 2.0.1

Wersja 2.0.0

Wersja 1.2.6

Wersja 1.2.5

Wersja 1.2.4

Wersja 1.2.3

Wersja 1.2.2

Wersja 1.2.1

Wersja 1.2.0

Wersja 1.1.0

Wersja 1.0.0