Integracja Liftoff Zarabiaj z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Liftoff Monetize za pomocą mediacji. Obejmuje on integrację z licytacją i metodą kaskadową. Przewodnik zawiera informacje o dodawaniu pakietu Liftoff Monetize do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera Vungle z aplikacjąUnity .

Obsługiwane integracje i formaty reklam

Integracja
Określanie stawek 1
Wodospad
Formaty
Otwarcie aplikacji 2
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą

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

2 Integracja formatu kaskadowego jest w otwartej fazie beta.

Wymagania

  • Najnowsza wersja pakietu SDK do reklam mobilnych Google
  • Unity w wersji 4 lub nowszej
  • (do określania stawek): wtyczka pośrednictwa reklam mobilnych Google dla Liftoff Monetize w wersji 3.8.2 lub nowszej (zalecana najnowsza wersja)
  • Aby wdrożyć na Androidzie:
    • Poziom interfejsu API 21 lub nowszy
  • Aby wdrożyć aplikację na iOS:
    • docelowa wersja iOS 12.0 lub nowsza
  • działający Unity projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.

Krok 1. Skonfiguruj konfiguracje w interfejsie Liftoff Monetize

Zarejestruj się lub zaloguj się na swoje konto Liftoff Monetize.

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

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

Android

iOS

Po utworzeniu aplikacji wybierz ją na panelu aplikacji Liftoff Monetize.

Android

iOS

Zanotuj identyfikator aplikacji.

Android

iOS

Dodawanie nowych miejsc docelowych

Aby utworzyć nowe miejsce docelowe do użycia z mediacją AdMob, otwórz panel Monetyzacja miejsc docelowych Liftoff, kliknij przycisk Dodaj miejsce docelowe i wybierz swoją aplikację z menu.

Szczegółowe informacje o dodawaniu nowych miejsc docelowych:

Otwarcie aplikacji

Wybierz Interstitial i wpisz Nazwa miejsca docelowego. Następnie w polu Możliwość pominięcia kliknij Tak i uzupełnij resztę formularza. [Dotyczy tylko ustalania stawek] W sekcji Generowanie przychodu ustaw przełącznik Ustalanie stawek w aplikacji w pozycji Włączone. Aby utworzyć miejsce docelowe, kliknij przycisk Dalej na dole strony.

Wybierz Baner, wpisz Nazwa miejsca docelowego i wypełnij pozostałą część formularza. [Dotyczy tylko ustalania stawek] W sekcji Generowanie przychodu ustaw przełącznik Ustalanie stawek w aplikacji w pozycji Włączone. Aby utworzyć miejsce docelowe, kliknij przycisk Dalej na dole strony.

Baner 300 x 250

Wybierz MREC, wpisz Nazwa miejsca docelowego i wypełnij pozostałą część formularza. [Dotyczy tylko ustalania stawek] W sekcji Generowanie przychodu ustaw przełącznik Ustalanie stawek w aplikacji w pozycji Włączone. Aby utworzyć miejsce docelowe, kliknij przycisk Dalej na dole strony.

Pełnoekranowa

Wybierz Reklama pełnoekranowa, wpisz Nazwa miejsca docelowego i uzupełnij pozostałą część formularza. [Tylko ustalanie stawek] W sekcji Generowanie przychodu ustaw przełącznik Ustalanie stawek w aplikacji w pozycji Włączone. Aby utworzyć miejsce docelowe, kliknij przycisk Dalej na dole strony.

Z nagrodą

Kliknij Reklamy z nagrodą, wpisz Nazwa miejsca docelowego i uzupełnij pozostałą część formularza. [Dotyczy tylko ustalania stawek] W sekcji Generowanie przychodu ustaw przełącznik Ustalanie stawek w aplikacji w pozycji Włączone. Aby utworzyć miejsce docelowe, kliknij przycisk Dalej na dole strony.

Reklama pełnoekranowa z nagrodą

Wybierz Z nagrodą. Wpisz nazwę miejsca docelowego, zaznacz opcję Możliwość pominięcia i wypełnij pozostałe pola formularza. [Dotyczy tylko określania stawek] W sekcji Generowanie przychodu ustaw przełącznik Określanie stawek w aplikacji w pozycji Włączone. Aby utworzyć miejsce docelowe, kliknij przycisk Dalej na dole strony.

Natywna

Wybierz Natywna, wpisz Nazwa miejsca docelowego i uzupełnij pozostałą część formularza. [Dotyczy tylko ustalania stawek] W sekcji Generowanie przychodu ustaw przełącznik Ustalanie stawek w aplikacji w pozycji Włączone. Aby utworzyć miejsce docelowe, kliknij przycisk Dalej na dole strony.

Zanotuj identyfikator referencyjny i kliknij OK.

Otwarcie aplikacji

Baner 300 x 250

Pełnoekranowa

Z nagrodą

Reklama pełnoekranowa z nagrodą

Natywna

Znajdowanie klucza interfejsu API raportowania

Określanie stawek

Ten krok nie jest wymagany w przypadku integracji określania stawek.

Wodospad

Aby skonfigurować identyfikator jednostki reklamowej AdMob, oprócz identyfikatora aplikacji i identyfikatora referencyjnego musisz podać klucz interfejsu API do raportowania z Liftoff Monetize. Otwórz panel raportów Liftoff Monetize i kliknij przycisk Klucz interfejsu API do raportowania, aby wyświetlić klucz interfejsu API do raportowania.

Włączanie trybu testowego

Aby włączyć reklamy testowe, otwórz panel Liftoff Monetize i kliknij Aplikacje.

W sekcji Identyfikator referencyjny miejsca docelowego wybierz aplikację, w której chcesz włączyć reklamy testowe. W sekcji Stan wybierz Tryb testowy, aby wyświetlać tylko reklamy testowe.

Android

iOS

Krok 2. Skonfiguruj w  Ad Manager UI usługę Monetyzacja za pomocą Liftoff

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.

Dodawanie Liftoff do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA

Aby dodać Liftoff do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA w interfejsie AdMob, wykonaj czynności opisane w ustawieniach RODO i ustawieniach dotyczących przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK Vungle i adapter Liftoff Monetize

Pobierz najnowszą wersję wtyczki pośrednictwa reklam mobilnych Google dla Liftoff Monetize, korzystając z linku do pobrania w Changelog, i rozpakuj plik GoogleMobileAdsVungleMediation.unitypackage z pliku ZIP.

W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Własny pakiet i znajdź pobrany plik GoogleMobileAdsVungleMediation.unitypackage. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.

Następnie kliknij Zasoby > Rozwiązanie problemów z usługami Play > Rozwiązanie problemów z Androidem > Wymuś rozwiązanie. Biblioteka Unity Play Services Resolver wykona rozwiązanie zależności od podstaw i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android aplikacji w Unity.

Krok 4. Wprowadź ustawienia prywatności w pakiecie SDK Liftoff Monetize

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz zadbać o to, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali odpowiednie informacje i wyrazili zgodę na wykorzystywanie identyfikatorów urządzeń i danych osobowych. 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). Aby uzyskać zgodę, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub używać danych osobowych, oraz podać informacje o wykorzystywaniu tych danych przez każdą z nich. Obecnie Google nie może automatycznie przekazywać wyboru użytkownika dotyczącego wyrażenia zgody do takich sieci.

Wtyczka zapośredniczająca Google Mobile Ads dla Liftoff Monetize zawiera metody przekazywania informacji o zgodzie do pakietu SDK Vungle. Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK Vungle. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetGDPRStatus(true, "v1.0.0");
#if UNITY_IPHONE
LiftoffMonetize.SetGDPRMessageVersion("v1.0.0");
#endif

Więcej informacji na temat implementacji zalecanej przez RODO znajdziesz w Android i iOS. Znajdziesz tam też wartości, które można podać w ramach tej metody.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności nakładają na Ciebie obowiązek zapewnienia użytkownikom możliwości wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu musisz umieścić na stronie głównej podmiotu sprzedającego dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”). Przewodnik po przepisach stanowych USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w przypadku wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia w przypadku każdej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność.

Wtyczka zapośredniczająca Google Mobile Ads dla Liftoff Monetize zawiera metody przekazywania informacji o zgodzie do pakietu SDK Vungle. Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK Vungle. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetCCPAStatus(true);

Więcej informacji oraz wartości, które można podać w ramach tej metody, znajdziesz w rekomendowanych instrukcjach implementacji CCPA na Android i iOS.

Krok 5. Dodaj wymagany kod

Android

Integracja z Liftoff Monetize nie wymaga dodatkowego kodu.

iOS

Integracja z SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją Liftoff Monetize.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob i włączyć tryb testowy w interfejsie Liftoff Monetize.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z Liftoff Monetize, włącz testowanie pojedynczego źródła reklam w inspektorze reklam za pomocą źródeł reklam Liftoff Monetize (ustalanie stawek) i Liftoff Monetize (kaskada).

Kody błędów

Jeśli adapter nie otrzyma reklamy z Liftoff Monetize, wydawcy mogą sprawdzić błąd w odpowiedzi reklamy, korzystając z ResponseInfo w ramach tych klas:

Android

Format Nazwa zajęć
Reklama wyświetlana przy otwarciu aplikacji (ustalanie stawek) com.google.ads.mediation.vungle.VungleMediationAdapter
Przy otwarciu aplikacji (kaskada) com.google.ads.mediation.vungle.VungleMediationAdapter
Baner (ustalanie stawek) com.google.ads.mediation.vungle.VungleMediationAdapter
Baner (kaskada) com.vungle.mediation.VungleInterstitialAdapter
Reklama pełnoekranowa (określanie stawek) com.google.ads.mediation.vungle.VungleMediationAdapter
Reklama pełnoekranowa (kaskada) com.vungle.mediation.VungleInterstitialAdapter
Reklama z nagrodą (ustalanie stawek) com.google.ads.mediation.vungle.VungleMediationAdapter
Reklama z nagrodą (kaskada) com.vungle.mediation.VungleAdapter
Reklama pełnoekranowa z nagrodą (określanie stawek) com.google.ads.mediation.vungle.VungleMediationAdapter
Reklama pełnoekranowa z nagrodą (kaskada) com.google.ads.mediation.vungle.VungleMediationAdapter

iOS

Format Nazwa zajęć
Reklama wyświetlana przy otwarciu aplikacji (ustalanie stawek) GADMediationAdapterVungle
Przy otwarciu aplikacji (kaskada) GADMediationAdapterVungle
Baner (ustalanie stawek) GADMediationAdapterVungle
Baner (kaskada) GADMAdapterVungleInterstitial
Reklama pełnoekranowa (określanie stawek) GADMediationAdapterVungle
Reklama pełnoekranowa (kaskada) GADMAdapterVungleInterstitial
Reklama z nagrodą (ustalanie stawek) GADMediationAdapterVungle
Reklama z nagrodą (kaskada) GADMAdapterVungleRewardBasedVideoAd
Reklama pełnoekranowa z nagrodą (określanie stawek) GADMediationAdapterVungle
Reklama pełnoekranowa z nagrodą (kaskada) GADMediationAdapterVungle

Oto kody i odpowiednie komunikaty z adaptera do zarabiania Liftoff, które są wyświetlane, gdy nie udaje się załadować reklamy:

Android

Kod błędu Przyczyna
101 nieprawidłowe parametry serwera (np. identyfikator aplikacji lub miejsca docelowego);
102 Żądany rozmiar banera nie jest mapowany na prawidłowy rozmiar reklamy w usłudze Liftoff Monetize.
103 Aby wysyłać żądania reklam, usługa Liftoff Monetize wymaga kontekstu Activity.
104 Pakiet SDK Vungle nie może wczytywać wielu reklam dla tego samego identyfikatora miejsca docelowego.
105 Nie udało się zainicjować Vungle SDK.
106 Pakiet SDK Vungle zwrócił wywołanie zwrotne pomyślnie, ale funkcja Banners.getBanner() lub Vungle.getNativeAd() zwróciła wartość null.
107 Pakiet SDK Vungle nie jest gotowy do wyświetlenia reklamy.
108 Pakiet SDK Vungle zwrócił nieprawidłowy token określania stawek.

iOS

Kod błędu Przyczyna
101 nieprawidłowe parametry serwera (np. identyfikator aplikacji lub miejsca docelowego);
102 Reklama została już załadowana w przypadku tej konfiguracji sieci. Pakiet SDK Vungle nie może wczytać drugiej reklamy dla tego samego identyfikatora miejsca docelowego.
103 Żądany rozmiar reklamy nie jest obsługiwany przez Liftoff Monetize.
104 Pakiet SDK Vungle nie może wyrenderować banera reklamowego.
105 Pakiet SDK Vungle obsługuje wczytywanie tylko 1 banera naraz, niezależnie od identyfikatora miejsca docelowego.
106 Pakiet SDK Vungle wysłał wywołanie zwrotne z informacją, że reklama nie może być odtworzona.
107 Pakiet SDK Vungle nie jest gotowy do wyświetlenia reklamy.

W przypadku błędów pochodzących z pakietu Vungle SDK zapoznaj się z artykułem Kody błędów: Vungle SDK na iOS i Androida.

Historia zmian w pliku Unity Mediation Plugin w ramach usługi Liftoff Monetize

Wersja 5.2.1

Wersja 5.2.0

Wersja 5.1.1

Wersja 5.1.0

  • Naprawiono błąd NullPointerException, który powodował niepowodzenie kompilacji podczas eksportowania jako projektu na Androida.
  • Zaktualizowano interfejsy API dotyczące prywatności:
    • Usunięto metody UpdateConsentStatus() i UpdateCCPAStatus().
    • Usunięto typy enumeracji VungleConsentStatus i VungleCCPAStatus.
    • Metoda SetGDPRStatus(bool) została zaktualizowana na SetGDPRStatus(bool, String).
  • Usunięto z klasy LiftoffMonetizeMediationExtras te metody:
    • SetAllPlacements(String[])
    • SetSoundEnabled(bool)
  • Obsługuje adapter Androida Liftoff Monetize w wersji 7.3.1.0.
  • Obsługuje adapter Liftoff Monetize na iOS w wersji 7.3.1.0.
  • Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.1.0.

Wersja 5.0.0

Wersja 4.0.0

  • Zmiana nazwy wtyczki zapośredniczenia Unity z Vungle na Liftoff Monetize.
  • Treści adaptera zostały przeniesione do GoogleMobileAds/Mediation/LiftoffMonetize/.
  • Przebudowana przestrzeń nazw adaptera, która używa GoogleMobileAds.Mediation.LiftoffMonetize.
  • Do klasy LiftoffMonetize dodaliśmy te metody:
    • SetGDPRStatus(bool)
    • SetGDPRMessageVersion(String)
    • SetCCPAStatus(bool)
  • Obsługuje adapter Liftoff Monetize na Androida w wersji 6.12.1.1.
  • Obsługuje adapter Liftoff Monetize na iOS w wersji 7.0.1.0.
  • Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.4.1.

Wersja 3.9.2

Wersja 3.9.1

Wersja 3.9.0

Wersja 3.8.2

Wersja 3.8.1

Wersja 3.8.0

Wersja 3.7.5

Wersja 3.7.4

Wersja 3.7.3

Wersja 3.7.2

Wersja 3.7.1

Wersja 3.7.0

Wersja 3.6.0

Wersja 3.5.1

Wersja 3.5.0

Wersja 3.4.1

Wersja 3.4.0

Wersja 3.3.1

Wersja 3.3.0

Wersja 3.2.0

Wersja 3.1.4

  • Obsługuje adapter Androida w wersji 6.3.24.1.
  • Obsługuje adapter iOS w wersji 6.3.2.3.

Wersja 3.1.3

  • Obsługuje adapter Androida w wersji 6.3.24.1.
  • Obsługuje adapter iOS w wersji 6.3.2.2.

Wersja 3.1.2

  • Zaktualizowano wtyczkę, aby obsługiwała nowy interfejs API do reklam z nagrodą w ramach otwartych testów beta.
  • Obsługuje adapter Androida w wersji 6.3.24.1.
  • Obsługuje adapter iOS w wersji 6.3.2.1.

Wersja 3.1.1

  • Obsługuje adapter Androida w wersji 6.3.24.0.
  • Obsługuje adapter iOS w wersji 6.3.2.0.
  • Zaktualizowano metodę Vungle.UpdateConsentStatus(), aby parametr consentMessageVersion stał się opcjonalny. Wartość consentMessageVersion jest teraz ignorowana w przypadku iOS.
  • Wycofane Vungle.GetCurrentConsentMessageVersion() na iOS.

Wersja 3.1.0

  • Obsługuje przejściówkę na Androida w wersji 6.3.17.0.
  • Obsługuje adapter iOS w wersji 6.3.0.0.
  • Zaktualizowana metoda Vungle.UpdateConsentStatus(), która przyjmuje dodatkowy parametr String dla wersji komunikatu o zgodzie udostępnionej przez wydawcę.
  • Dodano metodę Vungle.GetCurrentConsentMessageVersion(), aby uzyskać wersję wiadomości z prośbą o zgodę przesłaną przez wydawcę.

Wersja 3.0.1

  • Obsługuje adapter Androida w wersji 6.2.5.1.
  • Obsługuje adapter iOS w wersji 6.2.0.3.

Wersja 3.0.0

  • Obsługuje adapter Android w wersji 6.2.5.0.
  • Obsługuje adapter iOS w wersji 6.2.0.2.
  • Dodaliśmy te metody:
    • Vungle.UpdateConsentStatus() , aby ustawić stan zgody, który zostanie zapisany w pakiecie SDK Vungle.
    • Vungle.GetCurrentConsentStatus(), aby uzyskać bieżący stan zgody użytkownika.

Wersja 2.0.0

  • Obsługuje adapter Androida w wersji 5.3.2.1.
  • Obsługuje adapter iOS w wersji 6.2.0.0.

Wersja 1.1.0

  • Obsługuje adapter Androida w wersji 5.3.2.1.
  • Obsługuje adapter iOS w wersji 5.4.0.0.

Wersja 1.0.0

  • Pierwsza wersja
  • Obsługuje przejściówkę na Androida w wersji 5.3.0.0.
  • Obsługuje adapter iOS w wersji 5.3.0.0.