Integracja AppLovin z zapośredniczeniem

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ą Unity .

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob do AppLovin udostępnia 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
  • Unity w wersji 5.6 lub nowszej
  • [Do określania stawek]: wtyczka zapośredniczenia do reklam mobilnych Google dla platformy AppLovin 4.2.0 lub nowszej (zalecana najnowsza wersja)
  • Aby wdrożyć na Androidzie:
    • Poziom interfejsu API 21 lub nowszy
  • Aby wdrożyć w iOS:
    • docelowa wersja iOS 12.0 lub nowsza
  • działający Unity 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 wybierz Strefy w sekcji Monetization (Zarabianie), 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 cenę dla strefy, wybierając Stały CPM lub Optymalizacja 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

Postępuj zgodnie z instrukcjami zawartymi w przewodniku AppLovin dotyczącym trybu testowego „MAX”, aby dowiedzieć się, jak włączyć reklamy testowe AppLovin.

Krok 2. Skonfiguruj zapotrzebowanie AppLovin w interfejsie AdMob

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.

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 AppLovin i adapter

OpenUPM-CLI

Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować w swoim projekcie wtyczkę zapośredniczenia AppLovin do reklam mobilnych Google, uruchamiając to polecenie z katalogu głównego projektu:

openupm add com.google.ads.mobile.mediation.applovin

OpenUPM

W edytorze projektu Unity wybierz Edytuj > Ustawienia projektu > Menedżer pakietów, aby otworzyć ustawienia menedżera pakietów Unity.

Na karcie Rejestry o zakresie dodaj OpenUPM jako rejestr z ograniczonym dostępem z tymi informacjami:

  • Nazwa: OpenUPM
  • Adres URL: https://package.openupm.com
  • Zakresy: com.google

Szczegóły UPM

Następnie wybierz Okno > Menedżer pakietów, aby otworzyć menedżera pakietów Unity, i z menu wybierz My Registries (Moje rejestry).

Rejestry Unity

Wybierz pakiet Google Mobile Ads AppLovin Mediation i kliknij Zainstaluj.

Zainstaluj z OpenUPM

Pakiet Unity

Pobierz najnowszą wersję wtyczki do mediowania reklam mobilnych Google dla AppLovin za pomocą linku do pobrania w Changelogu i wyodrębnij plik GoogleMobileAdsAppLovinMediation.unitypackage z pliku ZIP.

W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsAppLovinMediation.unitypackage. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.

Importuj z Unity

Następnie kliknij Zasoby > Menedżer zależności zewnętrznych > Rozwiązanie Androida > Wymuś rozwiązanie. Biblioteka zewnętrznego menedżera zależności przeprowadzi rozpoznawanie zależności od zera i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android aplikacji Unity.

Wymuś rozwiązanie

Krok 4. Wdroż ustawienia prywatności w pakiecie SDK AppLovin

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.

Od wersji 7.0.0 wtyczki do pośredniczenia reklam mobilnych Google AppLovin obsługuje odczytywanie ciągu tekstowego dotyczącego zgody z udostępnionych preferencji i odpowiednie ustawianie stanu zgody.

Jeślinie używasz w Applovin wtyczki do zapośredniczenia Google Mobile Ads w wersji 7.0.0 lub nowszej albonie używasz platformy CMP, która zapisuje ciąg znaków zgody w wspólnych preferencjach, możesz użyć metodAppLovin.SetHasUserConsent() i AppLovin.SetIsAgeRestrictedUser(). Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu AppLovin SDK. Te opcje muszą zostać ustawione przed zainicjowaniem pakietu SDK do reklam mobilnych Google, aby zapewnić ich prawidłowe przekazywanie do pakietu SDK AppLovin.

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetHasUserConsent(true);

Jeśli wiesz, że użytkownik należy do kategorii objętej ograniczeniem wiekowym, możesz też ustawić flagę na true.

AppLovin.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 AppLovinw wersji 6.3.1obsługuje metodęAppLovin.SetDoNotSell(). 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.

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.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:

Optymalizacje

Dodanie wywołania do AppLovin.Initialize() do działania dotyczącego uruchomienia 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
Od –1009 do -1, 204 Pakiet SDK AppLovin zwrócił błąd. Więcej informacji znajdziesz w dokumentacji AppLovin.
101 Żądany rozmiar reklamy nie odpowiada obsługiwanemu rozmiarowi banera w AppLovin.
103 Kontekst jest pusty.
104 Token stawki AppLovin jest pusty.
105 Zażądano kilku reklam dla tej samej strefy. AppLovin może wczytać tylko 1 reklamę na każdą strefę.
106 Reklama nie jest gotowa do wyświetlania.
108 Adapter AppLovin nie obsługuje żądanego formatu reklamy.

iOS

Kod błędu Przyczyna
–1009 do –1 204 Pakiet SDK AppLovin wystąpił 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ślnego wczytania, ale nie załadował żadnej reklamy.
111 Nie udało się pobrać instancji pakietu SDK AppLovin.
112 Użytkownik jest dzieckiem.

Historia zmian wtyczki AppLovin Unity Mediation

Następna wersja

  • Usunięto z klasy AppLovin te metody:
    • Initialize()
    • SetIsAgeRestrictedUser(bool)

Wersja 7.4.1

Wersja 7.4.0

Wersja 7.3.1

Wersja 7.3.0

Wersja 7.2.2

Wersja 7.2.1

Wersja 7.2.0

Wersja 7.1.0

Wersja 7.0.1

Wersja 7.0.0

Wersja 6.9.1

Wersja 6.9.0

Wersja 6.8.0

Wersja 6.7.0

Wersja 6.6.0

Wersja 6.5.1

Wersja 6.5.0

Wersja 6.4.3

Wersja 6.4.2

Wersja 6.4.1

Wersja 6.4.0

Wersja 6.3.1

Wersja 6.3.0

Wersja 6.2.1

Wersja 6.2.0

Wersja 6.1.0

Wersja 6.0.0

Wersja 5.1.3

Wersja 5.1.2

Wersja 5.1.1

Wersja 5.1.0

Wersja 5.0.0

Wersja 4.8.1

Wersja 4.8.0

Wersja 4.7.0

Wersja 4.6.2

Wersja 4.6.1

Wersja 4.6.0

Wersja 4.5.8

Wersja 4.5.7

Wersja 4.5.6

Wersja 4.5.5

Wersja 4.5.4

Wersja 4.5.3

Wersja 4.5.2

Wersja 4.5.1

Wersja 4.5.0

Wersja 4.4.1

Wersja 4.4.0

Wersja 4.3.0

Wersja 4.2.0

  • Obsługuje adapter AppLovin na Androida w wersji 9.4.2.0.
  • Obsługuje adapter AppLovin na iOS w wersji 6.6.1.0.

Wersja 4.1.0

  • Zaktualizowano wtyczkę, aby obsługiwała nowy interfejs API do reklam z nagrodą w ramach otwartych testów beta.
  • Obsługuje adapter AppLovin na Androida w wersji 9.2.1.1.
  • Obsługuje adapter AppLovin na iOS w wersji 6.3.0.0.

Wersja 4.0.0

  • Obsługuje adapter AppLovin na Androida w wersji 9.2.1.0.
  • Obsługuje adapter AppLovin na iOS w wersji 6.2.0.0.

Wersja 3.1.2

  • Obsługuje adapter AppLovin na Androida w wersji 8.1.4.0.
  • Obsługuje adapter AppLovin na iOS w wersji 5.1.2.0.

Wersja 3.1.1

  • Obsługuje adapter AppLovin na Androida w wersji 8.1.0.0.
  • Obsługuje adapter AppLovin na iOS w wersji 5.1.1.0.

Wersja 3.1.0

  • Obsługuje adapter AppLovin na Androida w wersji 8.1.0.0.
  • Obsługuje adapter AppLovin na iOS w wersji 5.1.0.0.

Wersja 3.0.3

  • Obsługuje adapter AppLovin na Androida w wersji 8.0.2.1.
  • Obsługuje adapter AppLovin na iOS w wersji 5.0.2.0.

Wersja 3.0.2

  • Obsługuje pakiet SDK AppLovin na Androida w wersji 8.0.1.
  • Obsługuje pakiet SDK AppLovin na iOS w wersji 5.0.1.

Wersja 3.0.1

  • Obsługuje pakiet SDK AppLovin na Androida w wersji 8.0.0.
  • Obsługuje pakiet SDK AppLovin na iOS w wersji 5.0.1.
  • Dodano metodę AppLovin.SetIsAgeRestrictedUser(), aby wskazać, czy użytkownik należy do kategorii objętej ograniczeniem wiekowym.

Wersja 3.0.0

  • Obsługuje pakiet SDK AppLovin na Androida w wersji 8.0.0.
  • Obsługuje pakiet SDK AppLovin na iOS w wersji 5.0.1.
  • Dodano metodę AppLovin.SetHasUserConsent(), która przekazuje flagę zgody użytkownika do pakietu SDK AppLovin.

Wersja 2.0.0

  • Obsługuje pakiet SDK AppLovin na Androida w wersji 7.8.6.
  • Obsługuje pakiet SDK AppLovin na iOS w wersji 5.0.1.

Wersja 1.2.1

  • Obsługuje pakiet SDK AppLovin na Androida w wersji 7.8.6 na Androida.
  • Obsługuje pakiet SDK AppLovin na iOS w wersji 4.8.3.

Wersja 1.2.0

  • Obsługuje pakiet SDK AppLovin na Androida w wersji 7.8.5.
  • Obsługuje pakiet SDK AppLovin na iOS w wersji 4.8.3.

Wersja 1.1.0

  • Obsługuje pakiet SDK AppLovin na Androida w wersji 7.7.0.
  • Obsługuje pakiet SDK AppLovin na iOS w wersji 4.7.0.

Wersja 1.0.0

  • Pierwsza wersja
  • Obsługuje pakiet SDK AppLovin na Androida w wersji 7.4.1.
  • Obsługuje pakiet SDK AppLovin na iOS w wersji 4.4.1.