Integracja linii z zapośredniczeniem (beta)

Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z linii wykorzystującej kolumnę Zapośredniczenie AdMob, na temat integracji kaskadowych. Omawiamy sposób dodawania linii do konfiguracji zapośredniczenia i integracji pakietu SDK Line i adaptera aplikację Android .

Etykiety w interfejsie wiersza są zapisane w języku japońskim, przyciski i opisy. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. Jednak w opisach i instrukcjach tego przewodnika etykiety i przyciski są przetłumaczone z odpowiednimi odpowiednikami w języku angielskim w nawiasach.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia na potrzeby linii ma te funkcje:

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

1. Integracja kaskadowa jest w otwartej wersji beta.

Wymagania

  • Interfejs API Androida na poziomie 21 lub wyższym

Krok 1. Skonfiguruj konfiguracje w interfejsie Line

Zaloguj się na konto Line.

Dodaj nową aplikację

Kliknij 広告枠管理 (Zarządzanie boksami reklamowymi) > 여デすア (multimedia). Następnie kliknij OPEN規作成 (Utwórz nowe).

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, a następnie kliknij (登録) Zarejestruj się.

Zanotuj identyfikator przedziału.

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.

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.

Krok 3. Zaimportuj pakiet SDK Line i adapter

W pliku build.gradle.kts na poziomie aplikacji dodaj tę implementację zależności i konfiguracji. Używaj najnowszych wersji pakietu Line SDK i adapter:

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

Integracja ręczna

  1. Pobierz najnowszą wersję .aar pakietu Line SDK i dodaj go do projektu.

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

Krok 4. Dodaj wymagany kod

Integracja wiersza nie wymaga dodatkowego kodu.

Krok 5. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby AdMob.

Aby dowiedzieć się, jak włączyć reklamy testowe, postępuj zgodnie z instrukcjami podanymi w dokumentacji linii

Weryfikacja reklam testowych

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

Kroki opcjonalne:

Parametry charakterystyczne dla sieci

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

enableAdSound
boolean, aby określić domyślny stan rozpoczęcia odtwarzania dźwięku banera, reklam pełnoekranowych i reklam z nagrodą.

Oto przykładowy kod, 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 liniowy wypełnia te Opisy pól w zaawansowanych reklamach natywnych 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 Line SDK nie zawiera komponentu z ikoną aplikacji. Zamiast tego w aplikacji wypełnia się ładowarka linii z przezroczystym obrazem.

Kody błędów

Jeśli adapter nie odbierze reklamy z linii, możesz sprawdzić bazowy błąd w odpowiedzi na żądanie reklamy za pomocą funkcji ResponseInfo.getAdapterResponses() w następujących klasach:

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

Oto kody i towarzyszące im komunikaty wysyłane przez adapter Line, gdy nie można wczytać reklamy:

Kod błędu Domena Przyczyna
1-10 com.five_corp.ad Pakiet SDK Line zwrócił błąd związany z pakietem SDK. Zobacz Dokumentacja wiersza .
101 com.google.ads.mediation.line Brak identyfikatora aplikacji lub jest on nieprawidłowy.
102 com.google.ads.mediation.line Brak identyfikatora gniazda lub jest on nieprawidłowy.
103 com.google.ads.mediation.line Żądany rozmiar reklamy nie pasuje do rozmiaru banera reklamowego obsługiwanego w wierszu.
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 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 brakujących komponentów.
1-10 Wysłane przez Line SDK Pakiet SDK Line zwrócił błąd związany z pakietem SDK. Zobacz Dokumentacja wiersza .
101 com.google.ads.mediation.line Nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub identyfikatora przedziału).
102 com.google.ads.mediation.line Żądany rozmiar reklamy nie pasuje do rozmiaru banera reklamowego obsługiwanego w wierszu.
103 com.google.ads.mediation.line Nie udało się wczytać komponentu z obrazem z ikoną informacji do reklamy natywnej.

LINE Historia zmian adaptera zapośredniczenia Androida

Wersja 2.8.20240722.0

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

Zaprojektowane i przetestowane:

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

Zaprojektowane i przetestowane:

  • 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

  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 23.0.0.
  • Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.7.20240214.0.

Zaprojektowane i przetestowane:

  • 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

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

Zaprojektowane i przetestowane:

  • 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 atrybut FiveAdViewEventListener na rzecz FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener FiveAdInterstitialEventListener i FiveAdNativeEventListener.
  • Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.7.20240112.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 22.6.0.

Zaprojektowane i przetestowane:

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

Wersja 2.6.20230607.1

  • Dodano klasę LineExtras dla wydawców, która pozwala określić domyślne ustawienia dźwięku dla: banerów, reklam pełnoekranowych i reklam z nagrodą.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 22.4.0.

Zaprojektowane i przetestowane:

  • 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ę formatów banerów, reklam pełnoekranowych, reklam z nagrodą i reklam natywnych.
  • Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.6.20230607.

Zaprojektowane i przetestowane:

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