Integracja AppLovin z zapośredniczeniem

Wybierz platformę: Android (beta) Android iOS Unity Flutter

Z tego przewodnika dowiesz się, jak używać GMA Next-Gen SDK do wczytywania i wyświetlania reklam displayowych z AppLovin za pomocą zapośredniczenia AdMob, które obejmuje integracje kaskadowe i z określaniem stawek. Wyjaśnia, jak dodać AppLovin do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter AppLovin z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter do mediacji w przypadku AppLovin ma te możliwości:

¹ Format reklamy wyświetlanej przy otwarciu aplikacji jest dostępny tylko w przypadku integracji kaskadowych.

² Kaskadowe wywołanie obsługuje tylko rozmiary banerów 320x50 i 728x90. Określanie stawek nie obsługuje banerów reklamowych.

Wymagania

• Android w wersji 24 lub nowszej

• [W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w określaniu stawek, użyj adaptera AppLovin w wersji 9.4.2.0 lub nowszej (zalecana jest najnowsza wersja).

• Nowości na kanale GMA Next-Gen SDK

• Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia.

Krok 1. Skonfiguruj ustawienia w interfejsie AppLovin

Zarejestruj się lub zaloguj na konto AppLovin.

Aby skonfigurować jednostkę reklamową AdMob, musisz mieć klucz pakietu SDK i klucz raportu AppLovin. Aby je znaleźć, otwórz interfejs AppLovin > Konto > Klucze. Zobaczysz tam obie wartości.

Jeśli zamierzasz tylko zintegrować ustalanie stawek, możesz przejść do konfigurowania ustawień mediacji.

Wybieranie aplikacji do zapośredniczenia

Utwórz strefę

Aktualizowanie pliku app-ads.txt

Authorized Sellers for Apps (plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli nie zostało to jeszcze zrobione, skonfiguruj plik app-ads.txt pod kątem aplikacji.

Aby zaimplementować app-ads.txt w przypadku AppLovin, dodaj AppLovin do pliku app-ads.txt.

Włączanie trybu testowego

Aby włączyć reklamy testowe AppLovin, postępuj zgodnie z instrukcjami w przewodniku AppLovin MAX Test Mode.

Krok 2. Skonfiguruj popyt AppLovin w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać AppLovin do konfiguracji zapośredniczenia w przypadku jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediacja. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie AppLovin jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.

Wpisz format reklamy i platformę, a potem kliknij Dalej.

Nadaj grupie zapośredniczenia nazwę i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z co najmniej jedną z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny się teraz wyświetlać wybrane przez Ciebie jednostki:

Dodawanie AppLovin jako źródła reklam

Określanie stawek

Na karcie Określanie stawek w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie wybierz AppLovin.

Kliknij Jak podpisać umowę partnerską i skonfiguruj partnerstwo w zakresie określania stawek z firmą AppLovin.



Kliknij Potwierdzam i wyrażam zgodę, a potem Dalej.



Jeśli masz już mapowanie dla AppLovin, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.



Następnie wpisz klucz pakietu SDK uzyskany w poprzedniej sekcji. Następnie kliknij Gotowe.

Wodospad

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklam.

Wybierz AppLovin i włącz przełącznik Optymalizuj. Wpisz klucz raportu uzyskany w poprzedniej sekcji, aby skonfigurować optymalizację źródeł reklam w przypadku AppLovin. Następnie wpisz wartość eCPM dla AppLovin i kliknij Dalej.



Jeśli masz już mapowanie dla sieci AppLovin, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz identyfikator pakietu aplikacji wraz z kluczem pakietu SDK i identyfikatorem strefy uzyskanymi w poprzedniej sekcji. Następnie kliknij Gotowe.

Dodawanie firmy AppLovin Corp. do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi

Aby dodać AppLovin Corp. do listy partnerów reklamowych zachowujących zgodność z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie AdMob, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące amerykańskich przepisów stanowych.

Krok 3. Zaimportuj pakiet SDK i adapter AppLovin

Integracja z Androidem Studio (zalecana)

W pliku Gradle na poziomie aplikacji dodaj te zależności implementacji i konfiguracje:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:applovin:13.5.1.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:applovin:13.5.1.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integracja ręczna

• Pobierz pakiet SDK AppLovin na Androida, wyodrębnij applovin-sdk-x.y.z.jar i dodaj go do projektu.

• Otwórz artefakty adaptera AppLovin w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik .aar adaptera AppLovin i dodaj go do projektu.

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

Zgoda użytkowników z UE i RODO

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz przekazywać użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii określone informacje oraz uzyskiwać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane przez prawo, a także na zbieranie, udostępnianie i wykorzystywanie danych osobowych na potrzeby personalizacji reklam. 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). Odpowiadasz za sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu mediacji. Google nie może automatycznie przekazywać do takich sieci wyboru użytkownika dotyczącego zgody.

Od wersji 12.0.0 pakiet SDK AppLovin obsługuje odczytywanie ciągu tekstowego zgody z ustawień udostępnionych i odpowiednie ustawianie stanu zgody.

Jeśli nie używasz pakietu AppLovin SDK w wersji 12.0.0 lub nowszej ani platformy CMP, która zapisuje ciąg tekstowy zgody w setHasUserConsent, możesz użyć metody setHasUserConsent. W poniższym przykładzie informacje o zgodzie są przekazywane do pakietu SDK AppLovin. Musisz ustawić te opcje przed zainicjowaniemGMA Next-Gen SDK, aby mieć pewność, że zostaną one prawidłowo przekazane do pakietu SDK AppLovin.

AppLovinPrivacySettings.setHasUserConsent(true);
AppLovinMediationSnippets.java

AppLovinPrivacySettings.setHasUserConsent(true)
AppLovinMediationSnippets.kt

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

Deklarowanie użytkowników niepełnoletnich

Od wersji 13.0.0 pakietu SDK AppLovin nie obsługuje już flag użytkowników z ograniczeniami wiekowymi. Nie możesz też inicjować ani używać pakietu SDK AppLovin w przypadku „dziecka” w rozumieniu obowiązujących przepisów. Więcej informacji znajdziesz w dokumentacji AppLovin na temat zakazu gromadzenia danych dzieci oraz korzystania z usług w przypadku dzieci lub aplikacji przeznaczonych wyłącznie dla dzieci.

Adapter AppLovin w wersji 13.0.0.1 lub nowszej automatycznie wyłącza zapośredniczanie AppLovin w przypadku aplikacji, które deklarują jedno z tych ustawień za pomocą symbolu GMA Next-Gen SDK:

• Ustawienie skierowane do dzieci

• Użytkownicy, którzy nie osiągnęli wieku świadomego wyrażenia zgody

amerykańskie przepisy stanowe o ochronie prywatności,

Przepisy dotyczące prywatności w stanach USA wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie). Wycofanie zgody musi być możliwe za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej podmiotu „sprzedającego”. Przewodnik po zgodności z przepisami stanów USA dotyczącymi ochrony 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 Twoim łańcuchu mediacji. Dlatego musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie z wytycznymi każdej z tych sieci, aby zapewnić zgodność z przepisami.

Pakiet SDK AppLovin zawiera metodę setDoNotSell, która umożliwia wydawcom rezygnację ze sprzedaży danych osobowych.

W tym przykładzie informacje o uzyskanej zgodzie są przekazywane do pakietu AppLovin SDK. Musisz ustawić te opcje przed zainicjowaniem GMA Next-Gen SDK, aby mieć pewność, że zostaną one prawidłowo przekazane do pakietu AppLovin SDK.

AppLovinPrivacySettings.setDoNotSell(true);
AppLovinMediationSnippets.java

AppLovinPrivacySettings.setDoNotSell(true)
AppLovinMediationSnippets.kt

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

Krok 5. Dodaj wymagany kod

Integracja z AppLovin nie wymaga dodatkowego kodu.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe w AdMob i włączono 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 (określanie stawek) i AppLovin (kaskadowe).

Kroki opcjonalne:

Parametry dotyczące sieci

Adapter AppLovin obsługuje parametr setMuteAudio(), który może wyłączyć dźwięk w reklamach wideo. Tę metodę można wywołać z obiektu AppLovinExtras.Builder():

Bundle extras = new AppLovinExtras.Builder()
  .setMuteAudio(true)
  .build();
AdRequest request = new AdRequest.Builder(AD_UNIT_ID)
  .putAdSourceExtrasBundle(ApplovinAdapter.class, extras)
  .build();

val extras = AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build()
val request = AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(ApplovinAdapter::class.java, extras)
   .build()

Optymalizacje

Kody błędów

Jeśli adapter nie otrzyma reklamy z AppLovin, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z ResponseInfo.getAdSourceResponses() w tych klasach:

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

Oto kody i komunikaty wyświetlane przez adapter AppLovin, gdy nie uda się wczytać reklamy: