Integracja Line z zapośredniczeniem

Wybierz platformę: Android (beta) Android iOS Unity Flutter

Z tego przewodnika dowiesz się, jak za pomocą GMA Next-Gen SDK wczytywać i wyświetlać reklamy z sieci reklamowej LINE przy użyciu zapośredniczenia AdMob, w tym integracji kaskadowych. Wyjaśniamy w nim, jak dodać sieć reklamową LINE do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter sieci reklamowej LINE z aplikacją na Androida.

Interfejs panelu sieci reklamowej LINE używa japońskiego tekstu w przypadku etykiet, przycisków i opisów. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak tłumaczone, a w nawiasach podawane są ich angielskie odpowiedniki.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia dla sieci reklamowej LINE ma te funkcje:

¹ Reklamy natywne (na potrzeby określania stawek) są w fazie zamkniętych testów beta. Aby poprosić o dostęp, skontaktuj się z opiekunem klienta.

Wymagania

• Android w wersji 24 lub nowszej

• [W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w określaniu stawek, użyj adaptera sieci reklamowej LINE w wersji 2.9.20241129.0 lub nowszej (zalecana jest najnowsza wersja).

• Nowości na kanale GMA Next-Gen SDK

• Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia.

Krok 1. Skonfiguruj ustawienia w interfejsie sieci reklamowej LINE

Zarejestruj się i zaloguj na konto LINE Ads Network.

Dodawanie nowej aplikacji

Kliknij 広告枠管理 (Ad Slot Management) > メディア (Media). Następnie kliknij 新規作成 (Utwórz nowy).

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

Kliknij スロット 追加 (Add Slot).

Wypełnij formularz, aby podać szczegóły dotyczące miejsca reklamowego. W sekcji Typ określania stawek wybierz Standardowe, aby skonfigurować to miejsce na potrzeby zapośredniczenia kaskadowego, lub Określanie stawek przez pakiet SDK Google, aby skonfigurować to miejsce na potrzeby określania stawek. Po wypełnieniu formularza kliknij 登録 (Zarejestruj).

Zapisz identyfikator miejsca docelowego.

Aktualizowanie pliku app-ads.txt

Authorized Sellers for Apps (plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli nie zostało to jeszcze zrobione, skonfiguruj plik app-ads.txt pod kątem aplikacji.

Aby wdrożyć app-ads.txt w przypadku sieci reklamowej LINE, zapoznaj się z artykułem Informacje o pliku app-ads.txt.

Krok 2. Skonfiguruj popyt sieci reklamowej LINE w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać sieć reklamową LINE do konfiguracji mediacji w przypadku jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediacja. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie sieci reklamowej LINE jako źródła reklam.

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

Wpisz format reklamy i platformę, a potem kliknij Dalej.

Nadaj grupie zapośredniczenia nazwę 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ą z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny się teraz wyświetlać wybrane przez Ciebie jednostki:

Dodawanie sieci reklamowej LINE Ads Network jako źródła reklam

Określanie stawek

Na karcie Określanie stawek w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie wybierz Sieć reklamowa LINE.

Kliknij Jak podpisać umowę partnerską i skonfiguruj partnerstwo w zakresie określania stawek z siecią reklamową LINE.



Kliknij Potwierdzam i wyrażam zgodę, a potem Dalej.



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



Następnie wpisz identyfikator aplikacji i identyfikator miejsca uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Wodospad

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklam.

Wybierz Sieć reklamowa LINE i włącz przełącznik Optymalizuj. Wpisz nazwę logowania i hasło uzyskane w poprzedniej sekcji, aby skonfigurować optymalizację źródła reklam w przypadku sieci reklamowej LINE. Następnie wpisz wartość eCPM dla sieci reklamowej LINE Ads Network i kliknij Dalej.



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

Następnie wpisz identyfikator aplikacji i identyfikator miejsca docelowego uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Krok 3. Zaimportuj pakiet SDK i adapter sieci reklamowej LINE

Integracja z Androidem Studio (zalecana)

W pliku Gradle na poziomie aplikacji dodaj te zależności implementacji i konfiguracje:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:line:3.0.1.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:line:3.0.1.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integracja ręczna

1. Pobierz najnowszą wersję pakietu SDK sieci reklamowej LINE w .aarpliku i dodaj go do projektu.

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

Krok 4. Dodaj wymagany kod

Integracja z siecią reklamową LINE nie wymaga dodatkowego kodu.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe w AdMob.

Adapter sieci reklamowej LINE zawiera metodę pomocniczą, która umożliwia włączenie trybu testowego w przypadku tej sieci. Musisz ustawić tę opcję przed zainicjowaniemGMA Next-Gen SDK, aby mieć pewność, że zostaną one prawidłowo przekazane do pakietu SDK sieci reklamowej LINE.

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

Weryfikowanie reklam testowych

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

Kroki opcjonalne:

Parametry dotyczące sieci

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

enableAdSound

A – określa domyślny stan dźwięku banerów, reklam pełnoekranowych i reklam z nagrodą.boolean

Oto przykład kodu, który pokazuje, jak utworzyć żądanie reklamy z tymi parametrami:

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

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

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

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

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter LINE Ads Network wypełnia te zaawansowane pola w reklamach natywnych w przypadku NativeAd.

¹ W przypadku reklam natywnych pakiet SDK sieci reklamowej LINE nie udostępnia ikony aplikacji. Zamiast tego adapter sieci reklamowej LINE wypełnia ikonę aplikacji przezroczystym obrazem.

Kody błędów

Jeśli adapter nie otrzyma reklamy z sieci reklamowej LINE, możesz sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z ResponseInfo.getAdSourceResponses() w tych klasach:

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

Oto kody i komunikaty, które są zwracane przez adapter sieci reklamowej LINE Ads Network, gdy nie uda się wczytać reklamy: