Integracja linii z zapośredniczeniem (beta)

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z elementu zamówienia liniowego z wykorzystaniem zapośredniczenia w zakresie integracji kaskady. Opisano w nim, jak dodać wiersz do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter wiersza z aplikacją Android .

Interfejs panelu wiersza poleceń zawiera etykiety, przyciski i opisy 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 tłumaczone z angielskimi odpowiednikami w nawiasach.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dotyczący linii ma te możliwości:

Integracja
Ustalanie stawek
Wodospad	^1
Formaty
Baner
Pełnoekranowa
Otrzymano
Natywna

¹ Integracja kaskadowa znajduje się w otwartej wersji beta.

Wymagania

• Interfejs API Androida na poziomie 19 lub wyższym

• Najnowszy pakiet SDK do reklam mobilnych Google

• Skorzystaj z zapośredniczenia Wprowadzenie

Krok 1. Skonfiguruj konfiguracje w interfejsie wiersza

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

Uwaga: aby uzyskać dostęp do tworzenia miejsc docelowych reklam natywnych w interfejsie Line Ads, skontaktuj się ze swoim menedżerem konta Line Ads Network.

Zanotuj identyfikator przedziału.

Krok 2. Skonfiguruj żądania liniowe w AdMob interfejsie użytkownika

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 Line SDK i adapter

Uwaga: jeśli nie zintegrujesz zgodnej wersji pakietu liniowego z pakietem SDK do reklam mobilnych Google, mogą wystąpić problemy z kompilacją.

Integracja Android Studio (zalecana)

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

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

Integracja ręczna

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

2. Otwórz artefakty adaptera liniowego w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik .aar adaptera liniowego i dodaj go do projektu.

Krok 4. Dodaj wymagany kod

Integracja z wierszem 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

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy AdMob iLine .

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 specyficzne 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ąca domyślny stan początkowy dźwięku banerów, reklam pełnoekranowych i reklam z nagrodą.

Oto przykład kodu, który pokazuje, jak utworzyć żądanie reklamy ustawiające te parametry:

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 zaawansowanych pól reklam natywnych elementów NativeAd.

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

¹ W przypadku reklam natywnych pakiet SDK linii nie zawiera komponentu z ikoną aplikacji. Zamiast tego adapter wypełnia ikonę aplikacji przezroczystym obrazem.

Kody błędów

Jeśli adapter nie otrzyma reklamy z wiersza, możesz sprawdzić podstawowy błąd w odpowiedzi reklamy, używając właściwości ResponseInfo.getAdapterResponse() dostępnych w tych klasach:

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

Oto kody i powiązane z nimi komunikaty wysyłane przez adapter liniowy, gdy nie można wczytać reklamy:

Kod błędu	Domena	Przyczyna
1-10	com.five_corp.ad	Pakiet SDK linii zwrócił błąd związany z pakietem SDK. Więcej informacji znajdziesz w dokumentacji linii.
101	com.google.ads.mediation.line	Brak identyfikatora aplikacji lub jest on nieprawidłowy.
102	com.google.ads.mediation.line	Brak identyfikatora przedziału lub jest on nieprawidłowy.
103	com.google.ads.mediation.line	Żądany rozmiar reklamy nie pasuje do rozmiaru banera reklamowego obsługiwanego przez wiersze.
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 linii 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 braku komponentów.
1-10	Wysłane przez Line SDK	Pakiet SDK linii zwrócił błąd związany z pakietem SDK. Więcej informacji znajdziesz w dokumentacji linii.
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 przez wiersze.
103	com.google.ads.mediation.line	Nie udało się wczytać w reklamie natywnej komponentu z obrazem ikony informacji.

Historia zmian adaptera Android Mediation LINE

Wersja 2.7.20240214.0

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

Stworzone i przetestowane w:

• Pakietu SDK do reklam mobilnych Google w wersji 22.6.0.
• FiveAd SDK w wersji 2.7.20240214.0.

Wersja 2.7.20240126.0

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

Stworzone i przetestowane w:

• Pakietu SDK do reklam mobilnych Google w wersji 22.6.0.
• FiveAd SDK w wersji 2.7.20240126.0.

Wersja 2.7.20240112.0

• Usunięto wycofane parametry FiveAdViewEventListener na rzecz FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener i FiveAdNativeEventListener.
• Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.7.20240112.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 22.6.0.

Stworzone i przetestowane w:

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

Wersja 2.6.20230607.1

• Dodaliśmy klasę LineExtras dla wydawców, aby zdefiniować domyślne ustawienia dźwięku formatów banerów, reklam pełnoekranowych i reklam z nagrodą.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 22.4.0.

Stworzone i przetestowane w:

• Pakietu SDK do reklam mobilnych Google w wersji 22.4.0.
• FiveAd SDK w wersji 2.6.20230607.

Wersja 2.6.20230607.0

• Pierwsza wersja.
• Wprowadziliśmy obsługę formatów banerów, reklam pełnoekranowych, reklam z nagrodą i reklam natywnych.
• Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.6.20230607.

Stworzone i przetestowane w:

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