Integracja Line 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, 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 wiersza są zapisane w języku japońskim. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak przetłumaczone z odpowiednimi angielskimi odpowiednikami 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

1 Integracja kaskadowa jest obecnie w fazie zamkniętych testów beta. Aby uzyskać dostęp, skontaktuj się z menedżerem konta.

Wymagania

  • Poziom interfejsu API 21 lub nowszy

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 slot).

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

Zapisz identyfikator slotu.

Krok 2. Skonfiguruj zapotrzebowanie na usługi w Ad Manager UI

Krok 3. Zaimportuj pakiet SDK i adapter Line

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

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 pakietu Line SDK i dodaj go 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.

Aby włączyć reklamy testowe w aplikacji Line, postępuj zgodnie z instrukcjami podanymi w dokumentacji Line.

Zweryfikuj reklamy testowe

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 charakterystyczne dla sieci

Adapter Line obsługuje dodatkowy parametr żądania, który można przekazać do adaptera za pomocą klasy LineExtras. Ten konstruktor klas zawiera następujące parametry:

enableAdSound
A boolean, aby określić domyślny stan początkowy dźwięku w reklamach banerowych, pełnoekranowych i 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 liniowy wypełnia te pola dla 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

1 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 wiersza, możesz sprawdzić podstawowy błąd w odpowiedzi za pomocą polecenia ResponseInfo.getAdapterResponses() w ramach tych klas:

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

Oto kody i powiązane z nimi komunikaty wysyłane przez adapter Line, gdy nie uda się wczytać 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. Więcej informacji znajdziesz w dokumentacji wiersza.
101 com.google.ads.mediation.line Brakujący lub nieprawidłowy identyfikator aplikacji.
102 com.google.ads.mediation.line Brak identyfikatora gniazda lub jest on nieprawidłowy.
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 narzędzia AdLoader, by umożliwić określanie stawek w czasie rzeczywistym w przypadku banerów reklamowych.
  • Implementacja AdLoader, by umożliwić RTB w przypadku reklam pełnoekranowych.
  • Wdrożenie AdLoadera, aby umożliwić RTB w przypadku reklam z nagrodą.
  • Wdrożenie AdLoader w celu umożliwienia RTB w przypadku reklam natywnych.

Wersja 2.8.20240827.0

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

Został opracowany i przetestowany 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

  • 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

  • Weryfikowana 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

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

Wersja 2.7.20240126.0

  • Weryfikowana 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ą.
  • Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 22.4.0.

Zaprojektowane i przetestowane:

  • 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 banerów, reklam pełnoekranowych, reklam z nagrodą i reklam natywnych.
  • 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.
  • Pakiet SDK FiveAd w wersji 2.6.20230607.