Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Integrowanie LY Ads Network z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads SDK wczytywać i wyświetlać reklamy z sieci LY Ads Network przy użyciu zapośredniczenia AdMob, w tym integracji kaskadowych. Wyjaśniamy w nim, jak dodać sieć LY Ads Network do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter sieci LY Ads Network z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia dla LY Ads Network ma te funkcje:

Integracja
Określanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Z nagrodą
Natywna

Wymagania

Android w wersji 23 lub nowszej

Nowości na kanale Google Mobile Ads SDK
Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia.

Krok 1. Skonfiguruj ustawienia w interfejsie sieci reklamowej LY

Zarejestruj się i zaloguj na konto LY Ads Network.

Dodawanie nowej aplikacji

Przejdź na kartę Aplikacja i kliknij przycisk Nowa rejestracja.

Nowa rejestracja

Wypełnij formularz i kliknij rejestracja.

Nowy formularz rejestracyjny

Zapisz identyfikator aplikacji.

Szczegółowe informacje na temat rejestracji

Tworzenie boksu reklamowego

Na karcie Aplikacja wybierz aplikację, aby wyświetlić jej szczegóły. W sekcji Miejsce reklamowe kliknij Dodaj.

Dodaj boks

Wypełnij formularz, aby podać szczegóły dotyczące miejsca. W sekcji Rodzaj określania stawek wybierz Standardowe, aby skonfigurować ten slot pod kątem zapośredniczenia kaskadowego, lub Określanie stawek przez pakiet SDK Google, aby skonfigurować ten slot pod kątem określania stawek. Po wypełnieniu formularza kliknij Utwórz.

Formularz dodawania boksu

Zanotuj identyfikator miejsca docelowego.

Szczegóły przedziału

Po utworzeniu pierwszego miejsca reklamowego kliknij Sprawdź na stronie szczegółów aplikacji, aby uzyskać zgodę sieci reklamowej LY. Może to chwilę potrwać. Jeśli masz pytania, skontaktuj się z przedstawicielem LY Ads Network.

Poproś o sprawdzenie

Tworzenie klucza interfejsu API raportowania

Otwórz kartę Zarządzanie kluczami interfejsu API raportowania i kliknij przycisk Utwórz klucz interfejsu API.

Karta Klucz API raportowania

Wypełnij formularz i kliknij Zapisz.

Formularz klucza interfejsu API do raportowania

Zanotuj identyfikator klucza interfejsu API i klucz tajny interfejsu API.

Formularz klucza interfejsu API do raportowania

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 wdrożyć app-ads.txt w przypadku LY Ads Network, zapoznaj się z artykułem Informacje o pliku app-ads.txt.

Krok 2. Skonfiguruj popyt sieci LY Ads w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać LY Ads Network do konfiguracji mediacji dla 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 sieci LY Ads 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.

Powinna się teraz wyświetlić karta jednostek reklamowych z wybranymi przez Ciebie jednostkami:

Dodawanie LY Ads Network 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 LY Ads Network.

Kliknij Jak podpisać umowę partnerską i skonfiguruj partnerstwo w zakresie określania stawek z siecią reklamową LY Ads Network.

Kliknij Potwierdzam i akceptuję, a potem Dalej.

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

Następnie wpisz identyfikator aplikacji i identyfikator miejsca na reklamę uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Wodospad

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

Wybierz LY Ads Network i włącz przełącznik Optymalizuj. Aby skonfigurować optymalizację źródeł reklam w LY Ads Network, wpisz identyfikator klucza interfejsu API i klucz tajny interfejsu API uzyskane w poprzedniej sekcji. Następnie wpisz wartość eCPM dla sieci LY Ads Network i kliknij Dalej.

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

Następnie wpisz identyfikator aplikacji i identyfikator miejsca uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Uwaga: optymalizacja źródeł reklam potrzebuje kilku dni na zebranie wystarczającej ilości danych, aby dokładnie obliczać eCPM dla sieci zapośredniczenia. W tym czasie stan optymalizacji źródła reklam to PENDING, więc musisz ręcznie ustawić wartość eCPM dla sieci. Gdy tylko będzie można obliczyć eCPM, źródło reklam automatycznie zacznie aktualizować eCPM w Twoim imieniu.

Krok 3. Zaimportuj pakiet SDK i adapter sieci reklamowej LY Ads

Integracja z Androidem Studio (zalecana)

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

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.4.0")
    implementation("com.google.ads.mediation:line:3.1.0.0")
}

Zakręcony

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.4.0'
    implementation 'com.google.ads.mediation:line:3.1.0.0'
}

Integracja ręczna

Pobierz najnowszą wersję pliku pakietu SDK sieci reklamowej LY Ads Network.aar i dodaj go do swojego projektu.
Przejdź do artefaktów adaptera LY Ads Network w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik .aar adaptera sieci reklamowej LY Ads i dodaj go do projektu.

Krok 4. Dodaj wymagany kod

Integracja z siecią reklamową LY nie wymaga dodatkowego kodu.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe w AdMob.

Adapter LY Ads Network zawiera metodę pomocniczą, która umożliwia włączenie trybu testowego w przypadku tej sieci. Musisz ustawić tę opcję przed zainicjowaniemGoogle Mobile Ads SDK, aby mieć pewność, że zostaną one prawidłowo przekazane do pakietu SDK sieci reklamowej LY.

Java

LineMediationAdapter.Companion.setTestMode(true);LineMediationSnippets.java

Kotlin

LineMediationAdapter.setTestMode(true)LineMediationSnippets.kt

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z sieci LY Ads Network, włącz w inspektorze reklam testowanie pojedynczego źródła reklam za pomocą źródła lub źródeł reklam LY Ads Network.

Kroki opcjonalne:

Parametry dotyczące sieci

Adapter sieci reklamowej LY Ads obsługuje dodatkowy parametr żądania, który można przekazać do adaptera za pomocą klasy LineExtras. Konstruktor tej klasy zawiera te parametry:

enableAdSound: A – określa domyślny stan dźwięku banerów, reklam pełnoekranowych i reklam z nagrodą.boolean

Oto przykład kodu, który pokazuje, jak utworzyć żądanie reklamy z ustawionymi parametrami:

Java

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();LineMediationSnippets.java

Kotlin

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()LineMediationSnippets.kt

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter LY Ads Network wypełnia te opisy pól zaawansowanych reklam natywnych w przypadku NativeAd.

Pole	Komponenty zawsze dołączane przez adapter LY Ads Network
Nagłówek
Obraz
Treść
Ikona aplikacji	¹.
Wezwanie do działania
Ocena w gwiazdkach
Sklep
Cena

¹ W przypadku reklam natywnych pakiet SDK sieci LY Ads nie udostępnia komponentu ikony aplikacji. Zamiast tego adapter LY Ads Network wypełnia ikonę aplikacji przezroczystym obrazem.

Kody błędów

Jeśli adapter nie otrzyma reklamy z sieci LY Ads Network, możesz sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z tych klas:ResponseInfo.getAdapterResponses()

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

Oto kody i komunikaty, które są zwracane przez adapter LY Ads Network, gdy nie uda się wczytać reklamy:

Kod błędu	Domena	Przyczyna
1-10	com.five_corp.ad	Pakiet SDK sieci reklamowej LY Ads Network zwrócił błąd specyficzny dla pakietu SDK. Więcej informacji znajdziesz w dokumentacji sieci reklamowej LY Ads Network.
101	com.google.ads.mediation.line	Brak identyfikatora aplikacji lub jest on nieprawidłowy.
102	com.google.ads.mediation.line	Brakujący lub nieprawidłowy identyfikator miejsca docelowego.
103	com.google.ads.mediation.line	Żądany rozmiar reklamy nie pasuje do rozmiaru banera reklamowego obsługiwanego przez sieć LY Ads.
104	com.google.ads.mediation.line	Nie udało się wczytać reklamy pełnoekranowej ani reklamy z nagrodą z powodu braku kontekstu działania.
105	com.google.ads.mediation.line	Pakiet SDK sieci LY Ads nie zdołał wyświetlić reklamy pełnoekranowej ani reklamy z nagrodą.
106	com.google.ads.mediation.line	Nie udało się wczytać reklamy natywnej z powodu brakujących komponentów.

Historia zmian adaptera mediacji LINE na Androida

Następna wersja

Mapuje AgeRestrictedTreatment na interfejs ChildDirectedTreatment API usługi Line.