Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać reklamy displayowe z Mintegral używające zapośredniczenia, obejmujących zarówno kaskady, jak i integracje z określaniem stawek. Obejmuje jak dodać Mintegral do konfiguracji zapośredniczenia jednostki reklamowej i jak zintegruj pakiet SDK i adapter Mintegral z Android
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia do Mintegral ma te funkcje:
Integracja | |
---|---|
Określanie stawek | 1. |
Wodospad | 2. |
Formaty | |
Otwarcie aplikacji | |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Pełnoekranowa z nagrodą | |
Natywna |
2 Integracja kaskadowa jest już dostępna zamkniętych testów beta.
Wymagania
- Interfejs API Androida na poziomie 21 lub wyższym
Najnowszy pakiet SDK do reklam mobilnych Google
Dokończ zapośredniczenie Przewodnik dla początkujących
Krok 1. Skonfiguruj konfiguracje w interfejsie Mintegral
Krok 2. Skonfiguruj żądania Mintegral w Ad Manager interfejsie użytkownika
Dodaj Mintegral do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi
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 Ad Manager UI.
Krok 3. Zaimportuj pakiet SDK Mintegral i adapter
Integracja z Android Studio (zalecana)
W pliku settings.gradle.kts
na poziomie projektu dodaj:
repozytoria:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
}
}
}
Następnie w pliku build.gradle.kts
na poziomie aplikacji dodaj te elementy
zależności i konfiguracje wdrożenia. Użyj najnowszych wersji
Pakiet SDK Mintegral i adapter:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:mintegral:16.8.31.0")
}
Integracja ręczna
Aby dołączyć pakiet SDK Mintegral, przejdź do Mintegral SDK na Androida.
Przejdź do Artefakty adaptera Mintegral w repozytorium Google Maven. Wybierz najnowszą wersję, pobierz Mintegral
.aar
adaptera i dodaj go do projektu.
Krok 4. Wdróż ustawienia prywatności w pakiecie SDK Mintegral
Zgoda użytkowników z UE i RODO
Obowiązujące w Google zgoda użytkownika z UE Google, musisz dopilnować, aby takie oświadczenia zostały ujawnione. zgody uzyskane od użytkowników z Europejskiego Obszaru Gospodarczego dotyczące: wykorzystywania identyfikatorów urządzeń i danych osobowych. Zasady te odzwierciedlają wymagania unijnej dyrektywy o prywatności i łączności elektronicznej oraz Ogólnej ustawy o ochronie danych Rozporządzenie (RODO). Wyświetlając prośbę o zgodę na wykorzystanie danych, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe i dostarczają informacji o korzystaniu z poszczególnych sieci. Google obecnie nie może automatycznego przekazywania do takich sieci wyboru użytkownika dotyczącego zgody.
Pakiet Mintegral SDK zawiera metodę setConsentStatus
do przekazywania zgody
do pakietu SDK Mintegral.
Ten przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do Mintegral SDK. Te opcje należy skonfigurować przed zainicjować pakiet SDK do reklam mobilnych Google , by mieć pewność, że zostaną prawidłowo przekazane do pakietu SDK Mintegral.
Java
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);
Kotlin
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)
Zobacz dokumentację Mintegral poświęconą prywatności .
Amerykańskie przepisy stanowe o ochronie prywatności
Stany Zjednoczone przepisy stanowe o ochronie prywatności wymagają dawania użytkownikom zrezygnować z „wyprzedaży”, „danych osobowych” (zgodnie z definicją w ustawie tych haseł) z opcją rezygnacji dostępną za pomocą dobrze widocznego powiadomienia „Nie sprzedawaj Informacje” w wierszu „sprzedaż”, na stronie głównej strony. Stany Zjednoczone stanowa prywatność użytkowników przewodnik dotyczący zgodności z przepisami prawa umożliwia włączenie ograniczone przetwarzanie danych wyświetlania reklam przez Google, ale Google nie może stosować tego ustawienia do poszczególnych reklam w łańcuchu zapośredniczenia. W przypadku każdej sieci reklamowej należy w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży i postępuj zgodnie ze wskazówkami dotyczącymi tych sieci, aby zapewnić zgodność z przepisami.
Pakiet SDK Mintegral zawiera metodę setDoNotTrackStatus
do przekazywania zgody
do pakietu SDK Mintegral.
Ten przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do Mintegral SDK. Jeśli chcesz wywołać tę metodę, wywołaj ją po zainicjowanie pakietu SDK do reklam mobilnych Google ale przed wysłaniem żądania reklamy za pomocą pakietu SDK do reklam mobilnych Google.
Java
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);
Kotlin
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)
Zobacz dokumentację Mintegral poświęconą prywatności .
Krok 5. Dodaj wymagany kod
Integracja Mintegral nie wymaga dodatkowego kodu.
Krok 6. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby Ad Manager.
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 stronie Mintegral Test ID.
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.
Kroki opcjonalne:
Dodaj Mintegral do listy partnerów reklamowych zgodnych z ustawą CCPA
Wykonaj czynności opisane w Ustawienia CCPA aby dodać firmę Mintegral do listy partnerów reklamowych zgodnych z ustawą CCPA Ad Manager Interfejs użytkownika
Reklamy natywne
Renderowanie reklam
Adapter Mintegral zwraca reklamy natywne jako
NativeAd
obiektów. Zawiera te dane
pola
dla
NativeAd
Pole | Zasoby zawsze uwzględniane przez adapter Mintegral |
---|---|
Nagłówek | |
Obraz | 1 |
Treść | |
Ikona | |
Wezwanie do działania | |
Ocena w gwiazdkach | |
Sklep | |
Cena | |
Reklamodawca |
1 Adapter Mintegral nie
zapewnić bezpośredni dostęp do głównego komponentu z obrazem swoich reklam natywnych. Zamiast tego makro
adapter wypełnia
MediaView
.
z filmem lub obrazem.
Kody błędów
Jeśli adapter nie otrzyma reklamy z Mintegral, możesz sprawdzić
bazowego błędu w odpowiedzi na żądanie reklamy za pomocą funkcji
ResponseInfo.getAdapterResponses()
.
w następujących klasach:
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
Oto kody i powiązane z nimi komunikaty wysyłane przez adapter Mintegral gdy nie można wczytać reklamy:
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 | Brak odpowiedzi na pytanie o stawkę lub odpowiedź jest nieprawidłowa. |
104 | com.google.ads.mediation.mintegral | Pakiet Mintegral SDK zwrócił komunikat o błędzie „brak wypełnienia”. |
Mintegral Android Mediation Adapter
Wersja 16.8.31.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.8.31.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 23.2.0.
- Mintegral SDK w wersji 16.8.31.
Wersja 16.8.11.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.8.11.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 23.2.0.
- Mintegral SDK w wersji 16.8.11.
Wersja 16.7.91.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.7.91.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 23.2.0.
- Mintegral SDK w wersji 16.7.91.
Wersja 16.7.81.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.7.81.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 23.2.0.
- Mintegral SDK w wersji 16.7.81.
Wersja 16.7.71.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.7.71.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 23.1.0.
- Mintegral SDK w wersji 16.7.71.
Wersja 16.7.61.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.7.61.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 23.1.0.
- Mintegral SDK w wersji 16.7.61.
Wersja 16.7.51.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.7.51.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 23.1.0.
- Mintegral SDK w wersji 16.7.51.
Wersja 16.7.41.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.7.41.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 23.1.0.
- Mintegral SDK w wersji 16.7.41.
Wersja 16.7.31.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.7.31.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 23.1.0.
- Mintegral SDK w wersji 16.7.31.
Wersja 16.7.21.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.7.21.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 23.0.0.
- Mintegral SDK w wersji 16.7.21.
Wersja 16.7.11.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.7.11.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 23.0.0.
- Mintegral SDK w wersji 16.7.11.
Wersja 16.6.71.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.6.71.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 23.0.0.
- Mintegral SDK w wersji 16.6.71.
Wersja 16.6.61.0
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 23.0.0.
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.6.61.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 23.0.0.
- Mintegral SDK w wersji 16.6.61.
Wersja 16.6.51.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.6.51.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.6.0.
- Mintegral SDK w wersji 16.6.51.
Wersja 16.6.41.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.6.41.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.6.0.
- Mintegral SDK w wersji 16.6.41.
Wersja 16.6.34.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.6.34.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.6.0.
- Mintegral SDK w wersji 16.6.34.
Wersja 16.6.21.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.6.21.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.6.0.
- Mintegral SDK w wersji 16.6.21.
Wersja 16.5.91.1
- Dodaliśmy obsługę określania stawek dla formatu reklam wyświetlanych przy otwarciu aplikacji.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.6.0.
- Mintegral SDK w wersji 16.5.91.
Wersja 16.5.91.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.5.91.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 22.6.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.6.0.
- Mintegral SDK w wersji 16.5.91.
Wersja 16.5.51.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.5.51.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.3.0.
- Mintegral SDK w wersji 16.5.51.
Wersja 16.5.41.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.5.41.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.3.0.
- Mintegral SDK w wersji 16.5.41.
Wersja 16.5.31.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.5.31.
- Zmieniliśmy adapter, by korzystał z pakietu SDK do reklam mobilnych Google w wersji 22.3.0.
- Dodaliśmy obsługę kaskady reklam wyświetlanych przy otwarciu aplikacji.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.3.0.
- Mintegral SDK w wersji 16.5.31.
Wersja 16.5.21.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.5.21.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 22.4.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.4.0.
- Mintegral SDK w wersji 16.5.21.
Wersja 16.5.11.0
- Dodano obsługę znaku wodnego na potrzeby określania stawek za reklamy.
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.5.11.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.2.0.
- Mintegral SDK w wersji 16.5.11.
Wersja 16.4.91.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.4.91.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.2.0.
- Mintegral SDK w wersji 16.4.91.
Wersja 16.4.81.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.4.81.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.2.0.
- Mintegral SDK w wersji 16.4.81.
Wersja 16.4.71.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.4.71.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.2.0.
- Mintegral SDK w wersji 16.4.71.
Wersja 16.4.61.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.4.61.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.1.0.
- Mintegral SDK w wersji 16.4.61.
Wersja 16.4.51.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.4.51.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.1.0.
- Mintegral SDK w wersji 16.4.51.
Wersja 16.4.41.0
- Rozwiązaliśmy problem, który powodował, że banery reklamowe były renderowane w nieprawidłowych rozmiarach.
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.4.41.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
- Mintegral SDK w wersji 16.4.41.
Wersja 16.4.31.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.4.31.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
- Mintegral SDK w wersji 16.4.31.
Wersja 16.4.21.0
- Zaktualizowano adapter, aby używał nowej klasy
VersionInfo
. - Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 22.0.0.
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.4.21.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
- Mintegral SDK w wersji 16.4.21.
Wersja 16.3.91.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.3.91.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
- Mintegral SDK w wersji 16.3.91.
Wersja 16.3.81.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.3.81.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
- Mintegral SDK w wersji 16.3.81.
Wersja 16.3.71.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.3.71.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
- Mintegral SDK w wersji 16.3.71.
Wersja 16.3.61.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.3.61.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
- Mintegral SDK w wersji 16.3.61.
Wersja 16.3.51.1
- Dodaliśmy kaskadową obsługę banerów (w tym MREC), reklam pełnoekranowych, reklam z nagrodą i reklam natywnych.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.5.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
- Mintegral SDK w wersji 16.3.51.
Wersja 16.3.51.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.3.51.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 21.4.0.
- Mintegral SDK w wersji 16.3.51.
Wersja 16.3.41.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 16.3.41.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.4.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 21.4.0.
- Mintegral SDK w wersji 16.3.41.
Wersja 16.3.11.0
- Zweryfikowano zgodność z pakietem SDK Mintegral 16.3.11.
- Zaktualizowano adapter, aby w przypadku wyświetlania reklam z nagrodą przekazywać dalej
onUserEarnedReward()
przedonAdClosed()
.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 21.3.0.
- Mintegral SDK w wersji 16.3.11.
Wersja 16.2.61.0
- Pierwsza wersja!
- Dodaliśmy obsługę określania stawek za banery (w tym MREC), reklamy pełnoekranowe, reklamy z nagrodą i reklamy natywne.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 21.3.0.
- Mintegral SDK w wersji 16.2.61.