Integracja Mintegral z określaniem stawek (beta)

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Mintegral przy użyciu 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ą Android .

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia Ad Manager 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
1 Integracja z określaniem stawek znajduje się w fazie zamkniętych testów beta.

2 Integracja kaskadowa jest obecnie w fazie zamkniętych testów beta.

Wymagania

  • Interfejs API Androida na poziomie 21 lub wyższym

  • Najnowszy pakiet SDK do reklam mobilnych Google

  • 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.

Zanotuj identyfikator aplikacji.

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.

Wypełnij pola Nazwa 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.

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

Znajdowanie klucza interfejsu Mintegral Reporting API

Ustalanie stawek

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

Wodospad

Aby skonfigurowaćAd Manager 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 Ad Manager

Zaloguj się na konto Ad Managera.

Dodaj Mintegral do firm

Ustalanie stawek

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

Wodospad

Przejdź do sekcji Administracja > Firmy i kliknij przycisk Nowa firma na karcie Wszystkie firmy. Kliknij Sieć reklamowa.

Jako Sieć reklamowa wybierz Mintegral, wpisz niepowtarzalną nazwę i włącz Zapośredniczenie.

Nie musisz wpisywać nazwy użytkownika ani hasła. Gdy skończysz, kliknij Zapisz.

Włącz udostępnianie bezpiecznych sygnałów

Ustalanie stawek

Kliknij Administracja > Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange, sprawdź i włącz Udostępnianie bezpiecznych sygnałów. Kliknij Save (Zapisz).

Wodospad

W przypadku integracji kaskady ten krok nie jest wymagany.

Skonfiguruj Mintegral określanie stawek

Ustalanie stawek

Kliknij Wyświetlanie > Licytujący, a potem na karcie Określanie stawek przez pakiet SDK kliknij Nowy licytujący.

Jako licytującego wybierz Mintegral.

Przesuń przełącznik obok opcji Dodaj bibliotekę sygnałów tego licytującego do listy dozwolonych sygnałów i Zezwalaj na udostępnianie sygnałów temu licytującemu. Następnie kliknij Dalej.

Kliknij Dalej.

Kliknij Gotowe.

Wodospad

W przypadku integracji kaskady ten krok nie jest wymagany.

Skonfiguruj mapowanie jednostki reklamowej

Ustalanie stawek

Kliknij Wyświetlanie > Licytujący i na karcie Określanie stawek przez pakiet SDK wybierz firmę, dla której chcesz utworzyćMintegral .

Otwórz kartę Mapowanie jednostki reklamowej i kliknij Nowe mapowanie jednostek reklamowych.

Kliknij Konkretna jednostka reklamowa. Wybierz jednostkę reklamową i format, jako Typ zasobów reklamowych wybierz Aplikacja mobilna i kliknij Aplikacja mobilna. Następnie wpiszApp Key, App ID, Placement ID, and Ad Unit ID otrzymane w poprzedniej sekcji. Na koniec kliknij Zapisz.

Wodospad

Kliknij Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku. Wybierz aplikację mobilną.

Przewiń w dół i kliknij Dodaj partnera zysku.

Wybierz firmę, dla której utworzyliśmy Mintegral w poprzedniej sekcji. Jako Typ integracji wybierz Zapośredniczenie mobilne SDK, Android jako Platformę i Aktywne jako Stan.

Wpisz wartość App Key, App ID, Placement ID, and Ad Unit IDuzyskaną w poprzedniej sekcji oraz wartość Domyślny CPM. Kliknij Zapisz.

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 i adapter Mintegral

W pliku settings.gradle.kts na poziomie projektu dodaj te 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 podane niżej zależności i konfiguracje implementacji. Użyj najnowszych wersji pakietu SDK i adaptera Mintegral:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:mintegral:16.6.61.0")
}

Integracja ręczna

  1. Aby dołączyć pakiet SDK Mintegral, przeczytaj artykuł Mintegral SDK na Androida.

  2. Otwórz artefakty adaptera Mintegral w repozytorium Google Maven. Wybierz najnowszą wersję, pobierz plik .aar adaptera Mintegral i dodaj go do swojego projektu.

Krok 4. Zaimplementuj ustawienia prywatności w pakiecie Mintegral SDK

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) udzielili określonych informacji na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz uzyskali od nich odpowiednie zgody. 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). Żeby uzyskać zgodę na wykorzystanie danych, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub wykorzystywać dane osobowe, a także dostarczać informacje o korzystaniu z nich przez poszczególne sieci. Obecnie Google nie może automatycznie przekazać zgody użytkownika na wykorzystanie danych do takich sieci.

Pakiet Mintegral SDK zawiera metodę setConsentStatus, która umożliwia przekazywanie informacji o zgodzie do pakietu SDK Mintegral.

Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK Mintegral. Te opcje musisz skonfigurować przed zainicjowaniem pakietu SDK do reklam mobilnych Google, aby 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)

Więcej informacji znajdziesz w dokumentacji dotyczącej prywatności w Mintegral.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają przyznania użytkownikom prawa do wycofania zgody na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie), przy czym opcja ta jest dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej sprzedającego. Przewodnik dotyczący zgodności z amerykańskimi przepisami stanowymi o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych na potrzeby wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia do żadnej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność z zasadami.

Pakiet Mintegral SDK zawiera metodę setDoNotTrackStatus, która umożliwia przekazywanie informacji o zgodzie do pakietu SDK Mintegral.

Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK Mintegral. Jeśli musisz wywołać tę metodę, wywołaj ją po zainicjowaniem pakietu SDK do reklam mobilnych Google ale przed wysłaniem żądania reklam 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)

Więcej informacji znajdziesz w dokumentacji dotyczącej prywatności w Mintegral.

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:

Dodawanie Mintegral do listy partnerów reklamowych zgodnych z CCPA

Wykonaj czynności opisane w sekcji Ustawienia CCPA Aby dodać Mintegral do listy partnerów reklamowych CCPA wAd Manager interfejsie użytkownika.

Reklamy natywne

Renderowanie reklam

Adapter Mintegral zwraca reklamy natywne jako obiekty NativeAd . Uzupełnia te 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 zapewnia bezpośredniego dostępu do głównego komponentu z obrazem w przypadku reklam natywnych. Zamiast tego adapter wypełnia MediaView filmem lub obrazem.

Kody błędów

Jeśli adapter nie odbierze reklamy z Mintegral, możesz sprawdzić podstawowy błąd w odpowiedzi reklamy, używając właściwości ResponseInfo.getAdapterResponse() dostępnych w tych 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 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”.
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 Android Mediation

Wersja 16.6.51.0

  • Zweryfikowana zgodność z Mintegral SDK 16.6.51.

Stworzone i przetestowane w:

  • Pakietu SDK do reklam mobilnych Google w wersji 22.6.0.
  • Mintegral SDK w wersji 16.6.51.

Wersja 16.6.41.0

  • Zweryfikowana zgodność z Mintegral SDK 16.6.41.

Stworzone i przetestowane w:

  • Pakietu SDK do reklam mobilnych Google w wersji 22.6.0.
  • Mintegral SDK w wersji 16.6.41.

Wersja 16.6.34.0

  • Zweryfikowana zgodność z Mintegral SDK 16.6.34.

Stworzone i przetestowane w:

  • Pakietu SDK do reklam mobilnych Google w wersji 22.6.0.
  • Mintegral SDK w wersji 16.6.34.

Wersja 16.6.21.0

  • Zweryfikowana zgodność z Mintegral SDK 16.6.21.

Stworzone i przetestowane w:

  • Pakietu 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 w przypadku formatu reklamy wyświetlanej przy otwarciu aplikacji.

Stworzone i przetestowane w:

  • Pakietu SDK do reklam mobilnych Google w wersji 22.6.0.
  • Mintegral SDK w wersji 16.5.91.

Wersja 16.5.91.0

  • Zweryfikowana zgodność z Mintegral SDK 16.5.91.
  • Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 22.6.0.

Stworzone i przetestowane w:

  • Pakietu SDK do reklam mobilnych Google w wersji 22.6.0.
  • Mintegral SDK w wersji 16.5.91.

Wersja 16.5.51.0

  • Zweryfikowana zgodność z Mintegral SDK 16.5.51.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.3.0.
  • Mintegral SDK w wersji 16.5.51.

Wersja 16.5.41.0

  • Zweryfikowana zgodność z Mintegral SDK 16.5.41.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.3.0.
  • Mintegral SDK w wersji 16.5.41.

Wersja 16.5.31.0

  • Zweryfikowana zgodność z Mintegral SDK 16.5.31.
  • Przywróciliśmy adapter, aby zależał od pakietu SDK do reklam mobilnych Google w wersji 22.3.0.
  • Dodaliśmy obsługę kaskady w przypadku formatu reklamy wyświetlanej przy otwarciu aplikacji.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.3.0.
  • Mintegral SDK w wersji 16.5.31.

Wersja 16.5.21.0

  • Zweryfikowana zgodność z Mintegral SDK 16.5.21.
  • Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 22.4.0.

Stworzone i przetestowane w:

  • Pakietu 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 reklam z określaniem stawek.
  • Zweryfikowana zgodność z Mintegral SDK 16.5.11.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.2.0.
  • Mintegral SDK w wersji 16.5.11.

Wersja 16.4.91.0

  • Zweryfikowana zgodność z Mintegral SDK 16.4.91.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.2.0.
  • Mintegral SDK w wersji 16.4.91.

Wersja 16.4.81.0

  • Zweryfikowana zgodność z Mintegral SDK 16.4.81.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.2.0.
  • Mintegral SDK w wersji 16.4.81.

Wersja 16.4.71.0

  • Zweryfikowana zgodność z Mintegral SDK 16.4.71.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.2.0.
  • Mintegral SDK w wersji 16.4.71.

Wersja 16.4.61.0

  • Zweryfikowana zgodność z Mintegral SDK 16.4.61.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.1.0.
  • Mintegral SDK w wersji 16.4.61.

Wersja 16.4.51.0

  • Zweryfikowana zgodność z Mintegral SDK 16.4.51.

Stworzone i przetestowane w:

  • 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.
  • Zweryfikowana zgodność z Mintegral SDK 16.4.41.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
  • Mintegral SDK w wersji 16.4.41.

Wersja 16.4.31.0

  • Zweryfikowana zgodność z Mintegral SDK 16.4.31.

Stworzone i przetestowane w:

  • 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ą wersję pakietu SDK do reklam mobilnych Google do wersji 22.0.0.
  • Zweryfikowana zgodność z Mintegral SDK 16.4.21.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
  • Mintegral SDK w wersji 16.4.21.

Wersja 16.3.91.0

  • Zweryfikowana zgodność z Mintegral SDK 16.3.91.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
  • Mintegral SDK w wersji 16.3.91.

Wersja 16.3.81.0

  • Zweryfikowana zgodność z Mintegral SDK 16.3.81.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
  • Mintegral SDK w wersji 16.3.81.

Wersja 16.3.71.0

  • Zweryfikowana zgodność z Mintegral SDK 16.3.71.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
  • Mintegral SDK w wersji 16.3.71.

Wersja 16.3.61.0

  • Zweryfikowana zgodność z Mintegral SDK 16.3.61.

Stworzone i przetestowane w:

  • 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 obsługę kaskady dla formatów banerów (w tym MREC), reklam pełnoekranowych, reklam z nagrodą i reklam natywnych.
  • Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 21.5.0.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
  • Mintegral SDK w wersji 16.3.51.

Wersja 16.3.51.0

  • Zweryfikowana zgodność z Mintegral SDK 16.3.51.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.4.0.
  • Mintegral SDK w wersji 16.3.51.

Wersja 16.3.41.0

  • Zweryfikowana zgodność z Mintegral SDK 16.3.41.
  • Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 21.4.0.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.4.0.
  • Mintegral SDK w wersji 16.3.41.

Wersja 16.3.11.0

  • Zweryfikowana zgodność z Mintegral SDK 16.3.11.
  • Zaktualizowano adapter podczas wyświetlania reklam z nagrodą w celu przekierowania onUserEarnedReward() przed onAdClosed().

Stworzone i przetestowane w:

  • 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 w przypadku formatów banerów (w tym MREC), reklam pełnoekranowych, reklam z nagrodą i reklam natywnych.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.3.0.
  • Mintegral SDK w wersji 16.2.61.