Ta strona została przetłumaczona przez Cloud Translation API.

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 za pomocą zapośredniczenia obejmujących zarówno kaskady, jak i integracje określania stawek. Dowiesz się z niego, 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 do Mintegral ma te funkcje:

Integracja
Ustalanie stawek		¹
Wodospad		²
Formaty
Otwarcie aplikacji	¹ ²
Baner
Pełnoekranowa
Otrzymano
Pełnoekranowa z nagrodą
Natywna	¹ ³

¹ Integracja ustalania stawek jest w fazie zamkniętych testów beta.

² Integracja kaskadowa jest dostępna w zamkniętych testach beta.

Wymagania

Interfejs API Androida na poziomie 21 lub wyższym

Najnowszy pakiet SDK do reklam mobilnych Google
Wykonaj zapośredniczenie Przewodnik dla początkujących

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 Ad Manager interfejsie użytkownika

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

Integracja z Android Studio (zalecana)

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 poniższe 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.2.0")
    implementation("com.google.ads.mediation:mintegral:16.7.81.0")
}

Integracja ręczna

Aby dołączyć pakiet SDK Mintegral, przejdź do Mintegral SDK na Androida.
Przejdź do artefaktów adaptera Mintegral w repozytorium Google Maven. Wybierz najnowszą wersję, pobierz plik .aar adaptera Mintegral i dodaj go do projektu.

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

Zgoda użytkowników z UE i RODO

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali określone informacje na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz aby uzyskać od nich zgodę. 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). Podczas uzyskiwania zgody musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe, a także podać informacje o sposobie ich wykorzystania. Obecnie Google nie może automatycznie przekazać tym sieciom wyboru użytkownika dotyczącego zgody.

Pakiet Mintegral SDK zawiera metodę setConsentStatus do przekazywania informacji o zgodzie do pakietu SDK Mintegral.

Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie użytkowników do pakietu SDK Mintegral. Te opcje należy ustawić przed zainicjowaniem pakietu SDK do reklam mobilnych Google, aby zostały prawidłowo przekierowane 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 Mintegral dotyczące ochrony prywatności.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają umożliwienia użytkownikom wycofania zgody na sprzedaż danych osobowych (w znaczeniu określonym w ustawie), za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej sprzedawcy. 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 każdej sieci reklamowej w łańcuchu zapośredniczenia. Musisz więc wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i zastosować się do zaleceń każdej z nich, by zapewnić zgodność z zasadami.

Pakiet Mintegral SDK zawiera metodę setDoNotTrackStatus do przekazywania informacji o zgodzie do pakietu SDK Mintegral.

Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie użytkowników 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 Mintegral dotyczące ochrony 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 artykule Ustawienia CCPA aby dodać Mintegral do listy partnerów reklamowych CCPA wAd Manager interfejsie.

Reklamy natywne

Renderowanie reklam

Adapter Mintegral zwraca reklamy natywne jako obiekty NativeAd . Uzupełnia te pola 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

¹ Adapter Mintegral nie zapewnia bezpośredniego dostępu do głównego zasobu graficznego reklam natywnych. Zamiast tego wypełnia on pola MediaView filmem lub obrazem.

Kody błędów

Jeśli adapter nie otrzyma reklamy z Mintegral, możesz sprawdzić podstawowy błąd w odpowiedzi na reklamę, używając polecenia ResponseInfo.getAdapterResponses() w ramach tych klas:

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

Oto kody i powiązane z nimi komunikaty wysyłane przez adapter Mintegral, gdy nie uda się 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”.
101	com.google.mediation.mintegral	Nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub miejsca docelowego).
102	com.google.mediation.mintegral	Pakiet Mintegral SDK zwrócił komunikat o błędzie „brak wypełnienia”.
103	com.google.mediation.mintegral	Pakiet Mintegral SDK nie wyświetlił reklamy.
104	com.google.mediation.mintegral	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Mintegral.