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

Integracja Liftoff Zarabiaj z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Liftoff Monetize za pomocą zapośredniczenia AdMob, obejmujących zarówno integrację określania stawek, jak i kaskady. Dowiesz się z niego, jak dodać Liftoff zarabianie do konfiguracji zapośredniczenia jednostki reklamowej, oraz jak zintegrować pakiet SDK i adapter Vungle z aplikacją Android .

Obsługiwane integracje i formaty reklam

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

Integracja
Ustalanie stawek
Wodospad
Formaty
Otwarcie aplikacji	^{1, 3}
Baner	²
Pełnoekranowa
Otrzymano
Pełnoekranowa z nagrodą	²
Natywna	²

¹ Integracja ustalania stawek w tym formacie znajduje się w fazie zamkniętych testów beta.

² Integracja ustalania stawek w tym formacie jest dostępna w otwartej wersji beta.

³ Integracja kaskadowa tego formatu jest w fazie zamkniętych testów 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
Wykonaj 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 poniższe zależności i konfiguracje implementacji. Użyj najnowszych wersji pakietu SDK i adaptera Vungle:

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

Integracja ręczna

Pobierz najnowszy Vungle Android SDK, wyodrębnij pliki .jar z folderu libs i dodaj je do swojego projektu.
Otwórz artefakty adaptera Liftoff Monetize w repozytorium Google Maven. Wybierz najnowszą wersję, pobierz plik .aar adaptera Vungle i dodaj go do projektu.

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

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.

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 użytkowników do pakietu SDK Vungle. Jeśli chcesz wywoływać tę metodę, zalecamy wykonanie jej 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")

Więcej informacji oraz wartości, które można podać w tej metodzie, znajdziesz w instrukcjach implementacji zalecanej przez RODO.

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.

Java

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

VunglePrivacySettings.setCCPAStatus(true);

Kotlin

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

VunglePrivacySettings.setCCPAStatus(true)

Więcej informacji oraz wartości, które można podać w tej metodzie, znajdziesz w artykule o wdrażaniu 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 następujące dodatkowe parametry żądania, które można przekazać 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 obiekty NativeAd . Wypełnia te pola opisów pól reklam natywnych na potrzeby 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

¹ Adapter Liftoff Monetize nie zapewnia bezpośredniego dostępu do głównego komponentu z obrazem reklam natywnych. Zamiast tego adapter wypełnia MediaView filmem lub obrazem.

Kody błędów

Jeśli adapter nie otrzyma reklamy z Liftoff Monetize, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi za pomocą polecenia ResponseInfo.getAdapterResponses() w ramach tych klas:

Format	Nazwa zajęć
Baner	com.vungle.mediation.VungleInterstitialAdapter
Pełnoekranowa	com.vungle.mediation.VungleInterstitialAdapter
Otrzymano	com.vungle.mediation.VungleAdapter

Oto kody i powiązane z nimi komunikaty wysyłane przez adapter Liftoff Monetize w sytuacji, gdy nie udało się wczytać reklamy:

Kod błędu	Domena	Przyczyna
0-100	com.vungle.warren	Pakiet SDK Vungle zwrócił komunikat o błędzie. Więcej informacji znajdziesz w tym dokumencie.
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łowy rozmiar reklamy Liftoff Monetize.
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 z tym samym identyfikatorem miejsca docelowego.
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. Więcej informacji znajdziesz w opisie kodu.
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 wczytać drugiej reklamy z tym samym identyfikatorem miejsca docelowego.
103	com.google.mediation.vungle	Żądany rozmiar reklamy nie pasuje do obsługiwanego rozmiaru banera na platformie Liftoff Monetize.
104	com.google.mediation.vungle	Pakiet Vungle SDK nie mógł wyrenderować banera reklamowego.
105	com.google.mediation.vungle	Pakiet Vungle SDK obsługuje w danym momencie tylko jeden baner reklamowy, niezależnie od identyfikatora miejsca docelowego.
106	com.google.mediation.vungle	Pakiet SDK Vungle wysłał wywołanie zwrotne z informacją, że nie można odtworzyć reklamy.

Liftoff Monetize – historia zmian adaptera zapośredniczenia na Androida