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, co obejmuje zarówno integrację określania stawek, jak i integracji kaskady. Omawiamy w nim, jak dodać AppLovin do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter AppLovin z aplikacją na Unity.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dla AppLovin ma te możliwości:

Integracja
Ustalanie stawek
Wodospad
Formaty
Baner  1
Pełnoekranowa
Otrzymano

Banery reklamowe (z wyjątkiem banerów MREC) są obsługiwane tylko w zapośredniczeniu. Określanie stawek nie obsługuje żadnych rodzajów banerów reklamowych.

Wymagania

  • Najnowszy pakiet SDK do reklam mobilnych Google
  • Unity w wersji 5.6 lub nowszej
  • [W przypadku określania stawek]: wtyczka zapośredniczenia reklam mobilnych Google dla AppLovin w wersji 4.2.0 lub nowszej (zalecana najnowsza wersja)
  • 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 Unity projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • Skorzystaj z zapośredniczenia Wprowadzenie

Krok 1. Skonfiguruj konfiguracje w interfejsie AppLovin

Zarejestruj się lub zaloguj na konto AppLovin.

Aby skonfigurować AdMob 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.

Android

iOS

Po utworzeniu strefy identyfikator strefy znajdziesz w kolumnie Identyfikator strefy.

Android

iOS

.

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 oferty reklamowe 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.

Dodanie 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 AdMob UI.

Krok 3. Zaimportuj pakiet SDK i adapter AppLovin

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla AppLovin, korzystając z linku do pobierania w Historii zmian i wyodrębnij 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.

Następnie wybierz Zasoby > Program do rozpoznawania Usług Google Play > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka programu do rozpoznawania zależności usług Unity Play zajmie się rozpoznawaniem zależności od zera i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android aplikacji Unity.

Krok 4. Zaimplementuj ustawienia prywatności w pakiecie SDK AppLovin

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.

Od wtyczki zapośredniczenia do reklam mobilnych Google w wersji 7.0.0 AppLovin umożliwia odczyt ciągu tekstowego dotyczącego zgody użytkownika ze wspólnych preferencji i odpowiednie ustawianie stanu zgody.

Jeślinie używasz wtyczki zapośredniczenia reklam mobilnych Google w aplikacji Applovin w wersji 7.0.0 lub nowszej albonie używasz platformy do zarządzania zgodą użytkowników, która zapisuje ciąg znaków dotyczący zgody użytkownika w udostępnianych preferencjach, możesz użyć metod AppLovin.SetHasUserConsent() i AppLovin.SetIsAgeRestrictedUser() . Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK AppLovin. Te opcje musisz skonfigurować przed zainicjowaniem pakietu SDK do reklam mobilnych Google, aby mieć pewność, że zostaną prawidłowo przekierowane do pakietu SDK AppLovin.

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

AppLovin.SetHasUserConsent(true);

Jeśli wiadomo, że użytkownik należy do kategorii z ograniczeniem wiekowym, możesz też ustawić poniżej 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 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 dla AppLovin, w wersji 6.3.1 zawiera 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 upewnić się, że zostaną prawidłowo przekazane do pakietu SDK AppLovin.

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

AppLovin.SetDoNotSell(true);

Więcej informacji znajdziesz w dokumentacji dotyczącej prywatności w AppLovin.

Krok 5. Dodaj wymagany kod

Android

Integracja z AppLovin nie wymaga dodatkowego kodu.

iOS

Integracja SKAdNetwork

Wykonaj 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:

Optymalizacje

Dodanie wywołania do AppLovin.Initialize() do aktywności związanej z wprowadzaniem aplikacji na rynek umożliwia AppLovin śledzenie zdarzeń natychmiast po uruchomieniu aplikacji.

Kody błędów

Jeśli adapter nie otrzyma reklamy z AppLovin, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi na żądanie reklamy, korzystając z 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 powiązane z nimi komunikaty przesyłane przez adapter AppLovin, gdy reklama się nie wczytuje:

Android

Kod błędu Przyczyna
Od –1009 do –1, 204 Pakiet SDK do AppLovin zwrócił komunikat o błędzie. 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 wielu reklam dla tej samej strefy. AppLovin może wczytać tylko 1 reklamę w danej strefie.
106 Reklama nie jest gotowa do wyświetlania.
108 Adapter AppLovin nie obsługuje żądanego formatu reklamy.

iOS

Kod błędu Przyczyna
Od –1009 do –1, 204 Pakiet SDK do AppLovin zwrócił komunikat o błędzie. Więcej informacji znajdziesz w dokumentacji AppLovin.
101 Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez AppLovin.
102 Brakuje parametrów serwera AppLovin skonfigurowanych w interfejsie AdMob lub są one nieprawidłowe.
103 Nie udało się wyświetlić reklamy AppLovin.
104 Zażądano wielu reklam dla tej samej strefy. AppLovin może wczytać tylko 1 reklamę w danej strefie.
105 Nie znaleziono klucza pakietu SDK AppLovin.
107 Token stawki jest pusty.
108 Adapter AppLovin nie obsługuje żądanego formatu reklamy.
110 Aplikacja AppLovin wysłała wywołanie zwrotne wczytywania, ale nie wczytała żadnych reklam.

Historia zmian wtyczki AppLovin Unity Mediation

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

  • Zaktualizowaliśmy wtyczkę, aby obsługiwała nowy interfejs API z nagrodą w otwartej wersji 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 z ograniczeniami wiekowymi.

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(), aby przekazywać 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.
  • 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.