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 SDK Google Mobile Ads SDK (Legacy) do wczytywania i wyświetlania reklam z sieci reklamowej LY Ads Network za pomocą zapośredniczenia AdMob, które obejmuje integracje kaskadowe. Dowiesz się z niego, jak dodać LY Ads Network do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter 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ź te kwestie:

  • 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ę App (Aplikacja) i kliknij przycisk New registration (Nowa rejestracja).

Nowa rejestracja

Wypełnij formularz i kliknij Rejestracja.

Nowy formularz rejestracyjny

Zanotuj 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.

Formularz dodawania 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.

Poproś o sprawdzenie

Tworzenie klucza interfejsu API raportowania

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

Zaktualizuj plik 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 nie masz pliku app-ads.txt, skonfiguruj go pod kątem swojej 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 w interfejsie AdMob źródła ofert reklamowych z sieci reklamowej LY Ads Network

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać LY Ads Network do konfiguracji zapośredniczenia dla jednostki reklamowej.

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

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

Wpisz format reklamy i platformę, a następnie kliknij Dalej.

Nadaj nazwę grupie zapośredniczenia 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 istniejących jednostek reklamowych AdMob. Następnie kliknij Gotowe.

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

Dodawanie sieci reklamowej LY Ads Network jako źródła reklam

Określanie stawek


W sekcji Źródła reklam odszukaj kartę Ustalanie stawek i kliknij Dodaj źródło reklam. Następnie wybierz LY Ads Network.

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



Kliknij Potwierdź i zaakceptuj, a następnie Dalej.



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



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



Kaskada


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

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




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



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


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. Otwórz artefakty 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 Ads Network nie wymaga dodatkowego kodu.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob.

Adapter sieci reklamowej LY Ads Network zawiera metodę pomocniczą, która umożliwia włączenie trybu testowego w sieci reklamowej LY Ads Network. Tę opcję musisz ustawić przed zainicjowaniem Google Mobile Ads SDK (Legacy), aby mieć pewność, że dane będą prawidłowo przekazywane do pakietu SDK sieci reklamowej LY.

Java 

LineMediationAdapter.Companion.setTestMode(true);

Kotlin 

LineMediationAdapter.setTestMode(true)

Sprawdzanie 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 Network wypełnia te pola: Opisy pól zaawansowanych reklam natywnych 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 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 lub reklamy z nagrodą z powodu braku kontekstu aktywności.
105 com.google.ads.mediation.line Pakiet SDK sieci reklamowej LY Ads nie 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.
  • Pakiet SDK FiveAd w wersji 3.1.1.1.

Wersja 3.1.1.1

  • Mapuje AgeRestrictedTreatment na interfejs API ChildDirectedTreatment platformy Line.

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.2.1.
  • Pakiet SDK FiveAd 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.
  • Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 3.1.0.0.

Zbudowano i przetestowano z:

  • 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.
  • Pakiet SDK FiveAd 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.
  • Pakiet SDK FiveAd w wersji 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.

Zbudowano i przetestowano z:

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

Wersja 3.0.1.0

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

Zbudowano i przetestowano z:

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

Wersja 3.0.0.0

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

Zbudowano i przetestowano z:

  • 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.
  • Pakiet SDK FiveAd 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.
  • Pakiet SDK FiveAd w wersji 2.9.20250924.1.

Wersja 2.9.20250924.0

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

Zbudowano i przetestowano z:

  • 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.
  • Pakiet SDK FiveAd 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.

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.20250110.1

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

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.0.0.
  • Pakiet SDK FiveAd 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.
  • Naprawiliśmy proces inicjowania kaskadowych formatów reklam pełnoekranowych i reklam z nagrodą.
  • Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.9.20250110.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 23.6.0.
  • Pakiet SDK FiveAd 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.
  • Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.9.20241129.

Zbudowano i przetestowano z:

  • 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.
  • Pakiet SDK FiveAd w wersji 2.7.20240214.0.

Wersja 2.7.20240214.0

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

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.6.0.
  • Pakiet SDK FiveAd w wersji 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 wersji 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 wersji 22.4.0.

Zbudowano i przetestowano z:

  • 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.
  • Zweryfikowano 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.