Integracja linii z zapośredniczeniem (beta)

Ten przewodnik pokazuje, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Line za pomocą zapośredniczenia AdMob, w tym integracji kaskadowych. Znajdziesz w nim informacje o tym, jak dodać Line do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Line z aplikacją Android .

Etykiety, przyciski i opisy w interfejsie panelu aplikacji Line są w języku japońskim. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku jednak etykiety i przyciski są tłumaczone z użyciem anglojęzycznych odpowiedników tych nazw w nawiasach.

Obsługiwane integracje i formaty reklam

Adapter pośredniczący dla aplikacji Line ma te możliwości:

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

¹ Integracja kaskadowa jest dostępna w otwartej wersji beta.

Wymagania

• Poziom interfejsu API 21 lub nowszy

• Najnowszy pakiet SDK do reklam mobilnych Google

• Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.

Krok 1. Skonfiguruj konfiguracje w interfejsie Line

Zaloguj się na konto Line.

Dodaj nową aplikację

Kliknij 広告枠管理 (Zarządzanie boksami reklamowymi) > ⁑ディア (Media). Następnie kliknij 新規作成 (Utwórz nową).

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 詳細 (Szczegóły).

Kliknij ロット 追加 (Dodaj przedział).

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

Uwaga: skontaktuj się z menedżerem konta sieci reklamowej Line, aby uzyskać dostęp do tworzenia natywnych miejsc docelowych reklam w interfejsie Line.

Zapisz identyfikator slotu.

Krok 2. Skonfiguruj oferty reklamowe AdMob w interfejsie

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać Line do konfiguracji zapośredniczenia jednostki reklamowej.

Najpierw zaloguj się na swoje konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź od razu do sekcji Dodawanie Line jako źródła reklam.

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

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

Nazwij grupę 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ą istniejącą jednostką reklamowąAdMob . Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny się pojawić wybrane przez Ciebie jednostki reklamowe:

Dodaj Line jako źródło reklam

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklamy. Następnie kliknij Line.

Kliknij Line. Następnie wpisz wartość eCPM dlaLine i kliknij Dalej.

Uwaga: optymalizację źródeł reklam musisz skonfigurować tylko raz dla każdej sieci.

Jeśli masz już mapowanie Line, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz dane Application ID and Slot IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.

Ważne: Application ID musi być powiązany z aplikacją docelową, tak jak wLine interfejsie.

Krok 3. Zaimportuj pakiet SDK i adapter Line

Uwaga: brak integracji zgodnych wersji pakietu SDK do reklam mobilnych Google i aplikacji Line może spowodować problemy z kompilacją.

Integracja z Android 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 Line:

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

Integracja ręczna

1. Pobierz najnowszą wersję pliku .aar Line SDK i dodaj ją do projektu.

2. Przejdź do elementów Line adapter w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik .aar adaptera linii i dodaj go do projektu.

Krok 4. Dodaj wymagany kod

Integracja z Line nie wymaga dodatkowego kodu.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

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

Postępuj zgodnie z instrukcjami podanymi w dokumentacji linii, aby włączyć reklamy testowe linii.

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy w AdMob i Line.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z Line, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając z źródeł reklam Line (kaskada).

Kroki opcjonalne:

Parametry związane z siecią

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

enableAdSound

boolean określający domyślny stan rozpoczęcia odtwarzania 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 tymi parametrami:

Java

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

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

Kotlin

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

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

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter linii wypełnia te opis pól zaawansowanych reklam natywnych w przypadku NativeAd.

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

¹ W przypadku reklam natywnych pakiet SDK Line nie udostępnia zasobu ikony aplikacji. Zamiast tego umieszcza on przezroczysty obraz na ikonie aplikacji.

Kody błędów

Jeśli adapter nie otrzyma reklamy z Line, możesz sprawdzić błąd podstawowy w odpowiedzi reklamy, używając ResponseInfo.getAdapterResponses() w ramach tych klas:

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

Oto kody i odpowiednie komunikaty zwracane przez adapter linii, gdy nie udaje się załadować reklamy:

Kod błędu	Domena	Przyczyna
1-10	com.five_corp.ad	Pakiet SDK usługi Line zwrócił błąd specyficzny dla tego pakietu. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją 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 slotu.
103	com.google.ads.mediation.line	Żądany rozmiar reklamy nie odpowiada rozmiarowi banera reklamowego obsługiwanemu przez Line.
104	com.google.ads.mediation.line	Nie udało się załadować reklamy przejściowej ani reklamy z nagrodą z powodu braku kontekstu aktywności.
105	com.google.ads.mediation.line	Pakiet SDK wiersza nie wyświetlił reklamy pełnoekranowej lub reklamy z nagrodą.
106	com.google.ads.mediation.line	Nie udało się wczytać reklamy natywnej z powodu braku komponentów.

Historia zmian adaptera LINE Android Mediation

Następna wersja

• Wdrożenie AdLoader w celu umożliwienia RTB w przypadku reklam banerowych.
• Wdrożony AdLoader, aby umożliwić RTB w przypadku reklam pełnoekranowych.
• Wdrożenie AdLoadera, aby umożliwić RTB w przypadku reklam z nagrodą.
• Implementacja AdLoader, by umożliwić RTB w przypadku reklam natywnych.

Wersja 2.8.20240827.0

• Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.8.20240827.0

Zaprojektowane i przetestowane:

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

Wersja 2.8.20240808.0

• Weryfikowana zgodność z pakietem SDK FiveAd w wersji 2.8.20240808.0

Został opracowany i przetestowany 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 SDK FiveAd w wersji 2.8.20240722.0

Został opracowany i przetestowany z:

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

Wersja 2.7.20240515.0

• Weryfikowana zgodność z pakietem SDK FiveAd w wersji 2.7.20240515.0

Został opracowany i przetestowany z:

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

Wersja 2.7.20240214.1

• Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 23.0.0.
• Weryfikowana zgodność z pakietem SDK FiveAd w wersji 2.7.20240214.0.

Został opracowany i przetestowany z:

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

Wersja 2.7.20240214.0

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

Zaprojektowane i przetestowane:

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

Wersja 2.7.20240126.0

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

Został opracowany i przetestowany z:

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

Wersja 2.7.20240112.0

• Wycofano wycofaną funkcję FiveAdViewEventListener na rzecz funkcji FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener i FiveAdNativeEventListener.
• Weryfikowana zgodność z pakietem SDK FiveAd w wersji 2.7.20240112.
• Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 22.6.0.

Został opracowany i przetestowany z:

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

Wersja 2.6.20230607.1

• Dodaliśmy klasę LineExtras, aby wydawcy mogli definiować domyślne ustawienia dźwięku w przypadku formatów reklam typu baner, reklama pełnoekranowa i reklama z nagrodą.
• Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 22.4.0.

Został opracowany i przetestowany z:

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

Wersja 2.6.20230607.0

• Pierwsza wersja.
• Dodaje obsługę formatów reklam banerowych, pełnoekranowych, z nagrodą i natywną.
• Weryfikowana zgodność z pakietem SDK FiveAd w wersji 2.6.20230607.

Został opracowany i przetestowany z:

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