Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z Liftoff Monetize, zapośredniczenia, które obejmuje zarówno ustalanie stawek, integracji kaskadowych. Wyjaśniamy, jak dodać Liftoff Monetize do oraz jak zintegrować Vungle SDK i adapter z Unity
Obsługiwane integracje i formaty reklam
Integracja | |
---|---|
Określanie stawek | 1 |
Wodospad | |
Formaty | |
Otwarcie aplikacji | |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Reklama pełnoekranowa z nagrodą | 2 |
1 Integracja określania stawek jest w otwartej wersji beta.
2 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
- Najnowszy pakiet SDK do reklam mobilnych Google
- Unity 4 lub nowsza
- (Do określania stawek): wtyczka zapośredniczenia do reklam mobilnych Google dla Liftoff Monetize 3.8.2 lub nowsza (zalecana najnowsza wersja)
- Do wdrożenia na Androidzie
- Interfejs API Androida na poziomie 21 lub wyższym
- Do wdrożenia na iOS
- Cel wdrożenia iOS w wersji 12.0 lub nowszej
- Działający Unity projekt skonfigurowany za pomocą: pakietu SDK do reklam mobilnych Google. Zobacz Rozpocznij, aby dowiedzieć się więcej.
- 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.
Android
iOS
Po utworzeniu aplikacji wybierz ją w panelu Liftoff Monetize Applications.
Android
iOS
Zapisz identyfikator aplikacji.
Android
iOS
Dodawanie nowych miejsc docelowych
Aby utworzyć nowe miejsce docelowe, Ad Manager 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:
Baner
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.
Baner 300 x 250
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.
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ćAd Manager 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.
Android
iOS
Krok 2. Skonfiguruj źródła ofert reklamowych i zarabiaj na nich w Ad Manager interfejsie
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 instrukcji na Android.
iOS
Instrukcje znajdziesz w kroku 2 przewodnika po iOS.
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 SDK Vungle i adapter Liftoff Monetize
Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla Liftoff
Zarabiaj na linku pobierania w
Historia zmian i wyodrębnij plik
GoogleMobileAdsVungleMediation.unitypackage
z pliku ZIP.
W edytorze projektów Unity, wybierz Assets (Zasoby) > Importuj pakiet >
Własny pakiet i znajdź plik GoogleMobileAdsVungleMediation.unitypackage
.
pobranego pliku. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Potem kliknij Komponenty > Program do rozpoznawania usług Google Play > Program do rozpoznawania Androida >
Wymuś rozwiązanie. Biblioteka programu do rozpoznawania usług Unity Play
rozpoznania zależności od zera i skopiuj zadeklarowane zależności do
Katalog Assets/Plugins/Android
Twojej aplikacji w Unity.
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.
Wtyczka zapośredniczenia do reklam mobilnych Google dla Liftoff Monetize wykorzystuje metody przekazać informacje o zgodzie do pakietu SDK Vungle. Poniższy przykładowy kod pokazuje, do przekazywania informacji o zgodzie do pakietu SDK Vungle. Jeśli wybierzesz nazwę zaleca się 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
Zapoznaj się z instrukcjami implementacji zalecanej przez RODO w przypadku: Android oraz iOS, aby dowiedzieć się więcej oraz wartości, które można podać w metodzie.
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.
Wtyczka zapośredniczenia do reklam mobilnych Google dla Liftoff Monetize wykorzystuje metody przekazać informacje o zgodzie do pakietu SDK Vungle. Poniższy przykładowy kod pokazuje, do przekazywania informacji o zgodzie do pakietu SDK Vungle. Jeśli wybierzesz nazwę zaleca się zrobić to przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.SetCCPAStatus(true);
Zapoznaj się z instrukcjami implementacji zalecanej przez ustawę CCPA: Androida oraz iOS, aby dowiedzieć się więcej wartości, które można podać w metodzie.
Krok 5. Dodaj wymagany kod
Android
Integracja z Liftoff Monetize nie wymaga dodatkowego kodu.
iOS
Integracja SKAdNetwork
Obserwuj kanał Liftoff Monetize
dokumentacja
aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu.
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.
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
w ramach tych zajęć:
iOS
Format | Nazwa zajęć |
---|---|
Baner | GADMAdapterVungleInterstitial |
Pełnoekranowa | GADMAdapterVungleInterstitial |
Z nagrodą | GADMAdapterVungleRewardBasedVideoAd |
Oto kody i powiązane z nimi wiadomości wysyłane przez Liftoff Monetize adaptera, gdy reklama nie wczytuje się:
iOS
Kod błędu | Przyczyna |
---|---|
1-100 | Pakiet SDK Vungle zwrócił komunikat o błędzie. Zobacz kod . |
101 | Liftoff Monetize nie może zawierać parametrów serwera skonfigurowanych w Ad Manager interfejsie lub są nieprawidłowe. |
102 | Reklama została już wczytana na potrzeby tej konfiguracji sieci. Vungle SDK nie może wczytać drugiej reklamy dla tego samego identyfikatora miejsca docelowego. |
103 | Żądany rozmiar reklamy nie pasuje do obsługiwanego rozmiaru banera Liftoff Monetize. |
104 | Pakiet Vungle SDK nie mógł wyrenderować banera reklamowego. |
105 | Pakiet Vungle SDK obsługuje w danym momencie tylko jeden baner reklamowy, niezależnie od identyfikatora miejsca docelowego. |
106 | Pakiet SDK Vungle wysłał wywołanie zwrotne z informacją, że nie można odtworzyć reklamy. |
Liftoff Monetize – historia zmian wtyczki zapośredniczenia Unity
Następna wersja
- Nazwa
DummyClient
została zmieniona naPlaceholderClient
.
Wersja 5.2.0
- Obsługuje adapter Liftoff Monetize Androida w wersji 7.4.0.0.
- Obsługuje adapter Liftoff Monetize na iOS w wersji 7.4.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.1.
Wersja 5.1.1
- Obsługuje adapter Liftoff Monetize Androida w wersji 7.3.2.0.
- Obsługuje adapter Liftoff Monetize na iOS w wersji 7.3.2.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 5.1.0
- Rozwiązaliśmy problem (
NullPointerException
), który powodował błąd kompilacji podczas eksportowania do projektu Androida. - Zaktualizowano interfejsy API związane z prywatnością:
- Usunęliśmy metody
UpdateConsentStatus()
iUpdateCCPAStatus()
. - Usunięto wyliczenia
VungleConsentStatus
iVungleCCPAStatus
. - Zmieniono metodę
SetGDPRStatus(bool)
naSetGDPRStatus(bool, String)
.
- Usunęliśmy metody
- Z klasy
LiftoffMonetizeMediationExtras
usunięto te metody:SetAllPlacements(String[])
SetSoundEnabled(bool)
- Obsługuje adapter Liftoff Monetize Androida w wersji 7.3.1.0.
- Obsługuje adapter Liftoff Monetize na iOS w wersji 7.3.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 5.0.0
- Naprawiliśmy ostrzeżenie o zduplikowanej definicji w tabeli
MediationExtras
. - Obsługuje adapter Liftoff Monetize Androida w wersji 7.1.0.0.
- Obsługuje adapter Liftoff Monetize na iOS w wersji 7.2.1.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.7.0.
Wersja 4.0.0
- Zmieniono nazwę wtyczki zapośredniczenia Unity z Vungle na Liftoff Monetize.
- Przeniesiono treść adaptera do:
GoogleMobileAds/Mediation/LiftoffMonetize/
. - Przestrzeń nazw adaptera została zmieniona na
GoogleMobileAds.Mediation.LiftoffMonetize
. - Do klasy
LiftoffMonetize
dodano te metody:SetGDPRStatus(bool)
SetGDPRMessageVersion(String)
SetCCPAStatus(bool)
- Obsługuje adapter Liftoff Monetize Androida w wersji 6.12.1.1.
- Obsługuje adapter Liftoff Monetize na iOS w wersji 7.0.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.4.1.
Wersja 3.9.2
- Zaktualizowano zajęcia
Vungle
:- Dodano metodę
UpdateCCPAStatus(VungleCCPAStatus)
. - Usunięto metodę
GetCurrentConsentStatus()
. - Usunięto metodę
GetCurrentConsentMessageVersion()
.
- Dodano metodę
- Obsługuje adapter Vungle na Androida w wersji 6.12.1.0.
- Obsługuje adapter Vungle na iOS w wersji 6.12.2.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.4.1.
Wersja 3.9.1
- Obsługuje adapter Vungle na Androida w wersji 6.12.1.0.
- Obsługuje adapter Vungle na iOS w wersji 6.12.1.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.4.0.
Wersja 3.9.0
- Obsługuje adapter Vungle na Androida w wersji 6.12.0.0.
- Obsługuje adapter Vungle na iOS w wersji 6.12.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.2.0.
Wersja 3.8.2
- Obsługuje adapter Vungle na Androida w wersji 6.11.0.2.
- Obsługuje adapter Vungle na iOS w wersji 6.11.0.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.1.0.
Wersja 3.8.1
- Obsługuje adapter Vungle na Androida w wersji 6.11.0.1.
- Obsługuje adapter Vungle na iOS w wersji 6.11.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.2.
Wersja 3.8.0
- Obsługuje adapter Vungle na Androida w wersji 6.11.0.0.
- Obsługuje adapter Vungle na iOS w wersji 6.11.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 3.7.5
- Obsługuje adapter Vungle na Androida w wersji 6.10.5.0.
- Obsługuje adapter Vungle na iOS w wersji 6.10.6.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 3.7.4
- Obsługuje adapter Vungle na Androida w wersji 6.10.4.0.
- Obsługuje adapter Vungle na iOS w wersji 6.10.6.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 3.7.3
- Obsługuje adapter Vungle na Androida w wersji 6.10.3.0.
- Obsługuje adapter Vungle na iOS w wersji 6.10.5.1.
Wersja 3.7.2
- Obsługuje adapter Vungle na Androida w wersji 6.10.2.1.
- Obsługuje adapter Vungle na iOS w wersji 6.10.5.1.
Wersja 3.7.1
- Obsługuje adapter Vungle na Androida w wersji 6.10.2.0.
- Obsługuje adapter Vungle na iOS w wersji 6.10.4.0.
Wersja 3.7.0
- Obsługuje adapter Vungle na Androida w wersji 6.10.2.0.
- Obsługuje adapter Vungle na iOS w wersji 6.10.3.0.
Wersja 3.6.0
- Obsługuje adapter Vungle na Androida w wersji 6.9.1.1.
- Obsługuje adapter Vungle na iOS w wersji 6.9.2.0.
Wersja 3.5.1
- Obsługuje adapter Vungle na Androida w wersji 6.8.1.0.
- Obsługuje adapter Vungle na iOS w wersji 6.8.1.0.
Wersja 3.5.0
- Obsługuje adapter Vungle na Androida w wersji 6.8.0.0.
- Obsługuje adapter Vungle na iOS w wersji 6.8.0.0.
Wersja 3.4.1
- Obsługuje adapter Vungle na Androida w wersji 6.7.1.0.
- Obsługuje adapter Vungle na iOS w wersji 6.7.1.0.
Wersja 3.4.0
- Obsługuje adapter Vungle na Androida w wersji 6.7.0.0.
- Obsługuje adapter Vungle na iOS w wersji 6.7.0.0.
Wersja 3.3.1
- Zmieniono pakiet
vungle-extras-library.jar
navungle-unity-android-library.aar
z użyciem kompilacji.aar
na potrzeby Unity 2020.- Uaktualniając do tej wersji, usuń
vungle-extras-library.jar
z projektu.
- Uaktualniając do tej wersji, usuń
- Obsługuje adapter Vungle na Androida w wersji 6.5.3.0.
- Obsługuje adapter Vungle na iOS w wersji 6.5.3.0.
Wersja 3.3.0
- Obsługuje adapter Vungle na Androida w wersji 6.5.3.0.
- Obsługuje adapter Vungle na iOS w wersji 6.5.3.0.
Wersja 3.2.0
- Obsługuje adapter Vungle na Androida w wersji 6.4.11.1.
- Obsługuje adapter Vungle na iOS w wersji 6.4.6.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
- Zaktualizowaliśmy wtyczkę, aby obsługiwała nowy interfejs API z nagrodą w otwartej wersji 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.
- Zaktualizowaliśmy metodę
Vungle.UpdateConsentStatus()
, aby dodać parametrconsentMessageVersion
jako opcjonalny. W przypadku iOS wartośćconsentMessageVersion
jest teraz ignorowana. - Wycofano
Vungle.GetCurrentConsentMessageVersion()
na iOS.
Wersja 3.1.0
- Obsługuje adapter Androida w wersji 6.3.17.0.
- Obsługuje adapter iOS w wersji 6.3.0.0.
- Zaktualizowaliśmy metodę
Vungle.UpdateConsentStatus()
, aby przyjmowała dodatkowy parametrString
na potrzeby wersji wiadomości z prośbą o zgodę na wykorzystanie danych przekazanej przez wydawcę. - Dodano metodę
Vungle.GetCurrentConsentMessageVersion()
umożliwiającą pobieranie wersji wiadomości z prośbą o zgodę na wykorzystanie danych dostarczonej 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 Androida w wersji 6.2.5.0.
- Obsługuje adapter iOS w wersji 6.2.0.2.
- Dodano te metody:
Vungle.UpdateConsentStatus()
do ustawiania stanu zgody, który będzie rejestrowany w pakiecie SDK Vungle.- Metoda
Vungle.GetCurrentConsentStatus()
, która pozwala sprawdzić aktualny 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 adapter Androida w wersji 5.3.0.0.
- Obsługuje adapter iOS w wersji 5.3.0.0.