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ą. 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 fazie otwartych testów 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
- Najnowsza wersja pakietu SDK do reklam mobilnych Google
- Unity 4 lub nowsza
- (do określania stawek): wtyczka Google Mobile Ads do pośrednictwa w reklamach dla Liftoff Monetize w wersji 3.8.2 lub nowszej (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. Więcej informacji znajdziesz w artykule Pierwsze kroki.
- 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
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 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 usługami na Androida > 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. 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. 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. 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 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
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 według wskazówek każdej z tych sieci, 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ęć:
Android
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 |
iOS
Format | Nazwa zajęć |
---|---|
Otwarcie aplikacji (określanie stawek) | GADMediationAdapterVungle |
Reklama przy otwarciu aplikacji (kaskada) | GADMediationAdapterVungle |
Baner (określanie stawek) | GADMediationAdapterVungle |
Baner (wodospad) | GADMAdapterVungleInterstitial |
Reklama pełnoekranowa (określanie stawek) | GADMediationAdapterVungle |
Reklama pełnoekranowa (wodospad) | GADMAdapterVungleInterstitial |
Reklamy z nagrodą (określanie stawek) | GADMediationAdapterVungle |
Z nagrodą (wodospad) | GADMAdapterVungleRewardBasedVideoAd |
Reklama pełnoekranowa z nagrodą (określanie stawek) | GADMediationAdapterVungle |
Reklama pełnoekranowa z nagrodą (wodospad) | 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 | Żądaną wielkość banera nie można mapować na prawidłowy rozmiar reklamy w usłudze Liftoff Monetize. |
103 | Liftoff Monetize wymaga przesyłania żądań z kontekstem Activity
reklam. |
104 | Pakiet SDK Vungle nie może wczytać wielu reklam w tym samym miejscu docelowym ID. |
105 | Nie udało się zainicjować pakietu SDK Vungle. |
106 | Vungle SDK zwróciło udane wywołanie zwrotne wczytywania, ale Banners.getBanner() lub Vungle.getNativeAd() zwróciło wartość null. |
107 | Pakiet Vungle SDK nie jest gotowy do wyświetlenia reklamy. |
108 | Pakiet SDK Vungle zwrócił nieprawidłowy token ustalania stawek. |
iOS
Kod błędu | Przyczyna |
---|---|
101 | Nieprawidłowe parametry serwera (np. identyfikator aplikacji lub miejsca docelowego). |
102 | Reklama została już wczytana na potrzeby tej konfiguracji sieci. Pakiet SDK Vungle nie można wczytać drugiej reklamy z tym samym identyfikatorem miejsca docelowego. |
103 | Żądany rozmiar reklamy nie pasuje do obsługiwanego narzędzia Liftoff Monetize rozmiar banera. |
104 | Pakiet Vungle SDK nie mógł wyrenderować banera reklamowego. |
105 | Pakiet SDK Vungle obsługuje tylko wczytywanie 1 banera naraz, niezależnie od identyfikatora miejsca docelowego. |
106 | Pakiet SDK Vungle wysłał wywołanie zwrotne z informacją, że nie można odtworzyć reklamy. |
107 | Pakiet Vungle SDK 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.
Liftoff Monetize – historia zmian wtyczki zapośredniczenia Unity
Wersja 5.2.1
- Nazwa
DummyClient
została zmieniona naPlaceholderClient
. - Obsługuje adapter Androida Liftoff Monetize w wersji 7.4.0.1.
- Obsługuje adapter Liftoff Monetize na iOS w wersji 7.4.0.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.2.0.
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.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.1.0.
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:
- 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
- Poprawiono ostrzeżenie o duplikacie definicji w przypadku
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.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.7.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/
. - 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 iOS w wersji 6.12.2.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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.
- Skompilowana i przetestowana z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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 do Androida w wersji 6.10.2.
- Obsługuje adapter Vungle na iOS w wersji 6.10.3.0.
Wersja 3.6.0
- Obsługuje adapter Vungle do 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 do 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()
, 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 Androida w wersji 6.2.5.0.
- Obsługuje adapter iOS w wersji 6.2.0.2.
- Dodaliśmy 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.