Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Integrowanie LY Ads Network z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

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

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia dla LY Ads Network ma te możliwości:

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

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te informacje:

Android w wersji API 24 lub nowszej.
[W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w określaniu stawek, użyj adaptera sieci reklamowej LY w wersji 2.9.20241129.0 lub nowszej (zalecana jest najnowsza wersja).

Najnowsza wersja GMA Next-Gen SDK.
Skonfiguruj mediację.

Krok 1. Skonfiguruj ustawienia w interfejsie sieci reklamowej LY

Zarejestruj się i zaloguj na konto LY Ads Network.

Dodawanie nowej aplikacji

Otwórz 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 docelowego. W sekcji Typ 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.

Dodawanie formularza boksu

Zanotuj identyfikator slota.

Szczegóły boksu

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 Reporting API

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

Karta klucza interfejsu API do 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 jeszcze tego nie zrobiono, utwórz plik app-ads.txt na potrzeby Ad Managera.

Aby zaimplementować app-ads.txt w przypadku LY Ads Network, zapoznaj się z artykułem Informacje o pliku app-ads.txt.

Krok 2. Skonfiguruj popyt sieci reklamowej LY w interfejsie Ad Managera

Zaloguj się na konto Ad Managera.

Dodawanie LY Ads Network w sekcji Firmy

Określanie stawek

Ten krok nie jest wymagany w przypadku integracji z określaniem stawek.

Kaskada

Kliknij kolejno Administracja > Firmy, a potem na karcie Wszystkie firmy kliknij przycisk Nowa firma. Kliknij Sieć reklamowa.

Wybierz LY Ads Network jako sieć reklamową, wpisz unikalną nazwę i włącz zapośredniczanie. Włącz Automatyczne zbieranie danych i wpisz identyfikator klucza interfejsu API oraz tajny klucz interfejsu API uzyskane w poprzedniej sekcji.

Nie musisz wpisywać nazwy użytkownika ani hasła. Gdy skończysz, kliknij Zapisz.

Włączanie udostępniania bezpiecznych sygnałów

Określanie stawek

Kliknij kolejno Administracja i Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange, przejrzyj i włącz Udostępnianie bezpiecznych sygnałów. Kliknij Zapisz.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Udostępnianie bezpiecznych sygnałów w pytaniach o stawkę

Określanie stawek

Kliknij kolejno Zasoby reklamowe i Bezpieczne sygnały. W sekcji Bezpieczne sygnały wyszukaj sieć reklamową LY Ads Network i włącz opcję Włącz integrację aplikacji.

Kliknij Zapisz.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Zezwalanie na udostępnianie bezpiecznych sygnałów na potrzeby określania stawek przez pakiet SDK

Określanie stawek

Kliknij kolejno Wyświetlanie i Ustawienia na potrzeby kanałów popytu. Na karcie Ustawienia domyślne włącz opcję Zezwalaj na udostępnianie bezpiecznych sygnałów w przypadku licytowania w SDK.

Kliknij Zapisz.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie określania stawek w LY Ads Network

Określanie stawek

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Kliknij Nowy licytujący.

Jako dostawcę wybierz LY Ads Network.

Kliknij Dalej, aby włączyć określanie stawek przez pakiet SDK w przypadku tego licytującego.

Kliknij Gotowe.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie mapowania jednostki reklamowej

Określanie stawek

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Wybierz firmę LY Ads Network.

Otwórz kartę Mapowanie jednostek reklamowych i kliknij Nowe mapowanie jednostek reklamowych.

Wybierz Konkretna jednostka reklamowa. Wybierz jednostkę reklamową i format, Aplikacja mobilna jako Typ zasobów reklamowych oraz Aplikacja mobilna. Następnie wpisz Identyfikator aplikacji i Identyfikator miejsca uzyskane w poprzedniej sekcji.

Na koniec kliknij Zapisz.

Kaskada

Kliknij kolejno Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku. Wybierz zasoby reklamowe i aplikację.

Przewiń do sekcji Partnerzy zysku i kliknij Dodaj partnera zapośredniczenia.

Wybierz firmę utworzoną w poprzedniej sekcji na potrzeby sieci reklamowej LY Ads Network. Wybierz Zapośredniczenie mobilne SDK jako Typ integracji, Android jako Platformę i Aktywny jako Stan.

Wpisz Identyfikator aplikacji i Identyfikator miejsca reklamowego uzyskane w poprzedniej sekcji oraz wartość Domyślny CPM. Kliknij Zapisz.

Krok 3. Zaimportuj pakiet SDK i adapter LY Ads Network

Integracja z Androidem Studio (zalecana)

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

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:line:3.1.1.2")
}

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

Zakręcony

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:line:3.1.1.2'
}

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 najnowszą wersję pliku .aar pakietu SDK sieci reklamowej LY Ads Network 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 Ad Managerze.

Adapter LY Ads Network zawiera metodę pomocniczą, która umożliwia włączenie trybu testowego w przypadku LY Ads Network. Musisz ustawić tę opcję przed zainicjowaniemGMA Next-Gen 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, korzystając ze ź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 boolean, aby określić domyślny stan początkowy dźwięku w przypadku banerów, reklam pełnoekranowych i reklam z nagrodą.

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 pola 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 ikony aplikacji. Zamiast tego adapter sieci reklamowej LY Ads wypełnia ikonę aplikacji przezroczystym obrazem.

Kody błędów

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

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

Oto kody i komunikaty wyświetlane przez adapter LY Ads Network w przypadku niepowodzenia wczytania reklamy:

Kod błędu	Domena	Przyczyna
1-10	com.five_corp.ad	Pakiet SDK sieci reklamowej LY 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 aktywności.
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.
107	com.google.ads.mediation.line	Pakiet SDK FiveAd zwrócił wartość null dla narzędzia do wczytywania reklam.