Ta strona została przetłumaczona przez Cloud Translation API.

Integracja AppLovin z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z AppLovin za pomocą zapośredniczenia obejmującego zarówno kaskady, jak i integracje określania stawek. Dowiesz się z niego, jak dodać AppLovin do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK AppLovin i adapter z Android aplikacją.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia na potrzeby AppLovin udostępnia te funkcje:

Integracja
Ustalanie stawek
Wodospad
Formaty
Baner	¹.
Pełnoekranowa
Otrzymano
Natywna

¹ Banery reklamowe (oprócz banerów MREC) są obsługiwane tylko w ramach zapośredniczenia. Określanie stawek nie obsługuje żadnych typów banerów reklamowych.

Wymagania

Interfejs API Androida na poziomie 21 lub wyższym

[Do określania stawek]: adapter AppLovin w wersji 9.4.2.0 lub nowszej (zalecana najnowsza wersja)

Najnowszy pakiet SDK do reklam mobilnych Google
Wykonaj zapośredniczenie Przewodnik dla początkujących

Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika AppLovin

Zarejestruj się lub zaloguj na konto AppLovin.

Aby skonfigurować Ad Manager jednostkę reklamową, potrzebujesz klucza SDK i klucza raportu AppLovin. Aby je znaleźć, otwórz interfejs AppLovin > Konto > Klucze, aby zobaczyć obie wartości.

Jeśli chcesz tylko zintegrować określanie stawek, możesz przejść do konfigurowania ustawień zapośredniczenia.

Wybierz aplikację do zapośredniczenia

Ustalanie stawek

W przypadku integracji określania stawek ten krok nie jest wymagany.

Wodospad

Aby przejść do zarejestrowanych aplikacji, w interfejsie AppLovin wybierz Applications (Aplikacje) w sekcji Zarabianie. Z listy dostępnych aplikacji wybierz tę, w której chcesz zastosować zapośredniczenie.

Tworzenie strefy

Ustalanie stawek

W przypadku integracji określania stawek ten krok nie jest wymagany.

Wodospad

W interfejsie AppLovin wybierz Strefy w sekcji Zarabianie, aby wyświetlić identyfikatory zarejestrowanych stref. Jeśli masz już utworzone strefy wymagane dla aplikacji, przejdź od razu do kroku 2. Aby utworzyć nowy identyfikator strefy, kliknij Utwórz strefę.

Wpisz nazwę w polu Identyfikator strefy, w polu Platforma wybierz Android, a następnie wybierz Typ reklamy.

Skonfiguruj Ceny dla strefy, wybierając Stały CPM lub Zoptymalizowane przez AppLovin. W przypadku opcji Płaski CPM stawki CPM można konfigurować osobno dla poszczególnych krajów. Następnie kliknij Zapisz.

Po utworzeniu strefy identyfikator strefy znajdziesz w kolumnie Identyfikator strefy.

Włącz tryb testowy

Postępuj zgodnie z instrukcjami w przewodniku AppLovin dotyczącym trybu testowego MAX dotyczącego włączania reklam testowych AppLovin.

Krok 2. Skonfiguruj żądania w AppLovin w Ad Manager interfejsie użytkownika

Zaloguj się na konto Ad Managera.

Dodaj AppLovin do firm

Ustalanie stawek

W przypadku integracji określania stawek ten krok nie jest wymagany.

Wodospad

Przejdź do sekcji Administracja > Firmy i kliknij przycisk Nowa firma na karcie Wszystkie firmy. Kliknij Sieć reklamowa.

Jako Sieć reklamowa wybierz AppLovin, wpisz niepowtarzalną nazwę i włącz Zapośredniczenie. Włącz Automatyczne zbieranie danych i wpisz Report Key uzyskane w poprzedniej sekcji.

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

Włącz udostępnianie bezpiecznych sygnałów

Ustalanie stawek

Kliknij Administracja > Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange, sprawdź i włącz Udostępnianie bezpiecznych sygnałów. Kliknij Save (Zapisz).

Wodospad

W przypadku integracji kaskady ten krok nie jest wymagany.

Skonfiguruj AppLovin określanie stawek

Ustalanie stawek

Kliknij Wyświetlanie > Licytujący, a potem na karcie Określanie stawek przez pakiet SDK kliknij Nowy licytujący.

Jako licytującego wybierz AppLovin.

Przesuń przełącznik obok opcji Dodaj bibliotekę sygnałów tego licytującego do listy dozwolonych sygnałów i Zezwalaj na udostępnianie sygnałów temu licytującemu. Następnie kliknij Dalej.

Kliknij Dalej.

Kliknij Gotowe.

Wodospad

W przypadku integracji kaskady ten krok nie jest wymagany.

Skonfiguruj mapowanie jednostki reklamowej

Ustalanie stawek

Kliknij Wyświetlanie > Licytujący i na karcie Określanie stawek przez pakiet SDK wybierz firmę, dla której chcesz utworzyćAppLovin .

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

Kliknij Konkretna jednostka reklamowa. Wybierz jednostkę reklamową i format, jako Typ zasobów reklamowych wybierz Aplikacja mobilna i kliknij Aplikacja mobilna. Następnie wpiszSDK Key otrzymane w poprzedniej sekcji. Na koniec kliknij Zapisz.

Wodospad

Kliknij Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku. Wybierz aplikację mobilną.

Przewiń w dół i kliknij Dodaj partnera zysku.

Wybierz firmę, dla której utworzyliśmy AppLovin w poprzedniej sekcji. Jako Typ integracji wybierz Zapośredniczenie mobilne SDK, Android jako Platformę i Aktywne jako Stan.

Wpisz wartość Application ID of your app along with the SDK Key and the Zone ID uzyskaną w poprzedniej sekcji oraz wartość Domyślny CPM. Kliknij Zapisz.

Uwaga: automatyczne zbieranie danych potrzebuje kilku dni na zebranie danych, zanim będzie mogło dokładnie obliczyć wartość dynamicznego CPM dla sieci zapośredniczenia. Gdy tylko obliczysz eCPM, jest on automatycznie aktualizowany w Twoim imieniu.

Dodaj AppLovin Corp. 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ć AppLovin Corp. do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w Ad Manager UI.

Krok 3. Zaimportuj pakiet SDK AppLovin i adapter

Integracja z Android Studio (zalecana)

W pliku build.gradle.kts na poziomie aplikacji dodaj poniższe zależności i konfiguracje implementacji. Użyj najnowszych wersji pakietu SDK i adaptera AppLovin:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:applovin:12.5.0.1")
}

Integracja ręczna

Pobierz pakiet SDK AppLovin na Androida, wyodrębnij plik applovin-sdk-x.y.z.jar i dodaj go do swojego projektu.
Otwórz artefakty adaptera AppLovin w repozytorium Google Maven. Wybierz najnowszą wersję, pobierz plik .aar adaptera AppLovin i dodaj go do projektu.

Krok 4. Wdroż 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 dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali określone informacje na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz aby uzyskać od nich zgodę. 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). Podczas uzyskiwania zgody musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe, a także podać informacje o sposobie ich wykorzystania. Obecnie Google nie może automatycznie przekazać tym sieciom wyboru użytkownika dotyczącego zgody.

Od wersji SDK 12.0.0 AppLovin umożliwia odczytywanie ciągu tekstowego dotyczącego zgody z udostępnianych preferencji i odpowiednie ustawianie stanu zgody.

Jeśli nie korzystasz z pakietu SDK AppLovin w wersji 12.0.0 lub nowszej albo nie używasz platformy CMP, która zapisuje ciąg znaków dotyczący zgody użytkownika w udostępnianych preferencjach , możesz użyć metod setHasUserContent i setIsAgeRestrictedUser. Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK AppLovin. Te opcje należy ustawić przed zainicjowaniem pakietu SDK do reklam mobilnych Google, aby zostały prawidłowo przekierowane do pakietu SDK AppLovin.

Java

import com.applovin.sdk.AppLovinPrivacySettings;
// ...

AppLovinPrivacySettings.setHasUserConsent(true, context);

Kotlin

import com.applovin.sdk.AppLovinPrivacySettings
// ...

AppLovinPrivacySettings.setHasUserConsent(true, context)

Poza tym jeśli wiesz, że użytkownik jest objęty ograniczeniem wiekowym, możesz też ustawić poniższą flagę na true.

Java

AppLovinPrivacySettings.setIsAgeRestrictedUser(true, context);

Kotlin

AppLovinPrivacySettings.setIsAgeRestrictedUser(true, context)

Więcej informacji znajdziesz w ustawieniach prywatności w AppLovin.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają umożliwienia użytkownikom wycofania zgody na sprzedaż danych osobowych (w znaczeniu określonym w ustawie), za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej sprzedawcy. 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 każdej sieci reklamowej w łańcuchu zapośredniczenia. Musisz więc wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i zastosować się do zaleceń każdej z nich, by zapewnić zgodność z zasadami.

Pakiet SDK AppLovin zawiera metodę setDoNotSell, która umożliwia wydawcom wycofanie zgody na sprzedaż danych osobowych.

Poniższy przykładowy kod pokazuje, jak przekazać informacje o zgodzie do pakietu SDK AppLovin. Te opcje należy ustawić przed zainicjowaniem pakietu SDK do reklam mobilnych Google, aby zostały prawidłowo przekierowane do pakietu SDK AppLovin.

Java

import com.applovin.sdk.AppLovinPrivacySettings;
// ...

AppLovinPrivacySettings.setDoNotSell(true, context);

Kotlin

import com.applovin.sdk.AppLovinPrivacySettings
// ...

AppLovinPrivacySettings.setDoNotSell(true, context)

Więcej informacji znajdziesz w dokumentacji AppLovin na potrzeby ochrony prywatności.

Krok 5. Dodaj wymagany kod

Integracja z AppLovin nie wymaga dodatkowego kodu.

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby Ad Manager 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 zasady setMuteAudio(), które mogą wyłączać dźwięk w reklamach wideo. Tę metodę można wywołać z obiektu AppLovinExtras.Builder():

Java

Bundle extras = new AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build();

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(ApplovinAdapter.class, extras)
   .build();

Kotlin

val extras = AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build()

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(ApplovinAdapter::class.java, extras)
   .build()

Optymalizacje

Zainicjowanie pakietu SDK AppLovin natychmiast po premierze aplikacji zapewnia AppLovin możliwość śledzenia zdarzeń od razu po uruchomieniu aplikacji.

Java

AppLovinSdk.getInstance("sdkKey", null, context).initializeSdk();

Kotlin

AppLovinSdk.getInstance("sdkKey", null, context).initializeSdk()

Kody błędów

Jeśli adapter nie otrzyma reklamy z AppLovin, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi za pomocą polecenia ResponseInfo.getAdapterResponses() w ramach tych klas:

com.google.ads.mediation.applovin.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

Oto kody i powiązane z nimi komunikaty wysyłane przez adapter AppLovin, gdy reklama się nie wczytuje:

Kod błędu	Przyczyna
Od –1009 do -1, 204	Pakiet SDK AppLovin wystąpił błąd. Więcej informacji znajdziesz w dokumentacji 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.
Od –1009 do -1, 204	Pakiet SDK AppLovin wystąpił błąd. Więcej informacji znajdziesz w dokumentacji AppLovin.
101	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez AppLovin.
102	Brak parametrów serwera AppLovin skonfigurowanych w Ad Manager 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.