Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Integracja Liftoff Zarabiaj z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads SDK wczytywać i wyświetlać reklamy z Liftoff Monetize przy użyciu zapośredniczenia, które obejmuje integracje z określaniem stawek i kaskadą. Wyjaśnia, jak dodać Liftoff Monetize do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Vungle z aplikacją na iOS.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia Liftoff Monetize ma te możliwości:

Integracja
Określanie stawek
Kaskada
Formaty
Otwarcie aplikacji
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Natywna

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź, czy:

iOS w wersji 13.0 lub nowszej.
[W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w określaniu stawek, użyj adaptera Liftoff Monetize w wersji 7.3.0.0 lub nowszej (zalecana jest najnowsza wersja).

Najnowsza wersja Google Mobile Ads SDK.
Skonfiguruj mediację.

Krok 1. Skonfiguruj ustawienia w interfejsie Liftoff Monetize

Zarejestruj się lub zaloguj na konto Liftoff Monetize.

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

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

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

Zapisz identyfikator aplikacji.

Dodawanie nowych miejsc docelowych

Aby utworzyć nowe miejsce docelowe do użycia w zapośredniczeniu, otwórz panel Miejsca docelowe w Liftoff Monetize, kliknij przycisk Dodaj miejsce docelowe i wybierz aplikację z menu.

Szczegółowe informacje o dodawaniu nowych miejsc docelowych znajdziesz poniżej:

Wybierz Baner, wpisz Nazwę miejsca docelowego i wypełnij pozostałe pola formularza. [Tylko określanie stawek] W sekcji Generowanie przychodu ustaw przełącznik Określanie stawek w aplikacji w pozycji Włączone. Aby utworzyć miejsce docelowe, u dołu strony kliknij przycisk Dalej.

Kliknij MREC, wpisz nazwę miejsca docelowego i wypełnij pozostałe pola formularza. [Tylko określanie stawek] W sekcji Generowanie przychodu ustaw przełącznik Określanie stawek w aplikacji w pozycji Włączone. Aby utworzyć miejsce docelowe, u dołu strony kliknij przycisk Dalej.

Pełnoekranowa

Wybierz Reklama pełnoekranowa, wpisz Nazwę miejsca docelowego i wypełnij pozostałe pola formularza. [Tylko określanie stawek] W sekcji Generowanie przychodu ustaw przełącznik Określanie stawek w aplikacji w pozycji Włączone. Aby utworzyć miejsce docelowe, kliknij przycisk Dalej u dołu strony.

Z nagrodą

Kliknij Nagradzana, wpisz nazwę miejsca docelowego i wypełnij pozostałe pola formularza. [Tylko określanie stawek] W sekcji Generowanie przychodu ustaw przełącznik Określanie stawek w aplikacji w pozycji Włączone. Aby utworzyć miejsce docelowe, u dołu strony kliknij przycisk Dalej.

Reklama pełnoekranowa z nagrodą

Kliknij Z nagrodą. Wpisz nazwę miejsca docelowego, włącz opcję Możliwość pominięcia i wypełnij resztę formularza. [Tylko określanie stawek] W sekcji Generowanie przychodu ustaw przełącznik Określanie stawek w aplikacji w pozycji Włączone. Aby utworzyć miejsce docelowe, kliknij przycisk Dalej u dołu strony.

Natywna

Kliknij Reklama natywna, wpisz Nazwę miejsca docelowego i wypełnij pozostałe pola formularza. [Tylko określanie stawek] W sekcji Generowanie przychodu ustaw przełącznik Określanie stawek w aplikacji w pozycji Włączone. Aby utworzyć miejsce docelowe, u dołu strony kliknij przycisk Dalej.

Zapisz Identyfikator referencyjny i kliknij OK.

Baner

Baner 300 x 250

Pełnoekranowa

Z nagrodą

Reklama pełnoekranowa z nagrodą

Natywna

Znajdowanie klucza interfejsu Reporting API

Określanie stawek

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

Kaskada

Oprócz identyfikatora aplikacji i identyfikatora referencyjnego do skonfigurowania identyfikatora jednostki reklamowej Ad Managera potrzebny będzie też klucz interfejsu API do raportowania 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.

Aktualizowanie pliku app-ads.txt

Plik Authorized Sellers for Apps app-ads.txt to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze tego nie zrobiono, utwórz plik app-ads.txt na potrzeby Ad Managera.

Aby wdrożyć app-ads.txt w przypadku Liftoff Monetize, pobierz i dołącz wpisy app-ads.txt Liftoff Monetize do istniejącego pliku app-ads.txt. Więcej informacji znajdziesz w artykule app-ads.txt.

Włączanie trybu testowego

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

W sekcji Identyfikator referencyjny miejsca docelowego w aplikacji wybierz aplikację, w której chcesz włączyć reklamy testowe. Aby włączyć reklamy testowe, w sekcji Stan wybierz Tryb testowy – Wyświetlaj tylko reklamy testowe.

Krok 2. Skonfiguruj popyt Liftoff Monetize w interfejsie Ad Managera

Zaloguj się na konto Ad Managera.

Dodawanie Liftoff Monetize w sekcji Firmy

Określanie stawek

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

Kaskada

Kliknij kolejno Administracja > Firmy, a potem na karcie Wszystkie firmy kliknij przycisk Nowa firma. Kliknij Sieć reklamowa.

Wybierz Liftoff Monetize jako Sieć reklamową, wpisz niepowtarzalną Nazwę i włącz Mediację. Włącz Automatyczne zbieranie danych i wpisz klucz interfejsu Reporting API uzyskany w poprzedniej sekcji.

Nie musisz wpisywać nazwy użytkownika ani hasła. Gdy skończysz, kliknij Zapisz.

Włączanie udostępniania bezpiecznych sygnałów

Określanie stawek

Kliknij kolejno Administracja i Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange, przejrzyj i włącz Udostępnianie bezpiecznych sygnałów. Kliknij Zapisz.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Udostępnianie bezpiecznych sygnałów w pytaniach o stawkę

Określanie stawek

Kliknij kolejno Zasoby reklamowe i Bezpieczne sygnały. W sekcji Bezpieczne sygnały wyszukaj Liftoff i włącz opcję Włącz integrację aplikacji.

Kliknij Zapisz.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Zezwalanie na udostępnianie bezpiecznych sygnałów na potrzeby określania stawek przez pakiet SDK

Określanie stawek

Kliknij kolejno Wyświetlanie i Ustawienia na potrzeby kanałów popytu. Na karcie Ustawienia domyślne włącz opcję Zezwalaj na udostępnianie bezpiecznych sygnałów w przypadku licytowania w SDK.

Kliknij Zapisz.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie ustalania stawek w Liftoff Monetize

Określanie stawek

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Kliknij Nowy licytujący.

Jako licytującego wybierz Liftoff Monetize.

Kliknij Dalej, aby włączyć określanie stawek przez pakiet SDK w przypadku tego licytującego.

Kliknij Gotowe.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie mapowania jednostki reklamowej

Określanie stawek

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Wybierz firmę Liftoff Monetize.

Otwórz kartę Mapowanie jednostek reklamowych i kliknij Nowe mapowanie jednostek reklamowych.

Wybierz Konkretna jednostka reklamowa. Wybierz jednostkę reklamową i format, Aplikacja mobilna jako Typ zasobów reklamowych oraz Aplikacja mobilna. Następnie wpisz Identyfikator aplikacji i Identyfikator referencyjny miejsca docelowego uzyskane w poprzedniej sekcji.

Na koniec kliknij Zapisz.

Kaskada

Kliknij kolejno Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku. Wybierz zasoby reklamowe i aplikację.

Przewiń do sekcji Partnerzy zysku i kliknij Dodaj partnera zapośredniczenia.

Wybierz firmę utworzoną w poprzedniej sekcji na potrzeby Liftoff Monetize. Wybierz Zapośredniczenie mobilne SDK jako Typ integracji, iOS jako Platformę i Aktywny jako Stan.

Wpisz Identyfikator aplikacji i Identyfikator referencyjny miejsca docelowego uzyskane w poprzedniej sekcji oraz wartość domyślnego CPM. Kliknij Zapisz.

Dodawanie Liftoff do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi dotyczącymi prywatności

Aby dodać Liftoff do listy partnerów reklamowych wymaganych przez rozporządzenia europejskie i przepisy stanowe w USA w interfejsie Ad Managera, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet Vungle SDK i adapter Liftoff Monetize

Korzystanie z Swift Package Manager

Zanim przejdziesz dalej, musisz mieć najnowszą obsługiwaną wersję adaptera 7.5.3.0.

Aby dodać zależność pakietu do projektu, wykonaj te czynności:

W Xcode kliknij kolejno File (Plik) > Add Package Dependencies... (Dodaj zależności pakietu…).

W wyświetlonym wierszu poleceń wyszukaj ten adres URL pakietu:

https://github.com/googleads/googleads-mobile-ios-mediation-liftoffmonetize.git

W sekcji Reguła zależności wybierz Gałąź.
W polu tekstowym wpisz main.

Korzystanie z CocoaPods

Dodaj do pliku Podfile projektu ten wiersz:
```
pod 'GoogleMobileAdsMediationVungle'
```
W wierszu poleceń uruchom:
```
pod install --repo-update
```

Integracja ręczna

Pobierz najnowszą wersję pakietu Vungle SDK na iOS i połącz VungleAdsSDK.xcframework w projekcie.
Pobierz najnowszą wersję adaptera Liftoff Monetize z linku do pobierania w dzienniku zmian i połącz LiftoffMonetizeAdapter.xcframework w projekcie.
Dodaj do projektu te platformy:
- AdSupport
- AudioToolbox
- AVFoundation
- CFNetwork
- CoreGraphics
- CoreMedia
- libz.tbd
- MediaPlayer
- QuartzCore
- StoreKit
- SystemConfiguration

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

Zgoda użytkowników z UE i RODO

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz przekazywać użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Szwajcarii i Wielkiej Brytanii określone informacje oraz uzyskiwać ich zgodę na używanie plików cookie lub innych form lokalnego przechowywania danych, jeśli jest to wymagane przez prawo, a także na zbieranie, udostępnianie i wykorzystywanie danych osobowych na potrzeby personalizacji reklam. 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). Odpowiadasz za sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu zapośredniczenia.

Od wersji 7.4.1 pakietu SDK Vungle platforma Liftoff Monetize automatycznie odczytuje zgodę na wykorzystanie danych zgodnie z RODO ustawioną przez platformy do zarządzania zgodą użytkowników, które obsługują specyfikację Google dotyczącą udzielenia dodatkowej zgody, w tym pakiet SDK UMP. Więcej informacji znajdziesz w instrukcjach dotyczących zalecanej implementacji RODO.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli prawo wycofać zgodę na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu na stronie głównej podmiotu „sprzedającego” musi być umieszczony dobrze widoczny link „Nie sprzedawaj moich danych osobowych”. Przewodnik po zgodności z przepisami stanowymi USA dotyczącymi ochrony 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 Twoim łańcuchu zapośredniczenia. Dlatego musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie z wytycznymi każdej z tych sieci, aby zapewnić zgodność z przepisami.

Liftoff Monetize zawiera interfejs API, który umożliwia przekazywanie zgody do pakietu Vungle SDK. Poniższy przykładowy kod pokazuje, jak przekazać te informacje o zgodzie do pakietu Vungle SDK. Jeśli zdecydujesz się wywołać tę metodę, zalecamy zrobienie tego przed wysłaniem prośby o reklamy za pomocą funkcji Google Mobile Ads SDK.

Swift

VunglePrivacySettings.setCCPAStatus(true)LiftoffMonetizeMediationSwiftSnippets.swift

Objective-C

[VunglePrivacySettings setCCPAStatus:YES];LiftoffMonetizeMediationObjectiveCSnippets.m

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

Krok 5. Dodaj wymagany kod

Wdrażanie 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

Upewnij się, że zarejestrujesz urządzenie testowe w Ad Managerze i włączysz tryb testowy w interfejsie Liftoff Monetize.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z usługi Liftoff Monetize, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródeł reklam Liftoff Monetize (licytowanie) i Liftoff Monetize (kaskadowe).

Kroki opcjonalne:

Parametry dotyczące sieci

Adapter Liftoff Monetize obsługuje dodatkowy parametr żądania, który można przekazać do adaptera za pomocą klasy VungleAdNetworkExtras. Ta klasa zawiera te właściwości:

userId: Ciąg znaków reprezentujący identyfikator użytkownika zachęconego do działania w usłudze Liftoff Monetize.
nativeAdOptionPosition: Liczba całkowita określająca pozycję ikony prywatności w reklamach natywnych.

Oto przykład kodu, który pokazuje, jak utworzyć żądanie reklamy z ustawionymi parametrami:

Swift

let adRequest = Request()
let extras = VungleAdNetworkExtras()
extras.userId = "myUserID"
extras.nativeAdOptionPosition = AdChoicesPosition.topRightCorner
// ...
adRequest.register(extras)LiftoffMonetizeMediationSwiftSnippets.swift

Objective-C

GADRequest *adRequest = [GADRequest request];
VungleAdNetworkExtras *extras = [[VungleAdNetworkExtras alloc] init];
extras.userId = @"myUserID";
extras.nativeAdOptionPosition = GADAdChoicesPositionTopRightCorner;
// ...
[adRequest registerAdNetworkExtras:extras];LiftoffMonetizeMediationObjectiveCSnippets.m

Renderowanie reklam natywnych

Adapter Liftoff Monetize zwraca reklamy natywne jako obiekty GADNativeAd. Wypełnia te pola GADNativeAd:

Pole	Komponenty 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 w przypadku reklam natywnych. Zamiast tego adapter wypełnia element GADMediaView filmem lub obrazem.

Kody błędów

Jeśli adapter nie otrzyma reklamy z Liftoff Monetize, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z GADResponseInfo.adNetworkInfoArray w tych klasach:

Format	Nazwa klasy
Reklama wyświetlana przy otwarciu aplikacji (określanie stawek)	GADMediationAdapterVungle
Przy otwarciu aplikacji (kaskada)	GADMediationAdapterVungle
Baner (określanie stawek)	GADMediationAdapterVungle
Baner (kaskada)	GADMAdapterVungleInterstitial
Reklama pełnoekranowa (określanie stawek)	GADMediationAdapterVungle
Reklama pełnoekranowa (kaskada)	GADMAdapterVungleInterstitial
Reklama z nagrodą (określanie stawek)	GADMediationAdapterVungle
Reklama z nagrodą (kaskada)	GADMAdapterVungleRewardBasedVideoAd
Reklama pełnoekranowa z nagrodą (licytacja)	GADMediationAdapterVungle
Reklama pełnoekranowa z nagrodą (kaskadowa)	GADMediationAdapterVungle
Reklama natywna (określanie stawek)	GADMediationAdapterVungle
Reklama natywna (kaskada)	GADMediationAdapterVungle

Oto kody i komunikaty wyświetlane przez adapter Liftoff Monetize, gdy nie uda się wczytać reklamy:

Kod błędu	Domena	Przyczyna
101	com.google.mediation.vungle	Nieprawidłowe parametry serwera (np. identyfikator aplikacji lub identyfikator miejsca docelowego).
102	com.google.mediation.vungle	Reklama jest już wczytana w tej konfiguracji sieci. Pakiet SDK Vungle nie może wczytać drugiej reklamy dla tego samego identyfikatora miejsca docelowego.
103	com.google.mediation.vungle	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Liftoff Monetize.
104	com.google.mediation.vungle	Pakiet SDK Vungle nie mógł wyświetlić banera reklamowego.
105	com.google.mediation.vungle	Pakiet SDK Vungle obsługuje wczytywanie tylko 1 reklamy banerowej naraz, niezależnie od identyfikatora miejsca docelowego.
106	com.google.mediation.vungle	Pakiet SDK Vungle wysłał wywołanie zwrotne z informacją, że reklama nie może być odtworzona.
107	com.google.mediation.vungle	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.