Zintegruj Mintegral z zapośredniczeniem

Wybierz platformę: Android Nowy Android iOS Unity Flutter

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads Flutter Plugin wczytywać i wyświetlać reklamy z Mintegrala za pomocą zapośredniczenia, w tym integracji z wodospadem i określania stawek. Dowiesz się, jak dodać Mintegrala do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Mintegrala 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
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

  • Najnowsza 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ślania stawek, użyj wtyczki zapośredniczenia reklam mobilnych Google dla Mintegrala 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 Mintegrala

Zarejestruj się lub zaloguj na konto Mintegrala.

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 Mintegrala

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 Mintegrala. Otwórz 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 Mintegralu, przeczytaj artykuł Jak plik app-ads.txt może pomóc w walce z oszustwami reklamowymi.

Krok 2. Skonfiguruj popyt Mintegrala 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/Mintegrala do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi

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

Krok 3. Zaimportuj pakiet SDK i adapter Mintegrala

Integracja przez pub.dev

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

dependencies:
  gma_mediation_mintegral: ^2.0.3

Integracja ręczna

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla Mintegrala, 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 Mintegralem nie jest wymagany żaden dodatkowy kod.

iOS

Integracja SKAdNetwork

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

Krok 5. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe w Ad Managerze.

Aby otrzymywać reklamy testowe Mintegrala 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 Mintegrala, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, używając źródeł reklam Mintegral (określanie stawek) i Mintegral (wodospad).

Kody błędów

Jeśli adapter nie otrzyma reklamy z Mintegrala, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy za pomocą 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 Mintegrala, 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 rozmiaru banera obsługiwanego przez Mintegrala.
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 Mintegrala 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 Mintegrala zwrócił błąd dotyczący braku wypełnienia.
103 com.google.mediation.mintegral Pakiet SDK Mintegrala nie wyświetlił reklamy.
104 com.google.mediation.mintegral Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Mintegrala.

Dziennik zmian adaptera zapośredniczenia Mintegrala dla Fluttera

Wersja 2.1.0 (w toku)

  • Zaktualizowano minimalną wersję Fluttera do 3.38.1.
  • Zaktualizowano obsługę wtyczki reklam mobilnych Google do Fluttera w wersji 8.0.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