Aby omawiać nasze usługi i przekazywać opinie na ich temat, dołącz do oficjalnego kanału Discord usługi Ad Manager na serwerze społeczności Google Ads i pomiarów.

Ta strona została przetłumaczona przez Cloud Translation API.

Integracja sieci reklamowej LINE z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z sieci reklamowej LINE przy użyciu zapośredniczenia, a także jak przeprowadzać integrację kaskadową. Wyjaśniamy w nim, jak dodać sieć reklamową LINE do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter sieci reklamowej LINE z aplikacją na Androida.

Interfejs panelu sieci reklamowej LINE używa japońskiego tekstu w etykietach, przyciskach i opisach. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak tłumaczone, a w nawiasach podawane są ich angielskie odpowiedniki.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia dla sieci reklamowej LINE ma te możliwości:

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

¹ Reklamy natywne (na potrzeby określania stawek) są obecnie w fazie zamkniętych testów beta. Aby poprosić o dostęp, skontaktuj się z menedżerem konta.

Wymagania

Android API na poziomie 23 lub wyższym

Najnowszy pakiet SDK do reklam mobilnych Google
Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia.

Krok 1. Skonfiguruj ustawienia w interfejsie sieci reklamowej LINE

Zarejestruj się i zaloguj na konto LINE Ads Network.

Dodawanie nowej aplikacji

Kliknij 広告枠管理 (Ad Slot Management) > メディア (Media). Następnie kliknij 新規作成 (Create New).

Wypełnij formularz i kliknij 登録 (Zarejestruj).

Zanotuj identyfikator aplikacji.

Tworzenie miejsca docelowego reklamy

Kliknij identyfikator aplikacji, do której chcesz dodać miejsce docelowe reklamy. Następnie wybierz 詳細 (Detail).

Kliknij スロット追加 (Add Slot).

Wypełnij formularz, aby podać szczegóły dotyczące miejsca docelowego. W przypadku typu 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 登録 (Register).

Zanotuj identyfikator slota.

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 utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze tego nie zrobiono, utwórz plik app-ads.txt dla usługi Ad Manager.

Aby wdrożyć app-ads.txt w przypadku sieci reklamowej LINE, zapoznaj się z artykułem Informacje o pliku app-ads.txt.

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

Zaloguj się na konto Ad Managera.

Dodawanie sieci reklamowej LINE w sekcji Firmy

Określanie stawek

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

Wodospad

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

Wybierz LINE Ads Network jako Sieć reklamową, wpisz niepowtarzalną Nazwę i włącz Zapośredniczanie. Włącz Automatyczne zbieranie danych i wpisz nazwę logowania oraz hasło 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

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

Wodospad

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

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

Określanie stawek

Kliknij Zasoby reklamowe > Bezpieczne sygnały. W sekcji Bezpieczne sygnały wyszukaj LINE i włącz opcję Włącz integrację aplikacji.

Kliknij Zapisz.

Wodospad

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.

Wodospad

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie ustalania stawek w LINE 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 Sieć reklam LINE.

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

Kliknij Gotowe.

Wodospad

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

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.

Wodospad

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

Przewiń w dół i kliknij Dodaj partnera zysku.

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

Wpisz identyfikator aplikacji i identyfikator miejsca docelowego uzyskane w poprzedniej sekcji oraz wartość domyślnego CPM. Kliknij Zapisz.

Uwaga: automatyczne zbieranie danych potrzebuje kilku dni na zebranie danych, zanim będzie mogło dokładnie obliczać wartość dynamicznego CPM dla sieci zapośredniczenia. Gdy wartość eCPM będzie możliwa do obliczenia, zostanie ona automatycznie zaktualizowana.

Krok 3. Zaimportuj pakiet SDK i adapter sieci reklamowej LINE

Integracja z Androidem Studio (zalecana)

W pliku build.gradle.kts na poziomie aplikacji dodaj te zależności i konfiguracje implementacji: Używaj najnowszych wersji pakietu SDK i adaptera sieci reklamowej LINE:

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

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK sieci reklamowej LINE Ads Network w .aarpliku i dodaj go do projektu.
Otwórz artefakty adaptera sieci reklamowej LINE w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik .aar adaptera sieci reklamowej LINE i dodaj go do projektu.

Krok 4. Dodaj wymagany kod

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

Krok 5. Przetestuj implementację

Włączanie reklam testowych

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

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z sieci reklamowej LINE, włącz w usłudze Ad Inspector testowanie pojedynczego źródła reklam, korzystając ze źródeł reklam LINE Ads Network (kaskada).

Kroki opcjonalne:

Parametry specyficzne dla sieci

Adapter sieci reklamowej LINE 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 dźwięku podczas wyświetlania banerów, reklam pełnoekranowych i reklam z nagrodą.

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

Java

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

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

Kotlin

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

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

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter sieci reklamowej LINE wypełnia te pola NativeAd.

Pole	Komponenty zawsze dołączane przez adapter sieci reklamowej LINE
Nagłówek
Obraz
Treść
Ikona aplikacji	¹
Wezwanie do działania
Ocena w gwiazdkach
Sklep
Cena

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

Kody błędów

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

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

Oto kody i komunikaty, które są zwracane przez adapter sieci reklamowej LINE, gdy nie uda się wczytać reklamy:

Kod błędu	Domena	Przyczyna
1-10	com.five_corp.ad	Pakiet SDK sieci reklamowej LINE zwrócił błąd specyficzny dla pakietu SDK. Więcej informacji znajdziesz w dokumentacji sieci reklamowej LINE.
101	com.google.ads.mediation.line	Brakujący lub nieprawidłowy identyfikator aplikacji.
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 obsługiwanego rozmiaru banera reklamowego w sieci reklamowej LINE.
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 reklamowej LINE 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 brakujących komponentów.