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

Integracja Liftoff Zarabiaj 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 AdMob, 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	^{1, 3}
Baner	²
Pełnoekranowa
Z nagrodą
Pełnoekranowa z nagrodą	²
Natywna	²

¹ Ustalanie stawek jest dostępna w zamkniętych testach beta.

² Określanie stawek dla tego formatu jest w otwartej wersji beta.

³ Kaskada jest dostępna w zamkniętych testach beta.

Wymagania

Interfejs API Androida na poziomie 21 lub wyższym
[Do określania stawek]: adapter Liftoff Monetize w wersji 6.11.0.2 lub nowszej (zalecana najnowsza wersja)

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

Krok 1. Skonfiguruj konfiguracje w interfejsie Liftoff Monetize

Zarejestruj się lub zaloguj na konto Liftoff Monetize.

Dodaj swoją aplikację do panelu Liftoff Monetize, klikając przycisk Dodaj aplikację.

Wypełnij formularz, podając wszystkie niezbędne informacje.

Po utworzeniu aplikacji wybierz ją w panelu Liftoff Monetize Applications.

Zapisz identyfikator aplikacji.

Dodawanie nowych miejsc docelowych

Aby utworzyć nowe miejsce docelowe, AdMob które będzie korzystać z zapośredniczenia, przejdź do panelu Zarabianie na miejscach docelowych, kliknij przycisk Dodaj miejsce docelowe i wybierz aplikację z listy.

Szczegółowe informacje o dodawaniu nowych miejsc docelowych znajdziesz poniżej:

Otwarcie aplikacji

Wybierz Reklama pełnoekranowa i wpisz Nazwę miejsca docelowego. Następnie dla opcji Możliwe do pominięcia wybierz Tak i wypełnij resztę formularza. [Dotyczy tylko określania stawek] W sekcji Generowanie przychodu przełącz opcję Określanie stawek w aplikacji na Włączone. Kliknij przycisk Dalej u dołu strony, by utworzyć miejsce docelowe.

Wybierz Baner, wpisz nazwę miejsca docelowego i wypełnij pozostałe pola formularza. [Dotyczy tylko określania stawek] W sekcji Generowanie przychodu przełącz opcję Określanie stawek w aplikacji na Włączone. Kliknij przycisk Dalej u dołu strony, aby utworzyć miejsce docelowe.

Wybierz MREC, wpisz nazwę miejsca docelowego i wypełnij pozostałe pola formularza. [Dotyczy tylko określania stawek] W sekcji Generowanie przychodu przełącz opcję Określanie stawek w aplikacji na Włączone. Kliknij przycisk Dalej u dołu strony, aby utworzyć miejsce docelowe.

Pełnoekranowa

Wybierz Reklama pełnoekranowa, wpisz nazwę miejsca docelowego i wypełnij pozostałe pola formularza. [Dotyczy tylko określania stawek] W sekcji Generowanie przychodu przełącz opcję Określanie stawek w aplikacji na Włączone. Aby utworzyć miejsce docelowe, kliknij przycisk Dalej u dołu strony.

Otrzymano

Wybierz Reklama z nagrodą, wpisz nazwę miejsca docelowego i wypełnij pozostałe pola formularza. [Dotyczy tylko określania stawek] W sekcji Generowanie przychodu przełącz opcję Określanie stawek w aplikacji na Włączone. Kliknij przycisk Dalej u dołu strony, aby utworzyć miejsce docelowe.

Pełnoekranowa z nagrodą

Wybierz Z nagrodą. W polu Nazwa miejsca docelowego włącz opcję Możliwe do pominięcia i wypełnij resztę formularza. [Tylko określanie stawek] W sekcji Generowanie przychodu ustaw przełącznik Określanie stawek w aplikacji na Włączone. Aby utworzyć miejsce docelowe, kliknij przycisk Dalej u dołu strony.

Natywna

Wybierz Natywna, wpisz nazwę miejsca docelowego i wypełnij pozostałe pola formularza. [Dotyczy tylko określania stawek] W sekcji Generowanie przychodu przełącz opcję Określanie stawek w aplikacji na Włączone. Kliknij przycisk Dalej u dołu strony, aby utworzyć miejsce docelowe.

Zanotuj identyfikator referencyjny i kliknij Dźwięki dobrze.

Otwarcie aplikacji

Baner

Baner 300 x 250

Pełnoekranowa

Otrzymano

Pełnoekranowa z nagrodą

Natywna

Znajdowanie klucza interfejsu API do raportowania

Ustalanie stawek

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

Wodospad

Oprócz identyfikatora aplikacji i identyfikatora referencyjnego potrzebujesz też klucza interfejsu API do raportowania Liftoff Monetize, aby móc skonfigurowaćAdMob identyfikator jednostki reklamowej. Otwórz panel raportów Liftoff Monetize i kliknij przycisk Reporting API Key (Klucz interfejsu API do raportowania), aby wyświetlić klucz interfejsu API do raportowania.

Włącz tryb testowy

Aby włączyć reklamy testowe, otwórz panel Liftoff Monetize i przejdź do sekcji Aplikacje.

W sekcji Identyfikator referencyjny miejsca docelowego wybierz aplikację, w której chcesz włączyć reklamy testowe. Aby je włączyć, w sekcji Stan wybierz Tryb testowy na Wyświetlaj tylko reklamy testowe.

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

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać Liftoff Monetize do konfiguracji zapośredniczenia jednostki reklamowej.

Najpierw zaloguj się na swoje konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź od razu do sekcji Dodawanie Liftoff Monetize jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, wybierz Utwórz grupę zapośredniczenia.

Podaj format reklamy i platformę, a następnie kliknij Dalej.

Nazwij grupę zapośredniczenia i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z co najmniej jedną istniejącą jednostką reklamowąAdMob . Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny się pojawić wybrane przez Ciebie jednostki reklamowe:

Dodaj Liftoff Monetize jako źródło reklam

Ustalanie stawek

Na karcie Określanie stawek w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie kliknij Liftoff Monetize.

Kliknij Jak podpisać umowę partnerską i zawrzeć umowę partnerską z firmąLiftoff Monetize.

Kliknij Potwierdzam i akceptuję, a następnie kliknij Dalej.

Jeśli masz już mapowanie Liftoff Monetize, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz dane Application ID and Placement Reference IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.

Ważne: Application ID musi być powiązany z aplikacją docelową, tak jak w interfejsieLiftoff Monetize .

Wodospad

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklamy. Następnie kliknij Liftoff Monetize.

Kliknij Liftoff Monetize i włącz przełącznik Optymalizuj. Wpisz Reporting API Keyuzyskane w poprzedniej sekcji, aby skonfigurować optymalizację źródła reklam dla:Liftoff Monetize. Następnie wpisz wartość eCPM dlaLiftoff Monetize i kliknij Dalej.

Jeśli masz już mapowanie Liftoff Monetize, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz dane Application ID and Placement Reference IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.

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 AdMob 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.2.0")
    implementation("com.google.ads.mediation:vungle:7.4.0.0")
}

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 AdMob 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);

Żądanie AdRequest request = new Żądanie AdRequest.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 = Żądanie AdRequest.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 opisy pól reklam natywnych 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

¹ – wzrost przychodów – 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ęć
Baner	com.vungle.mediation.VungleInterstitialAdapter
Pełnoekranowa	com.vungle.mediation.VungleInterstitialAdapter
Z nagrodą	com.vungle.mediation.VungleAdapter

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
0-100	com.vungle.warren	Pakiet SDK Vungle zwrócił komunikat o błędzie. Zobacz dokument .
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 kontekstu `Activity`, aby wysyłać żądania 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 funkcje Banners.getBanner() lub Vungle.getNativeAd() zwróciły wartość null.
107	com.google.ads.mediation.vungle	Pakiet Vungle SDK nie jest gotowy do wyświetlenia reklamy.
1-100	Wysłane przez Vungle SDK	Pakiet SDK Vungle zwrócił komunikat o błędzie. Zobacz kod .
101	com.google.mediation.vungle	Liftoff Monetize nie może zawierać parametrów serwera skonfigurowanych w AdMob interfejsie lub są nieprawidłowe.
102	com.google.mediation.vungle	Reklama została już wczytana na potrzeby tej konfiguracji sieci. Vungle SDK nie może wczytanie drugiej reklamy z tym samym identyfikatorem miejsca docelowego.
103	com.google.mediation.vungle	Żądany rozmiar reklamy nie pasuje do obsługiwanego banera Liftoff Monetize rozmiaru.
104	com.google.mediation.vungle	Pakiet Vungle SDK nie mógł wyrenderować banera reklamowego.
105	com.google.mediation.vungle	Vungle SDK obsługuje wczytywanie tylko jednego banera reklamowego naraz, bez względu na identyfikator miejsca docelowego.
106	com.google.mediation.vungle	Pakiet SDK Vungle wysłał wywołanie zwrotne z informacją, że nie można odtworzyć reklamy.