Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z AppLovin za pomocą zapośredniczenia, obejmujące zarówno integrację określania stawek, jak i kaskady. Wyjaśniamy, jak dodać do AppLovin do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK AppLovin. i adaptera Flutter do aplikacji.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia AdMob do AppLovin zawiera te funkcje:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | 1. |
Pełnoekranowa | |
Z nagrodą |
Banery reklamowe (z wyłączeniem MREC) banerów) są obsługiwane tylko w ramach zapośredniczenia. Określanie stawek nie obsługuje żadnego typu banerów reklamowych.
Wymagania
- Najnowszy pakiet SDK do reklam mobilnych Google
- Flutter w wersji 3.7.0 lub nowszej
- 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 Flutter projekt skonfigurowany w Google Pakiet SDK do reklam mobilnych. Zobacz Rozpocznij, aby dowiedzieć się więcej.
- Dokończ zapośredniczenie Przewodnik dla początkujących
Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika AppLovin
Zarejestruj się lub zaloguj z kontem AppLovin.
Aby skonfigurować jednostkę reklamową AdMob, musisz mieć Klucz pakietu SDK i klucz raportu AppLovin. Aby je znaleźć, wejdź na Interfejs AppLovin > Konto > Klucze, aby zobaczyć obie te wartości.
Jeśli planujesz tylko zintegrować określanie stawek, przejdź do skonfigurować ustawienia zapośredniczenia.
Wybierz aplikację do zapośredniczenia
Określanie stawek
Nie musisz tego robić w przypadku integracji z określaniem stawek.
Wodospad
W interfejsie AppLovin wybierz Applications (Aplikacje) w sekcji Zarabianie, aby przejść do zarejestrowanych aplikacji. Wybierz aplikację których chcesz używać z zapośredniczeniem, z listy dostępnych aplikacji.
Utwórz strefę
Określanie stawek
Nie musisz tego robić w przypadku integracji z określaniem stawek.
Wodospad
W interfejsie AppLovin w sekcji Zarabianie wybierz Strefy. , aby przejść do zarejestrowanych identyfikatorów stref. Jeśli utworzyłeś już wymagane strefy dla aplikacji, przejdź od razu do kroku 2. Aby utworzyć nowy identyfikator strefy, kliknij Utwórz strefę.
Wpisz nazwę Zone ID (Identyfikator strefy), a jako Platformę wybierz Android. wybierz Typ reklamy.
Skonfiguruj Ceny dla strefy, wybierając Stały CPM lub Zoptymalizowane przez AppLovin. Stawki CPM można konfigurować dla poszczególnych krajów: opcję Stały CPM. Następnie kliknij Zapisz.
Android
iOS
Po utworzeniu strefy jej identyfikator znajdziesz w sekcji Identyfikator strefy. .
Android
iOS
Włącz tryb testowy
Postępuj zgodnie z instrukcjami w AppLovin Tryb testowy (MAX) .
Krok 2. Skonfiguruj żądania w AppLovin 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 AppLovin Corp. do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi
Krok 3. Zaimportuj pakiet SDK AppLovin i adapter
Integracja przez pub.dev
Dodaj tę zależność z najnowszymi wersjami funkcji
AppLovin Pakiet SDK i adapter w pakiecie
Plik pubspec.yaml
:
dependencies:
gma_mediation_applovin: ^1.0.0
Integracja ręczna
Pobierz najnowszą wersję wtyczki do zapośredniczenia reklam mobilnych Google dla AppLovin, wyodrębnij pobrany plik i dodaj wyodrębniony folder wtyczki (oraz jego zawartość) do projektu Flutter. Następnie sprawdź informacje o wtyczce w
pubspec.yaml
przez dodanie tej zależności:
dependencies:
gma_mediation_applovin:
path: path/to/local/package
Krok 4. Wdroż ustawienia prywatności w pakiecie SDK AppLovin
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. Zasady te odzwierciedlają wymagania unijnej dyrektywy o prywatności i łączności elektronicznej oraz Ogólnej ustawy o ochronie danych Rozporządzenie (RODO). Wyświetlając prośbę o zgodę na wykorzystanie danych, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe i dostarczają informacji o korzystaniu z poszczególnych sieci. Google obecnie nie może automatycznego przekazywania do takich sieci wyboru użytkownika dotyczącego zgody.
AppLovin obsługuje odczytywanie ciągu tekstowego dotyczącego zgody z udostępnionych preferencji i ustawień odpowiedni stan zgody.Jeśli jesteś
nie korzystasz z platformy CMP, która zapisuje ciąg znaków dotyczący zgody w udostępnianych danych
ustawień, możesz użyć
GmaMediationApplovin.setHasUserConsent()
i
GmaMediationApplovin.setIsAgeRestrictedUser()
. Poniższy przykładowy kod pokazuje,
do przekazywania informacji
o zgodzie do pakietu SDK AppLovin. Te opcje muszą być skonfigurowane
przed zainicjowaniem pakietu SDK do reklam mobilnych Google.
, aby mieć pewność, że zostaną prawidłowo przekazane do pakietu SDK AppLovin.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);
Zobacz ustawienia prywatności w AppLovin .
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 zgodnie ze wskazówkami dotyczącymi tych sieci, aby zapewnić zgodność z przepisami.
Wtyczka zapośredniczenia do reklam mobilnych Google dla AppLovin
obejmuje
GmaMediationApplovin.setDoNotSell()
. Poniższy przykładowy kod pokazuje, jak to zrobić
informacji o zgodzie użytkowników pakietu SDK AppLovin. Te opcje należy skonfigurować przed
zainicjuj reklamy mobilne Google
pakiet SDK
, aby mieć pewność, że zostaną prawidłowo przekazane do pakietu SDK AppLovin.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setDoNotSell(true);
Zapoznaj się z informacjami na temat prywatności w AppLovin dokumentacja .
Krok 5. Dodaj wymagany kod
Android
Integracja z AppLovin nie wymaga dodatkowego kodu.
iOS
Integracja SKAdNetwork
Postępuj zgodnie z dokumentacją AppLovin. 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 AppLovin interfejsie użytkownika.
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyAppLovin, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z AppLovin (Bidding) and AppLovin (Waterfall) źródeł reklam.
Kroki opcjonalne:
Parametry charakterystyczne dla sieci
Adapter AppLovin obsługuje przesyłanie obiektu AppLovinMediationExtras
do
żądania reklamy na potrzeby konfiguracji parametrów sieci. Oto przykładowy kod
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
Dodaję połączenie do:
GmaMediationApplovin.initializeSdk('sdkKey')
w aktywności związanej z premierą produktu,
AppLovin umożliwia śledzenie zdarzeń natychmiast po uruchomieniu aplikacji.
Kody błędów
Jeśli adapter nie odbierze reklamy z AppLovin,
wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi za pomocą polecenia
ResponseInfo
w
następujące klasy:
Android
com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter
iOS
GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin
Oto kody i powiązane z nimi wiadomości wysyłane przez adapter AppLovin gdy nie można wczytać reklamy:
Android
Kod błędu | Przyczyna |
---|---|
Od –1009 do -1, 204 | Pakiet SDK AppLovin wystąpił błąd. Zobacz Dokumentacja AppLovin . |
101 | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez AppLovin. |
103 | Kontekst jest pusty. |
104 | Token stawki AppLovin jest pusty. |
105 | Zażądano kilku reklam dla tej samej strefy. AppLovin może wczytywać tylko 1 reklamę naraz na strefę. |
106 | Reklama nie jest gotowa do wyświetlenia. |
108 | Adapter AppLovin nie obsługuje żądanego formatu reklamy. |
iOS
Kod błędu | Przyczyna |
---|---|
Od –1009 do -1, 204 | Pakiet SDK AppLovin wystąpił błąd. Zobacz dokumentację AppLovin . |
101 | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez AppLovin. |
102 | Brak parametrów serwera AppLovin skonfigurowanych w AdMob interfejsie lub są one nieprawidłowe. |
103 | Nie udało się wyświetlić reklamy AppLovin. |
104 | Zażądano kilku reklam dla tej samej strefy. AppLovin może wczytywać tylko 1 reklamę naraz na 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ła pomyślne wywołanie zwrotne wczytywania, ale nie wczytała żadnych reklam. |
Historia zmian adaptera zapośredniczenia AppLovin Flutter
1.2.0
- Zweryfikowano zgodność z adapterem AppLovin na Androida w wersji 12.6.1.0.
- Zweryfikowano zgodność z adapterem systemu iOS AppLovin w wersji 12.6.1.0.
- Utworzono i przetestowano z użyciem wtyczki Google Mobile Ads Flutter w wersji 5.1.0.
1.1.0
- Interfejs API dla GmaMediationApplovin nie jest już statyczny.
- Zweryfikowano zgodność z adapterem AppLovin na Androida w wersji 12.4.3.0.
- Zweryfikowano zgodność z adapterem systemu iOS AppLovin w wersji 12.4.2.0.
- Utworzono i przetestowano z użyciem wtyczki Google Mobile Ads Flutter w wersji 5.1.0.
1.0.0
- Pierwsza wersja.
- Zweryfikowano zgodność z adapterem AppLovin na Androida w wersji 12.3.0.0
- Zweryfikowano zgodność z adapterem systemu iOS AppLovin w wersji 12.2.1.0
- Utworzono i przetestowano z użyciem wtyczki Google Mobile Ads Flutter w wersji 5.0.0.