Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam Line za pomocą zapośredniczenia AdMob,integracji kaskadowej. Dowiesz się z niego, jak dodać element Line do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK Line i adapter 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 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 zapośredniczenia na potrzeby linii ma te funkcje:
Integracja | |
---|---|
Ustalanie stawek | |
Wodospad | 1 |
Formaty | |
Baner | |
Pełnoekranowa | |
Otrzymano | |
Natywna |
1 Integracja Waterfall jest w otwartej wersji beta.
Wymagania
- Interfejs API Androida na poziomie 21 lub wyższym
Najnowszy pakiet SDK do reklam mobilnych Google
Wykonaj zapośredniczenie Przewodnik dla początkujących
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
Integracja z Android Studio (zalecana)
W pliku build.gradle.kts
na poziomie aplikacji dodaj poniższe 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.2.0")
implementation("com.google.ads.mediation:line:2.7.20240515.0")
}
Integracja ręczna
Pobierz najnowszą wersję pliku
.aar
Line SDK i dodaj ją do swojego projektu.Przejdź do artefaktów adaptera Line w repozytorium Google Maven. Wybierz najnowszą wersję, pobierz plik
.aar
adaptera linii 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ć do adaptera za pomocą klasy LineExtras
. Ten konstruktor klas zawiera następujące 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ł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 zaawansowanych reklam 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 SDK Line nie zawiera komponentu z ikoną 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 na reklamę, używając 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 Line zwrócił błąd związany z pakietem SDK. Więcej informacji znajdziesz w dokumentacji 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. Więcej informacji znajdziesz w dokumentacji 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.7.20240515.0
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 23.1.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 reguły
FiveAdViewEventListener
na rzeczFiveAdCustomLayoutEventListener
,FiveAdVideoRewardEventListener
,FiveAdInterstitialEventListener
iFiveAdNativeEventListener
. - 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
- Dodaliśmy klasę
LineExtras
dla wydawców, która pozwala określić domyślne ustawienia dźwięku w formatach 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.