Zintegruj Mintegral z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads Flutter Plugin wczytywać i wyświetlać reklamy z Mintegral przy użyciu mediacji. Obejmuje on integracje kaskadowe i integracje oparte na licytowaniu. Wyjaśniamy w nim, jak dodać Mintegral do konfiguracji mediacji 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 Mintegrala ma te możliwości:

Integracja
Określanie stawek  1
Kaskada
Formaty
Otwarcie aplikacji
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Natywna
1 Integracja określania stawek jest dostępna w ramach otwartych testów beta.

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te informacje:

  • Najnowsza wersja Google Mobile Ads Flutter Plugin.
  • Flutter w wersji 3.7.0 lub nowszej.
  • [W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w określaniu stawek, użyj wtyczki do mediacji reklam mobilnych Google w przypadku Mintegral w wersji 1.4.0 lub nowszej (zalecana jest najnowsza wersja).
  • Wdrażanie na Androidzie
    • Android w wersji API 23 lub nowszej.
  • Wdrażanie na iOS
    • iOS w wersji 13.0 lub nowszej.
  • Działający projekt Fluttera skonfigurowany za pomocą narzędzia Google Mobile Ads Flutter Plugin. Więcej informacji znajdziesz w artykule Konfigurowanie Google Mobile Ads Flutter Plugin.
  • Skonfiguruj zapośredniczenie.

Krok 1. Skonfiguruj ustawienia w interfejsie Mintegral

Zarejestruj się lub zaloguj na konto Mintegral.

Znajdowanie klucza aplikacji

Otwórz kartę Ustawienia aplikacji i zanotuj klucz aplikacji.

Dodawanie nowej aplikacji

Na karcie Ustawienia aplikacji kliknij przycisk Dodaj aplikację.

Wybierz Platformę i wypełnij pozostałe pola 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 poniżej, aby utworzyć miejsce docelowe reklamy.

Android

iOS

Wpisz nazwę miejsca docelowego i format reklamy.

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

Po utworzeniu miejsca docelowego reklamy zanotuj identyfikator miejsca docelowego.

Android

iOS

Kliknij menu 1 jednostka reklamowa 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 z określaniem stawek.

Kaskada

Aby skonfigurować identyfikator jednostki reklamowej Ad Managera, potrzebujesz klucza interfejsu API do raportowania Mintegral. Kliknij Konto > Narzędzia API. Zapisz Skey i Secret.

Aktualizowanie pliku app-ads.txt

Authorized Sellers for Apps (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 znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze tego nie zrobiono, utwórz plik app-ads.txt dla usługi Ad Manager.

Aby zaimplementować app-ads.txt w przypadku Mintegral, zapoznaj się z artykułem Jak plik app-ads.txt może pomóc w walce z oszustwami reklamowymi.

Krok 2. Skonfiguruj popyt Mintegral w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.

Dodawanie Mobvista/Mintegral do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi

Aby dodać Mobvista/Mintegral do listy partnerów reklamowych zachowujących zgodność z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie Ad Managera, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące amerykańskich przepisów stanowych.

Krok 3. Zaimportuj pakiet SDK i adapter Mintegral

Integracja za pomocą pub.dev

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

dependencies:
  gma_mediation_mintegral: ^2.1.3

Integracja ręczna

Pobierz najnowszą wersję wtyczki do 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 odwołaj się do wtyczki w pliku pubspec.yaml, dodając tę zależność:

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

Krok 4. Wdróż ustawienia prywatności w pakiecie Mintegral SDK

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz udzielać odpowiednich informacji użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii oraz uzyskiwać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane przez prawo, a także na zbieranie, udostępnianie i wykorzystywanie danych osobowych na potrzeby personalizacji reklam. Polityka ta odzwierciedla wymagania UE zawarte w dyrektywie o prywatności i łączności elektronicznej oraz w Ogólnym rozporządzeniu o ochronie danych (RODO). Odpowiadasz za sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu zapośredniczenia.

Adapter Mintegral Flutter w wersji 2.2.1 i nowszych obsługuje przekazywanie sygnałów zgody wymaganych przez RODO z platform do zarządzania zgodą użytkowników, które są zintegrowane z Zasadami IAB dotyczącymi przejrzystości i uzyskiwania zgody na przetwarzanie danych (TCF), do pakietu Mintegral SDK. Więcej informacji znajdziesz w dokumentacji Mintegral dotyczącej oświadczenia o zgodności z zasadami ochrony prywatności w przypadku pakietów SDK na Android i iOS.

Krok 5. Dodaj wymagany kod

Android

Integracja z Mintegral nie wymaga dodatkowego kodu.

iOS

Integracja SKAdNetwork

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

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe w Ad Managerze.

Aby otrzymywać reklamy testowe Mintegral w przypadku 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 z identyfikatorami testowymi 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 ze źródeł reklam Mintegral (ustalanie stawek) i Mintegral (kaskadowe).

Kody błędów

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

Android

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

iOS

GADMediationAdapterMintegral

Oto kody i komunikaty towarzyszące, które są zwracane przez adapter Mintegral, gdy nie uda się wczytać reklamy:

Android

Kod błędu Domena Przyczyna
100 com.mbridge.msdk Pakiet SDK Mintegral zwrócił wywołanie zwrotne błędu.
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 Brakująca lub nieprawidłowa odpowiedź na pytanie o stawkę.
104 com.google.ads.mediation.mintegral Pakiet SDK Mintegral zwrócił błąd dotyczący braku wypełnienia.
105 com.mbridge.msdk Nie udało się zainicjować pakietu SDK Mintegral.
106 com.google.ads.mediation.mintegral Reklama w boksie Mintegral jest już wczytana, ale jeszcze nie została wyświetlona.

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

Historia zmian adaptera do zapośredniczenia Mintegral Flutter

Wersja 2.1.4 (w toku)

Wersja 2.1.3

Wersja 2.1.2

Wersja 2.1.1

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