Integracja AppLovin z zapośredniczeniem

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 integracje 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 Unity 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
  • Unity w wersji 5.6 lub nowszej
  • [Do określania stawek]: wtyczka zapośredniczenia do reklam mobilnych Google dla AppLovin 4.2.0 lub wyższy (zalecana najnowsza wersja)
  • 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 Unity 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 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 żą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

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

OpenUPM-CLI

Jeśli masz OpenUPM-CLI możesz zainstalować aplikację do reklam mobilnych Google AppLovin Wtyczka zapośredniczenia dla Unity do projektu, uruchamiając to 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ć plik Ustawienia menedżera pakietów Unity

Na karcie Rejestry o zakresie dodaj OpenUPM jako rejestr z zakresem następujące szczegóły:

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

Szczegóły OpenUPM

Następnie otwórz Okno > Menedżer pakietów, aby otworzyć plik Unity Package Manager oraz Z menu wybierz My Registries (Moje rejestry).

Rejestry Unity

Wybierz Zapośredniczenie Google Mobile Ads AppLovin dla: pakietu Unity i kliknij Zainstaluj.

Zainstaluj z OpenUPM

Pakiet Unity

Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla AppLovin kliknij link do pobrania w Historia zmian i wyodrębnij GoogleMobileAdsAppLovinMediation.unitypackage z pliku ZIP.

W edytorze projektów Unity wybierz Zasoby > Importuj pakiet > Custom Package (Pakiet niestandardowy) i znajdź GoogleMobileAdsAppLovinMediation.unitypackage pobranego pliku. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.

Importuj z Unity

Potem kliknij Komponenty > Program do rozpoznawania usług Google Play > Program do rozpoznawania Androida > Wymuś rozwiązanie. Program do rozpoznawania usług Unity Play biblioteka rozpozna zależności od zera i skopiuje zadeklarowano zależności w katalogu Assets/Plugins/Android Aplikacja Unity.

Wymuś rozwiązanie

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

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.

Ponieważ wtyczka zapośredniczenia do reklam mobilnych Google wersji 7.0.0, AppLovin obsługuje odczytywanie ciągu tekstowego dotyczącego zgody z udostępnionych preferencji i ustawień odpowiedni stan zgody.

Jeśli jesteś nie używają wtyczki zapośredniczenia do reklam mobilnych Google dla Applovin wersji 7.0.0 lub nowszej albo nie korzystasz z platformy CMP, która zapisuje ciąg znaków dotyczący zgody w udostępnianych danych ustawień, możesz użyć AppLovin.SetHasUserConsent() i AppLovin.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.

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

AppLovin.SetHasUserConsent(true);

Ponadto, jeśli wiesz, że użytkownik jest objęty ograniczeniem wiekowym, możesz: ustaw także flagę poniżej na true.

AppLovin.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 wersji 6.3.1 obejmuje AppLovin.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.

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

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

Optymalizacje

Dodaję połączenie do: AppLovin.Initialize() 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 wtyczki AppLovin Unity Mediation

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

  • 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(), która wskazuje, że użytkownik jest objęty 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() służącą do przekazywania flagi zgody użytkownika do pakietu SDK AppLovin.

Wersja 2.0.0

  • Obsługuje pakiet SDK AppLovin na Androida w wersji 7.8.6 na Androida.
  • 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.