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 platformy Liftoff Monetize za pomocą zapośredniczenia obejmującego zarówno określanie stawek, jak i integracje kaskadowe. Omawiamy w nim, jak dodać Liftoff Monetize do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Vungle z aplikacją na Unity.

Obsługiwane integracje i formaty reklam

Integracja
Ustalanie stawek
Wodospad
Formaty
Baner 1
Pełnoekranowa
Otrzymano
Pełnoekranowa z nagrodą 1, 2

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

2 Reklama pełnoekranowa z nagrodą wymaga pomocy w konfiguracji. Skontaktuj się ze swoim menedżerem konta na stronie Liftoff Monetize lub monetize@liftoff.io.

Wymagania

  • Najnowszy pakiet SDK do reklam mobilnych Google
  • Unity 4 lub nowsza
  • (Na potrzeby określania stawek): wtyczka zapośredniczenia do reklam mobilnych Google dla narzędzia Liftoff Monetize w wersji 3.8.2 lub nowszej (zalecana najnowsza wersja)
  • Aby przeprowadzić wdrożenie na Androidzie:
    • Interfejs API Androida na poziomie 21 lub wyższym
  • Aby wdrożyć w iOS:
    • Wartość docelowa 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.
  • Wykonaj czynności dotyczące zapośredniczenia Wprowadzenie

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, 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:

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 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.

Android

iOS

Krok 2. Skonfiguruj popyt na platformę Liftoff Monetize w AdMob interfejsie użytkownika

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 instrukcji na Androida.

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 AdMob UI.

Krok 3. Zaimportuj pakiet SDK Vungle i adapter Liftoff Monetize

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla narzędzia Liftoff Monetize z linku do pobrania w historii zmian i wyodrębnij GoogleMobileAdsVungleMediation.unitypackage z pliku ZIP.

W edytorze projektu Unity wybierz Assets > Import Package > Custom Package (Zasoby > Importuj pakiet > Pakiet niestandardowy) i znajdź pobrany plik GoogleMobileAdsVungleMediation.unitypackage. Zaznacz wszystkie pliki i kliknij Importuj.

Następnie wybierz Zasoby > Program do rozpoznawania Usług Google Play > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka programu do rozpoznawania zależności w Usługach Unity Play przeprowadzi rozpoznawanie zależności od zera i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android aplikacji Unity.

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

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) udzielili określonych informacji na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz uzyskali od nich odpowiednie zgody. 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). Żeby uzyskać zgodę na wykorzystanie danych, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub wykorzystywać dane osobowe, a także dostarczać informacje o korzystaniu z nich przez poszczególne sieci. Obecnie Google nie może automatycznie przekazać zgody użytkownika na wykorzystanie danych do takich sieci.

Wtyczka zapośredniczenia reklam mobilnych Google dla narzędzia Liftoff Monetize w wersji 4.0.0 zawiera metody przekazywania informacji o zgodzie do pakietu SDK Vungle.

Android

Podczas aktualizowania stanu zgody użytkownika możesz podać 2 wartości:

  • VungleConsentStatus.OPTED_IN
  • VungleConsentStatus.OPTED_OUT

Ten przykładowy kod zmienia stan zgody na VungleConsentStatus.OPTED_IN. Jeśli chcesz wywoływać tę metodę, rób to przed wysłaniem żądań reklam za pomocą pakietu SDK do reklam mobilnych Google.

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

LiftoffMonetize.UpdateConsentStatus(VungleConsentStatus.OPTED_IN, "1.0.0");

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

iOS

Ten przykładowy kod przekazuje informacje o zgodzie do pakietu SDK Vungle na iOS. Jeśli chcesz wywoływać tę metodę, zalecamy zrobienie tego przed wysłaniem żądań reklam za pomocą pakietu SDK do reklam mobilnych Google.

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

LiftoffMonetize.SetGDPRStatus(true);
LiftoffMonetize.SetGDPRMessageVersion("1.0.0");

Więcej informacji oraz wartości, które możesz 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ą przyznania użytkownikom prawa do wycofania zgody na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie), przy czym opcja ta jest dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej sprzedającego. 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 żadnej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność z zasadami.

Wtyczka zapośredniczenia reklam mobilnych Google dla narzędzia Liftoff Monetize w wersji 4.0.0 zawiera metody przekazywania informacji o zgodzie do pakietu SDK Vungle.

Android

Podczas aktualizowania stanu zgody użytkownika możesz podać 2 wartości:

  • VungleCCPAStatus.OPTED_IN
  • VungleCCPAStatus.OPTED_OUT

Ten przykładowy kod zmienia stan zgody na VungleCCPAStatus.OPTED_IN. Jeśli chcesz wywoływać tę metodę, rób to przed wysłaniem żądań reklam za pomocą pakietu SDK do reklam mobilnych Google.

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

LiftoffMonetize.UpdateCCPAStatus(VungleCCPAStatus.OPTED_IN);

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

iOS

Ten przykładowy kod przekazuje informacje o zgodzie do pakietu SDK Vungle na iOS. Jeśli chcesz wywoływać tę metodę, zalecamy zrobienie tego przed wysłaniem żądań reklam za pomocą pakietu SDK do reklam mobilnych Google.

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

LiftoffMonetize.SetCCPAStatus(true);

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

Krok 5. Dodaj wymagany kod

Android

Integracja Liftoff Monetize nie wymaga dodatkowego kodu.

iOS

Integracja SKAdNetwork

Wykonaj dokumentację narzędzia Liftoff Monetize, aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu.

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.

Kody błędów

Jeśli adapter nie otrzyma reklamy z platformy Liftoff Monetize, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi na żądanie reklamy, korzystając z ResponseInfo w ramach tych klas:

iOS

Format Nazwa zajęć
Baner GADMAdapterVungleInterstitial
Pełnoekranowa GADMAdapterVungleInterstitial
Otrzymano GADMAdapterVungleRewardBasedVideoAd

Oto kody i powiązane z nimi komunikaty wysyłane przez adapter Liftoff Monetize, gdy nie można wczytać reklamy:

iOS

Kod błędu Przyczyna
1-100 Pakiet SDK Vungle zwrócił błąd. Więcej informacji znajdziesz w kodzie.
101 Brakuje parametrów serwera Liftoff Monetize skonfigurowanych w AdMob interfejsie lub są one nieprawidłowe.
102 Reklama dla tej konfiguracji sieci została już wczytana. Pakiet SDK Vungle nie może wczytać drugiej reklamy dla tego samego identyfikatora miejsca docelowego.
103 Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Liftoff Monetize.
104 Pakiet SDK Vungle nie mógł wyrenderować banera reklamowego.
105 Pakiet Vungle SDK obsługuje wczytywanie tylko 1 baneru reklamowego naraz, niezależnie od identyfikatora miejsca docelowego.
106 Pakiet SDK Vungle wysłał wywołanie zwrotne informujące, że reklamy nie można odtworzyć.

Liftoff Monetize – historia zmian wtyczki Unity Mediation

Wersja 5.1.0

  • Naprawiono błąd NullPointerException, który powodował błąd kompilacji podczas eksportowania jako projektu Androida.
  • Zaktualizowaliśmy interfejsy API prywatności:
    • Usunięto metody UpdateConsentStatus() i UpdateCCPAStatus().
    • Usunięto wyliczenia VungleConsentStatus i VungleCCPAStatus.
    • Zmieniono metodę SetGDPRStatus(bool) na SetGDPRStatus(bool, String).
  • Z klasy LiftoffMonetizeMediationExtras usunięto te metody:
    • SetAllPlacements(String[])
    • SetSoundEnabled(bool)
  • Obsługuje adapter Androida Liftoff Monetize z wersji 7.3.1.0.
  • Obsługuje adapter na iOS Liftoff Monetize w wersji 7.3.1.0.
  • Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google 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/.
  • Zrefaktoryzowano przestrzeń nazw adaptera na GoogleMobileAds.Mediation.LiftoffMonetize.
  • Dodano do klasy LiftoffMonetize te metody:
    • SetGDPRStatus(bool)
    • SetGDPRMessageVersion(String)
    • SetCCPAStatus(bool)
  • Obsługuje adapter Androida Liftoff Monetize z wersji 6.12.1.1.
  • Obsługuje adapter na iOS Liftoff Monetize w wersji 7.0.1.0.
  • Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google 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

  • 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.
  • Zaktualizowano metodę Vungle.UpdateConsentStatus(), aby parametr consentMessageVersion stał się opcjonalny. Wartość consentMessageVersion jest teraz ignorowana w przypadku iOS.
  • Wycofano aplikację Vungle.GetCurrentConsentMessageVersion() z wersji 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.
  • Zaktualizowano metodę Vungle.UpdateConsentStatus(), aby uwzględniała dodatkowy parametr String w przypadku wersji wiadomości z prośbą o zgodę na wykorzystanie danych dostarczonej przez wydawcę.
  • Dodano metodę Vungle.GetCurrentConsentMessageVersion(), aby pobierać wersję wiadomości z prośbą o zgodę na wykorzystanie danych podaną 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(), aby określić stan zgody, który będzie rejestrowany w pakiecie SDK Vungle.
    • Vungle.GetCurrentConsentStatus(), aby 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.