Zintegruj Mintegral z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Mintegral z wykorzystaniem zapośredniczenia w ramach integracji kaskadowej i określania stawek. Opisano w nim, 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 AdMob dla Mintegral ma te możliwości:

Integracja
Ustalanie stawek		^1
Wodospad		^2
Formaty
Otwarcie aplikacji	^1  ^2
Baner
Pełnoekranowa
Otrzymano
Pełnoekranowa z nagrodą
Natywna	^1  ^3

¹ Integracja ustalania stawek w tym formacie znajduje się w fazie zamkniętych testów beta.

² Integracja kaskady dla tego formatu znajduje się w fazie zamkniętych testów beta.

³ Integracja kaskady dla tego formatu jest w otwartej wersji beta.

Wymagania

• Najnowszy pakiet SDK do reklam mobilnych Google
• Flutter w wersji 3.7.0 lub nowszej
• Aby przeprowadzić wdrożenie na Androidzie:
  • Interfejs API Androida na poziomie 21 lub wyższym
• Aby wdrożyć w iOS:
  • Wartość docelowa wdrożenia iOS w wersji 12.0 lub nowszej
• Działający Flutter projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
• Skorzystaj z zapośredniczenia Wprowadzenie

Krok 1. Skonfiguruj konfiguracje w interfejsie Mintegral

Zarejestruj się lub zaloguj na konto Mintegral.

Znajdź klucz aplikacji

Przejdź do karty Ustawienia aplikacji i zanotuj klawisz aplikacji.

Dodaj nową aplikację

Na karcie Ustawienia aplikacji kliknij przycisk Dodaj APLIKACJĘ.

Wybierz Platformę i wypełnij resztę formularza. Następnie kliknij Zapisz.

Android

iOS

Zanotuj 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

Wypełnij pola Nazwa miejsca docelowego i Format reklamy.

Ważne: w przypadku formatu reklamy natywnej jako Format reklamy wybierz Natywna (renderowanie niestandardowe).

Ustalanie 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 określania stawek wybierz Tradycyjne. Wypełnij resztę formularza i kliknij Zapisz.

Po utworzeniu miejsca docelowego reklamy zanotuj Identyfikator miejsca docelowego.

Android

iOS

Kliknij menu 1 AD units (1 jednostka AD) i zanotuj AD Unit ID (Identyfikator jednostki AD).

Android

iOS

Znajdowanie klucza interfejsu Mintegral Reporting API

Ustalanie stawek

W przypadku integracji określania stawek ten krok nie jest wymagany.

Wodospad

Aby skonfigurowaćAdMob identyfikator jednostki reklamowej, będziesz potrzebować klucza interfejsu Mintegral Reporting API. Kliknij Account (Konto) > API Tools (Narzędzia interfejsu API). Zwróć uwagę na ustawienia Skey i Secret.

Krok 2. Skonfiguruj żądania Mintegral w interfejsie AdMob

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.

Dodaj Mintegral do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi

Ważne: sprawdź, czy masz uprawnienia Zarządzanie kontem, aby dokończyć konfigurowanie opcji uzyskiwania zgody użytkowników z UE, RODO, ustawy CPRA i platformy do przesyłania wiadomości użytkownikom. Więcej informacji znajdziesz w artykule Zarządzanie dostępem użytkowników do konta.

Wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia amerykańskich przepisów stanowych , aby dodać Mintegral do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w AdMob UI.

Krok 3. Zaimportuj pakiet SDK i adapter Mintegral

Uwaga: jeśli nie zintegrujesz zgodnej wersji Mintegral i pakietu SDK do reklam mobilnych Google, mogą wystąpić problemy z kompilacją.

Integracja za pomocą pub.dev

Dodaj tę zależność do najnowszych wersji pakietuMintegral SDK i adaptera w pliku pubspec.yaml pakietu:

dependencies:
  gma_mediation_mintegral: ^1.0.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla Mintegral, wyodrębnij pobrany plik i dodaj do projektu Flutter wyodrębniony folder wtyczki (wraz z jego zawartością). 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. Dodaj wymagany kod

Android

Integracja Mintegral nie wymaga dodatkowego kodu.

iOS

Integracja SKAdNetwork

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

Krok 5. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby AdMob.

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

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy AdMob iMintegral .

Weryfikacja reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyMintegral, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z Mintegral (Bidding) and Mintegral (Waterfall) źródeł reklam.

Kody błędów

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

Android

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

iOS

GADMediationAdapterMintegral

Oto kody i powiązane z nimi komunikaty wysyłane przez adapter Mintegral, gdy nie można 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 Mintegral.
103	com.google.ads.mediation.mintegral	Brak odpowiedzi na pytanie o stawkę lub jest ona nieprawidłowa.
104	com.google.ads.mediation.mintegral	Pakiet Mintegral SDK zwrócił błąd „brak 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 Mintegral SDK zwrócił błąd „brak wypełnienia”.
103	com.google.mediation.mintegral	Mintegral SDK nie wyświetlił(a) reklamy.
104	com.google.mediation.mintegral	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Mintegral.

Historia zmian adaptera Mintegral Flutter Mediation

1.0.0

• Pierwsza wersja.
• Zweryfikowana zgodność z adapterem Mintegral na Androida w wersji 16.7.21.0.
• Zweryfikowana zgodność z adapterem Mintegral na iOS w wersji 7.6.3.0.
• Stworzona i przetestowana z wtyczką Google Mobile Ads Flutter w wersji 5.1.0.