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. Opisano w nim, jak dodać Liftoff Monetize do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Vungle z aplikacjąFlutter .
Obsługiwane integracje i formaty reklam
1 Integracja z określaniem stawek 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
- Flutter w wersji 3.7.0 lub nowszej
- 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 Flutter 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, 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 popyt na platformę Liftoff Monetize w Ad Manager interfejsie użytkownika
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
Integracja za pomocą pub.dev
Dodaj tę zależność do najnowszych wersji pakietuLiftoff Monetize SDK i adaptera w pliku pubspec.yaml
pakietu:
dependencies:
gma_mediation_liftoffmonetize: ^1.0.0
Integracja ręczna
Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla Liftoff Monetize, wyodrębnij pobrany plik i dodaj do projektu Flutter wyodrębniony folder wtyczki (wraz z jego zawartością). Następnie odwołaj się do wtyczki w pliku pubspec.yaml
, dodając tę zależność:
dependencies:
gma_mediation_liftoffmonetize:
path: path/to/local/package
Krok 4. Zastosuj ustawienia prywatności w pakiecie SDK Liftoff Monetize
Zgoda użytkowników z UE i RODO
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 do narzędzia Liftoff Monetize obsługuje metodę GmaMediationLiftoffmonetize.setGDPRStatus()
. Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK Vungle. Jeśli zdecydujesz się wywoływać tę metodę, zalecamy jej wywołanie przed wysłaniem żądań reklam za pomocą pakietu SDK do reklam mobilnych Google.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");
Więcej informacji oraz wartości, które mogą być podane w tej metodzie, znajdziesz w instrukcjach implementacji zalecanej przez RODO w przypadku Androida i iOS.
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 do narzędzia Liftoff Monetize obsługuje metodę GmaMediationLiftoffmonetize.setCCPAStatus()
. Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK Vungle. Jeśli zdecydujesz się wywoływać tę metodę, zalecamy jej wywołanie przed wysłaniem żądań reklam za pomocą pakietu SDK do reklam mobilnych Google.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setCCPAStatus(true);
Więcej informacji oraz wartości, które mogą być podane w tej metodzie, znajdziesz w instrukcjach wdrażania zalecanej ustawy CCPA w przypadku Androida i iOS.
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 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 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 Ad Manager 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 w zarabianiu – historia zmian w adapterze zapośredniczenia Flutter
Wersja 1.0.0
- Pierwsza wersja.
- Zweryfikowana zgodność z adapterem Liftoff Monetize na Androidzie w wersji 7.3.1.0
- Zweryfikowana zgodność z adapterem LiftoffMonetize na iOS w wersji 7.3.2.0
- Stworzona i przetestowana z wtyczką Google Mobile Ads Flutter w wersji 5.1.0.