Integrowanie LY Ads Network z zapośredniczeniem

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

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads SDK (Legacy) do wczytywania i wyświetlania reklam z sieci reklamowej LY Ads Network za pomocą 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 sieci reklamowej 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ź, czy:

  • Android API na poziomie 24 lub wyższym.

Krok 1. Skonfiguruj ustawienia w interfejsie sieci reklamowej LY

Zarejestruj się i zaloguj na konto LY Sieć reklamowa.

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 Slot kliknij Dodaj.

Dodaj boks

Wypełnij formularz, aby uzyskać szczegółowe informacje o miejscu. W sekcji Typ określania stawek wybierz Standardowe, aby skonfigurować ten boks na potrzeby zapośredniczenia kaskadowego, lub Określanie stawek przez pakiet SDK Google, aby skonfigurować ten boks na potrzeby określania stawek. Po wypełnieniu formularza kliknij Utwórz.

Dodawanie formularza boksu

Zanotuj identyfikator boksu.

Szczegóły boksu

Po utworzeniu pierwszego boksu kliknij Sprawdź na stronie z informacjami o aplikacji, aby uzyskać zatwierdzenie od sieci reklamowej LY Ads Network. Może to chwilę potrwać. Jeśli masz pytania, skontaktuj się z przedstawicielem sieci reklamowej LY Ads.

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

Zapisz identyfikator klucza interfejsu API i klucz tajny interfejsu API.

Formularz klucza interfejsu API do raportowania

Aktualizowanie pliku app-ads.txt

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

Krok 2. Skonfiguruj żądania sieci reklamowej LY Ads w interfejsie Ad Managera

Zaloguj się na konto Ad Managera.

Dodawanie sieci reklamowej 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 następnie na karcie Wszystkie firmy kliknij przycisk Nowa firma. Kliknij Sieć reklamowa.

Wybierz LY Ads Network jako Sieć reklamową, wpisz unikalną Nazwę i włącz Mediację. 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łącz udostępnianie bezpiecznych sygnałów

Określanie stawek

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

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Udostępnianie bezpiecznego sygnału 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 Wyświetlanie > Ustawienia na potrzeby kanałów popytu. Na karcie Ustawienia domyślne włącz opcję Zezwalaj na udostępnianie bezpiecznych sygnałów w przypadku określania stawek przez pakiet SDK.

Kliknij Zapisz.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie określania stawek w sieci reklamowej LY Ads

Określanie stawek

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

Kliknij Nowy licytujący.

Jako licytującego 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ę dla sieci reklamowej 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 boksu 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 Aplikacja.

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 boksu uzyskane w poprzedniej sekcji oraz wartość Domyślny CPM. Kliknij Zapisz.

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

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

Kotlin

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

Zakręcony

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

Integracja ręczna

  1. Pobierz najnowszą wersję pliku .aar pakietu SDK sieci reklamowej LY i dodaj go do projektu.

  2. Przejdź do artefaktów adaptera sieci reklamowej LY Ads w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik .aar adaptera sieci LY Ads Network 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 urządzenie testowe jest zarejestrowane w usłudze Ad Manager.

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

Java 

LineMediationAdapter.Companion.setTestMode(true);

Kotlin 

LineMediationAdapter.setTestMode(true)

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z sieci reklamowej 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
boolean, aby określić domyślny stan początkowy dźwięku w banerach, reklamach pełnoekranowych i reklamach z nagrodą.

Oto przykładowy kod, który pokazuje, jak utworzyć żądanie reklamy z tymi parametrami:

Java 

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

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

Kotlin 

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

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

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter sieci reklamowej LY Ads wypełnia te pola w przypadku NativeAd.

Pole Zasoby zawsze uwzględniane przez adapter sieci reklamowej LY Ads
Nagłówek
Obraz
Treść
Ikona aplikacji 1.
Wezwanie do działania
Ocena w gwiazdkach
Sklep
Cena

1 W przypadku reklam natywnych pakiet SDK sieci reklamowej LY nie udostępnia zasobu 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 LY Ads Network, możesz sprawdzić błąd w odpowiedzi na żądanie reklamy, korzystając z klasy ResponseInfo.getAdapterResponses() w tych klasach:

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

Oto kody i powiązane z nimi komunikaty, które adapter sieci reklamowej LY Ads Network wyświetla, 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 związany z pakietem SDK. Więcej informacji znajdziesz w dokumentacji sieci reklamowej LY Ads Network.
101 com.google.ads.mediation.line Brakujący lub nieprawidłowy identyfikator aplikacji.
102 com.google.ads.mediation.line Brak identyfikatora boksu lub jest on nieprawidłowy.
103 com.google.ads.mediation.line Żądany rozmiar reklamy nie pasuje do rozmiaru banera reklamowego obsługiwanego przez sieć reklamową LY Ads Network.
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 reklamowej 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 braku komponentów.
107 com.google.ads.mediation.line Pakiet SDK FiveAd zwrócił pusty obiekt do wczytywania reklam.

Historia zmian adaptera zapośredniczenia LINE na Androida

Wersja 3.1.1.2

  • Przypnij zależność adaptera od Kotlina do wersji 1.9.0 (minimalnej wersji Kotlina obsługiwanej przez pakiet GMA NextGen SDK).

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 25.4.0.
  • Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.4.0.
  • FiveAd SDK w wersji 3.1.1.1.

Wersja 3.1.1.1

  • Mapuje AgeRestrictedTreatment na interfejs API ChildDirectedTreatment platformy Line.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 25.4.0.
  • Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.2.1.
  • FiveAd SDK w wersji 3.1.1.1.

Wersja 3.1.1.0

  • Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 3.1.1.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 25.2.0.
  • Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.2.1.
  • Pakiet SDK FiveAd w wersji 3.1.1.0.

Wersja 3.1.0.0

  • Dodano właściwość umożliwiającą utworzenie adaptera z zależnością od pakietu SDK nowej generacji do reklam mobilnych Google.
  • Sprawdzona zgodność z pakietem FiveAd SDK w wersji 3.1.0.0.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 25.1.0.
  • Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 0.25.0-beta01.
  • FiveAd SDK w wersji 3.1.0.0.

Wersja 3.0.1.2

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 25.1.0.
  • Wersja pakietu SDK FiveAd 3.0.1.2.

Wersja 3.0.1.1

  • Wyświetlenia reklam natywnych są teraz zastępowane przez pakiet SDK FiveAd, gdy używasz pakietu SDK do reklam mobilnych Google w wersji 24.4.0 lub nowszej.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.9.0.
  • FiveAd SDK w wersji 3.0.1.1.

Wersja 3.0.1.0

  • Dodaliśmy obsługę przekazywania parametru tagForUnderAgeOfConsent z pakietu SDK do reklam mobilnych Google do pakietu SDK FiveAd.
  • Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 3.0.1.0.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.9.0.
  • FiveAd SDK w wersji 3.0.1.0.

Wersja 3.0.0.0

  • Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 3.0.0.0.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.9.0.
  • Pakiet SDK FiveAd w wersji 3.0.0.0.

Wersja 2.9.20251028.0

  • Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.9.20251028.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.7.0.
  • FiveAd SDK w wersji 2.9.20251028.0

Wersja 2.9.20250924.1

  • Usunięto odwołania do kontekstu na poziomie klasy. Może pomóc zmniejszyć problemy z wyciekiem pamięci.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.7.0.
  • Wersja pakietu FiveAd SDK 2.9.20250924.1.

Wersja 2.9.20250924.0

  • Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.9.20250924.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.6.0.
  • Pakiet SDK FiveAd w wersji 2.9.20250924.0

Wersja 2.9.20250718.0

  • Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.9.20250718.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.3.0.
  • FiveAd SDK w wersji 2.9.20250718.0.

Wersja 2.9.20250519.0

  • Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.9.20250519.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.3.0.
  • Pakiet SDK FiveAd w wersji 2.9.20250519.0.

Wersja 2.9.20250317.1

  • Naprawiono wymiary wczytywania banerów w przypadku reklam z określaniem stawek za pomocą nowego interfejsu FiveAd API.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.1.0.
  • Pakiet SDK FiveAd w wersji 2.9.20250317.0

Wersja 2.9.20250317.0

  • Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.9.20250317.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.1.0.
  • FiveAd SDK w wersji 2.9.20250317.0

Wersja 2.9.20250110.1

  • Zaktualizowano minimalny wymagany poziom interfejsu Android API do 23.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 24.0.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.0.0.
  • FiveAd SDK w wersji 2.9.20250110.0

Wersja 2.9.20250110.0

  • Usunięto wycofaną klasę UnifiedNativeAdMapper na rzecz klasy NativeAdMapper
  • Naprawiliśmy proces zbierania sygnałów.
  • Poprawiono proces inicjowania w przypadku kaskadowych formatów reklam pełnoekranowych i reklam z nagrodą.
  • Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.9.20250110.

Zaprojektowano i przetestowano z użyciem:

  • SDK do reklam mobilnych Google w wersji 23.6.0.
  • FiveAd SDK w wersji 2.9.20250110.0

Wersja 2.9.20241129.0

  • Dodano obsługę określania stawek w przypadku banerów, reklam pełnoekranowych, reklam z nagrodą i reklam natywnych.
  • Sprawdziliśmy zgodność z pakietem FiveAd SDK w wersji 2.9.20241129.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 23.5.0.
  • Pakiet SDK FiveAd w wersji 2.9.20241129.0

Wersja 2.8.20240827.0

  • Zweryfikowano zgodność z pakietem FiveAd SDK w wersji 2.8.20240827.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 23.3.0.
  • Pakiet SDK FiveAd w wersji 2.8.20240827.0

Wersja 2.8.20240808.0

  • Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.8.20240808.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 23.2.0.
  • Pakiet SDK FiveAd w wersji 2.8.20240808.0

Wersja 2.8.20240722.0

  • Zweryfikowano zgodność z pakietem FiveAd SDK w wersji 2.8.20240722.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 23.2.0.
  • Pakiet SDK FiveAd w wersji 2.8.20240722.0

Wersja 2.7.20240515.0

  • Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.7.20240515.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 23.1.0.
  • Pakiet SDK FiveAd w wersji 2.7.20240515.0

Wersja 2.7.20240214.1

  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 23.0.0.
  • Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.7.20240214.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 23.0.0.
  • Wersja pakietu FiveAd SDK 2.7.20240214.0.

Wersja 2.7.20240214.0

  • Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.7.20240214.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.6.0.
  • Wersja pakietu FiveAd SDK 2.7.20240214.0.

Wersja 2.7.20240126.0

  • Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.7.20240126.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.6.0.
  • Pakiet SDK FiveAd w wersji 2.7.20240126.0.

Wersja 2.7.20240112.0

  • Usunięto wycofane pole FiveAdViewEventListener na rzecz pól FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener i FiveAdNativeEventListener.
  • Zweryfikowano zgodność z pakietem FiveAd SDK w wersji 2.7.20240112.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 22.6.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.6.0.
  • Pakiet SDK FiveAd w wersji 2.7.20240112.

Wersja 2.6.20230607.1

  • Dodaliśmy klasę LineExtras, aby wydawcy mogli określać domyślne ustawienia dźwięku w przypadku formatów reklam banerowych, pełnoekranowych i z nagrodą.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 22.4.0.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.4.0.
  • Pakiet SDK FiveAd w wersji 2.6.20230607.

Wersja 2.6.20230607.0

  • Pierwsza wersja.
  • Dodaje obsługę banerów, reklam pełnoekranowych, reklam z nagrodą i reklam natywnych.
  • Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.6.20230607.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.1.0.
  • Pakiet SDK FiveAd w wersji 2.6.20230607.