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

Integracja Mintegral z określaniem stawek (beta)

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		¹.
Wodospad		².
Formaty
Otwarcie aplikacji	¹. ².
Baner
Pełnoekranowa
Z nagrodą
Pełnoekranowa z nagrodą
Natywna	¹. ³.

¹ Integracja ustalania stawek jest zamknięta wersji beta.

² 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

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

¹ 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ć bazowy błąd 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”.
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.