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

Integracja zarabiania z wycofaniem z zapośredniczeniem

Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z Liftoff Monetize wykorzystujące zapośredniczenie, obejmujące zarówno integrację określania stawek, jak i kaskady. Wyjaśniamy, jak dodać Liftoff jak zarabiać na konfiguracji zapośredniczenia jednostki reklamowej i jak zintegrować Pakiet SDK Vungle i adapter do aplikacji Android .

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia dla Liftoff Monetize ma następujące możliwości:

Integracja
Określanie stawek	¹
Wodospad
Formaty
Otwarcie aplikacji	.
Baner
Pełnoekranowa
Z nagrodą
Pełnoekranowa z nagrodą	³
Natywna	²

¹ Integracja określania stawek jest w otwartej wersji beta.

² Określanie stawek jest dostępna w zamkniętych testach beta.

³ Reklamy z nagrodą reklama pełnoekranowa wymaga pomocy przy konfigurowaniu. Skontaktuj się ze swoim kontem menedżer w Liftoff Monetize lub monetize@liftoff.io.

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 Liftoff Monetize

Krok 2. Skonfiguruj źródła ofert reklamowych i zarabiaj na nich w Ad Manager interfejsie

Dodaj Liftoff 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ć Liftoff do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w Ad Manager UI.

Krok 3. Zaimportuj pakiet SDK Vungle i adapter

Integracja z Android Studio (zalecana)

W pliku build.gradle.kts na poziomie aplikacji dodaj tę implementację zależności i konfiguracji. Używaj najnowszych wersji Vungle SDK i adapter:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.google.ads.mediation:vungle:7.4.0.1")
}

Integracja ręczna

Pobierz najnowszy pakiet SDK Vungle na Androida. i rozpakuj pliki .jar w folderze libs i dodaj je do w projektach AI.
Przejdź do artefaktów adaptera Liftoff Monetize. w repozytorium Google Maven. Wybierz najnowszą wersję i pobierz Vungle. .aar adaptera i dodaj go do projektu.

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

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.

Liftoff Monetize wykorzystuje interfejs API, który umożliwia przekazywanie zgody do pakietu SDK Vungle. Poniższy przykładowy kod pokazuje, jak przekazać informacje o zgodzie do funkcji Vungle SDK. Jeśli chcesz wywoływać tę metodę, zalecamy jej wykonanie przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

Java

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0");

Kotlin

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0")

Zapoznaj się z instrukcjami implementacji zalecanej przez RODO .

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.

Java

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setCCPAStatus(true);

Kotlin

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setCCPAStatus(true)

Zobacz wdrażanie ustawy CCPA .

Krok 5. Dodaj wymagany kod

Do integracji Liftoff Monetize nie jest wymagany żaden dodatkowy kod.

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby Ad Manager i włącz tryb testowy w Liftoff Monetize interfejsie użytkownika.

Weryfikacja reklam testowych

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

Kroki opcjonalne:

Parametry charakterystyczne dla sieci

Adapter Liftoff Monetize obsługuje poniższe dodatkowe żądanie parametry, które mogą być przekazywane do adaptera:

userId: Ciąg znaków reprezentujący identyfikator użytkownika w ramach zachęty do zarabiania na platformie Liftoff Monetize.
adOrientation: Liczba całkowita określająca orientację prezentacji w przypadku reklam pełnoekranowych.

Oto przykładowy kod, który pokazuje, jak utworzyć żądanie reklamy z tymi parametrami:

Java

Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build();

Kotlin

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter::class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build()

Renderowanie reklam natywnych

Adapter Liftoff Monetize zwraca reklamy natywne jako NativeAd obiektów. Zawiera te dane pola dla NativeAd

Pole	Zasoby zawsze uwzględniane przez adapter Liftoff Monetize
Nagłówek
Obraz	1
Widok multimediów
Treść
Ikona aplikacji
Wezwanie do działania
Ocena w gwiazdkach
Sklep
Cena

¹ – Liftoff – przychody adapter nie zapewnia bezpośredniego dostępu do głównego zasobu graficznego dla kreacji natywnej. reklam. Zamiast tego adapter wypełnia pole MediaView. z filmem lub obrazem.

Kody błędów

Jeśli adapter nie otrzyma reklamy z Liftoff Monetize, wydawcy mogą sprawdź przyczynę błędu w odpowiedzi za pomocą polecenia ResponseInfo.getAdapterResponses(). w następujących klasach:

Format	Nazwa zajęć
Otwarcie aplikacji (określanie stawek)	com.google.ads.mediation.vungle.VungleMediationAdapter
Otwarcie aplikacji (wodospad)	com.google.ads.mediation.vungle.VungleMediationAdapter
Baner (określanie stawek)	com.google.ads.mediation.vungle.VungleMediationAdapter
Baner (wodospad)	com.vungle.mediation.VungleInterstitialAdapter
Reklama pełnoekranowa (określanie stawek)	com.google.ads.mediation.vungle.VungleMediationAdapter
Reklama pełnoekranowa (wodospad)	com.vungle.mediation.VungleInterstitialAdapter
Reklamy z nagrodą (określanie stawek)	com.google.ads.mediation.vungle.VungleMediationAdapter
Z nagrodą (wodospad)	com.vungle.mediation.VungleAdapter
Reklama pełnoekranowa z nagrodą (określanie stawek)	com.google.ads.mediation.vungle.VungleMediationAdapter
Reklama pełnoekranowa z nagrodą (wodospad)	com.google.ads.mediation.vungle.VungleMediationAdapter
Natywna (określanie stawek)	com.google.ads.mediation.vungle.VungleMediationAdapter
Natywna (wodospad)	com.google.ads.mediation.vungle.VungleMediationAdapter

Oto kody i powiązane z nimi wiadomości wysyłane przez Liftoff Monetize adaptera, gdy reklama nie wczytuje się:

Kod błędu	Domena	Przyczyna
101	com.google.ads.mediation.vungle	Nieprawidłowe parametry serwera (np. identyfikator aplikacji lub miejsca docelowego).
102	com.google.ads.mediation.vungle	Żądany rozmiar banera nie jest zmapowany na prawidłową reklamę Liftoff Monetize rozmiaru.
103	com.google.ads.mediation.vungle	Liftoff Monetize wymaga `Activity`kontekstu, aby wysłać żądanie reklam.
104	com.google.ads.mediation.vungle	Pakiet SDK Vungle nie może wczytać wielu reklam w tym samym miejscu docelowym ID.
105	com.google.ads.mediation.vungle	Nie udało się zainicjować pakietu SDK Vungle.
106	com.google.ads.mediation.vungle	Pakiet SDK Vungle zwrócił pomyślne wywołanie zwrotne wczytywania, ale funkcja Banners.getBanner() lub Vungle.getNativeAd() zwróciło wartość null.
107	com.google.ads.mediation.vungle	Pakiet Vungle SDK nie jest gotowy do wyświetlenia reklamy.
108	com.google.ads.mediation.vungle	Pakiet SDK Vungle zwrócił nieprawidłowy token ustalania stawek.

Informacje o błędach pochodzących z pakietu Vungle SDK znajdziesz w artykule Kody błędów: Vungle SDK na iOS i Androida.