Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z AppLovin za pomocą mediacji. Obejmuje on zarówno licytowanie, jak i integrację kaskadową. Znajdziesz w nim informacje o tym, jak dodać AppLovin do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter AppLovin z aplikacją Flutter .
Obsługiwane integracje i formaty reklam
AdMob Adapter pośredniczący AppLovin ma te funkcje:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | 1 |
Pełnoekranowa | |
Z nagrodą |
Banery reklamowe (z wyjątkiem banerów MREC) są obsługiwane tylko w ramach zapośredniczenia. Ustalanie stawek nie obsługuje żadnego typu banerów reklamowych.
Wymagania
- Najnowsza wersja pakietu SDK do reklam mobilnych Google
- Flutter 3.7.0 lub nowszy
- Aby wdrożyć na Androidzie:
- Poziom interfejsu API 21 lub nowszy
- Aby wdrożyć aplikację na iOS:
- docelowa wersja iOS 12.0 lub nowsza,
- działający Flutter projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
- Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.
Krok 1. Skonfiguruj ustawienia w interfejsie AppLovin
Zarejestruj się lub zaloguj się na konto AppLovin.
Aby skonfigurować jednostkę reklamową AdMob, musisz mieć klucz SDK i klucz raportowania AppLovin. Aby je znaleźć, otwórz UI AppLovin > Konto > Klucze, aby wyświetlić obie wartości.
Jeśli zamierzasz tylko zintegrować ustalanie stawek, możesz przejść do konfigurowania ustawień pośrednictwa.
Wybieranie aplikacji do zapośredniczenia
Określanie stawek
Ten krok nie jest wymagany w przypadku integracji określania stawek.
Wodospad
Aby wyświetlić zarejestrowane aplikacje, w interfejsie AppLovin wybierz Aplikacje w sekcji Zarabianie. Na liście dostępnych aplikacji wybierz aplikację, której chcesz używać do zapośredniczenia.
Utwórz strefę
Określanie stawek
Ten krok nie jest wymagany w przypadku integracji określania stawek.
Wodospad
W interfejsie AppLovin w sekcji Zarabianie wybierz Strefy, aby wyświetlić zarejestrowane identyfikatory stref. Jeśli masz już utworzone wymagane strefy dla aplikacji, przejdź do kroku 2. Aby utworzyć nowy identyfikator strefy, kliknij Utwórz strefę.
Wpisz nazwę identyfikatora strefy, wybierz Android jako platformę i wskaż Typ reklamy.
Skonfiguruj Ceny w przypadku strefy, wybierając Stałe CPM lub Zoptymalizowane przez AppLovin. W przypadku opcji Stałe CPM stawki CPM można konfigurować osobno dla każdego kraju. Następnie kliknij Zapisz.
Android
iOS
Po utworzeniu strefy jej identyfikator znajdziesz w kolumnie Identyfikator strefy.
Android
iOS
Włączanie trybu testowego
Aby włączyć reklamy testowe AppLovin, postępuj zgodnie z instrukcjami w przewodniku AppLovin Tryb testowy MAX.
Krok 2. Skonfiguruj zapotrzebowanie AppLovin w interfejsie AdMob
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym Android.
iOS
Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym iOS.
Dodawanie AppLovin Corp. do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA
Aby dodać Applovin Corp. do listy partnerów reklamowych w ustawieniach RODO i przepisów stanowych w USA w interfejsie AdMob, wykonaj czynności opisane w ustawieniach RODO i ustawieniach dotyczących przepisów stanowych w USA.
Krok 3. Zaimportuj pakiet SDK i adapter AppLovin
Krok 4. Wprowadź ustawienia prywatności w pakiecie SDK AppLovin
Zgoda użytkowników z UE i RODO
Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz zadbać o to, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali odpowiednie informacje i wyrazili zgodę na wykorzystywanie 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. Obecnie Google nie może automatycznie przekazywać wyboru użytkownika dotyczącego wyrażenia zgody do takich sieci.
AppLovin obsługuje odczytywanie ciągu tekstowego dotyczącego zgody z udostępnionych preferencji i odpowiednie ustawianie stanu zgody.Jeślinie używasz platformy CMP, która zapisuje ciąg znaków zgody w wspólnych preferencjach, możesz użyć metod
GmaMediationApplovin.setHasUserConsent()
oraz GmaMediationApplovin.setIsAgeRestrictedUser()
. Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu AppLovin SDK. Te opcje muszą zostać ustawione przed inicjowaniem pakietu SDK do reklam mobilnych Google, aby zapewnić ich prawidłowe przekazywanie do pakietu SDK AppLovin.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);
Więcej informacji znajdziesz w ustawieniach prywatności AppLovin.
Amerykańskie przepisy stanowe o ochronie prywatności
Amerykańskie przepisy stanowe o ochronie prywatności nakładają na Ciebie obowiązek zapewnienia użytkownikom możliwości wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu musisz umieścić na stronie głównej „sprzedającego” dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”). Przewodnik dotyczący zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w celu wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia w przypadku każdej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność.
Wtyczka zapośredniczenia reklam mobilnych Google do AppLovinobsługuje metodę
GmaMediationApplovin.setDoNotSell()
. Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK AppLovin. Te opcje muszą być ustawione przed inicjowaniem pakietu SDK do reklam mobilnych Google, aby zapewnić ich prawidłowe przekazywanie do pakietu SDK AppLovin.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setDoNotSell(true);
Więcej informacji znajdziesz w dokumentacji AppLovin's Privacy Documentation.
Krok 5. Dodaj wymagany kod
Android
Integracja z AppLovin nie wymaga dodatkowego kodu.
iOS
Integracja z SKAdNetwork
Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją AppLovin.
Krok 6. Przetestuj implementację
Włączanie reklam testowych
Pamiętaj, aby zarejestrować urządzenie testowe w AdMob i włączyć tryb testowy w interfejsie Applovin.
Weryfikowanie reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z Applovin, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródeł reklam Applovin (z ustalaniem stawek) i Applovin (kaskada).
Kroki opcjonalne:
Parametry związane z siecią
Adapter AppLovin umożliwia przekazanie do żądania reklamy obiektu AppLovinMediationExtras
, aby ustawić parametry specyficzne dla sieci. Poniższy przykładowy kod pokazuje, jak wyłączyć dźwięk w reklamach wideo za pomocą parametru isMuted
:
AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [applovinExtras],
);
Optymalizacje
Dodanie do aktywności uruchamiającej wywołania
GmaMediationApplovin.initializeSdk('sdkKey')
pozwala AppLovin śledzić zdarzenia od razu po uruchomieniu aplikacji.
Kody błędów
Jeśli adapter nie otrzyma reklamy z AppLovin, wydawcy mogą sprawdzić błąd w odpowiedzi na reklamę, korzystając z interfejsu ResponseInfo
w tych klasach:
Android
com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter
iOS
GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin
Oto kody i odpowiednie komunikaty z adaptera AppLovin, które pojawiają się, gdy nie udaje się załadować reklamy:
Android
Kod błędu | Przyczyna |
---|---|
–1009 do –1 204 | Pakiet SDK AppLovin zwrócił błąd. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją AppLovin. |
101 | Żądany rozmiar reklamy nie odpowiada obsługiwanemu rozmiarowi banera w AppLovin. |
103 | Kontekst ma wartość null. |
104 | Token stawki AppLovin jest pusty. |
105 | przesłano wiele reklam w tym samym obszarze; AppLovin może wczytać tylko 1 reklamę na każdą strefę. |
106 | Reklama nie jest gotowa do wyświetlenia. |
108 | Adapter AppLovin nie obsługuje żądanego formatu reklamy. |
iOS
Kod błędu | Przyczyna |
---|---|
–1009 do –1 204 | Pakiet SDK AppLovin zwrócił błąd. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją AppLovin. |
101 | Żądany rozmiar reklamy nie odpowiada obsługiwanemu rozmiarowi banera w AppLovin. |
102 | Parametry serwera AppLovin skonfigurowane w interfejsie użytkownika AdMob są nieobecne lub nieprawidłowe. |
103 | Nie udało się wyświetlić reklamy AppLovin. |
104 | przesłano wiele reklam w tym samym obszarze; AppLovin może wczytać tylko 1 reklamę na każdą strefę. |
105 | Nie znaleziono klucza pakietu SDK AppLovin. |
107 | Token stawki jest pusty. |
108 | Adapter AppLovin nie obsługuje żądanego formatu reklamy. |
110 | AppLovin wysłał wywołanie zwrotne pomyślnie załadowanej reklamy, ale nie załadował żadnej reklamy. |
111 | Nie udało się pobrać instancji pakietu SDK AppLovin. |
112 | Użytkownik jest dzieckiem. |
Historia zmian adaptera zapośredniczenia AppLovin Flutter
Następna wersja
- Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.2.0.
1.2.0
- Weryfikowana zgodność z adapterem AppLovin na Androida w wersji 12.6.1.0.
- Weryfikowana zgodność z adapterem AppLovin na iOS w wersji 12.6.1.0.
- Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.
1.1.0
- Interfejs API usługi GmaMediationApplovin nie jest już statyczny.
- Weryfikowana zgodność z adapterem AppLovin na Androida w wersji 12.4.3.0.
- Weryfikowana zgodność z adapterem AppLovin na iOS w wersji 12.4.2.0.
- Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.
1.0.0
- Pierwsza wersja.
- Weryfikowana zgodność z adapterem AppLovin na Androida w wersji 12.3.0.0
- Weryfikowana zgodność z adapterem AppLovin na iOS w wersji 12.2.1.0
- Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.0.0.