Integracja sieci reklamowej LINE z zapośredniczeniem

Wybierz platformę: Android Android iOS Unity Flutter

Z tego przewodnika dowiesz się, jak używać Google Mobile Ads Flutter Plugin aby wczytywać i wyświetlać reklamy z LINE Ads Network za pomocą zapośredniczenia, w tym integracji typu wodospad. Dowiesz się, jak dodać LINE Ads Network do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter LINE Ads Network z aplikacją Flutter.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia Ad Managera dla LINE Ads Network ma te możliwości:

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

Wymagania

• Najnowsze Google Mobile Ads Flutter Plugin
• Flutter 3.7.0 lub nowszy
• Aby wdrożyć na Androidzie:
  • Android API w wersji 23 lub nowszej
• Aby wdrożyć na iOS:
  • iOS w wersji 13.0 lub nowszej
• Działający projekt Flutter skonfigurowany za pomocą Google Mobile Ads Flutter Plugin. Więcej informacji znajdziesz w artykule Konfigurowanie Google Mobile Ads Flutter Plugin.
• Skonfiguruj zapośredniczenie.

Krok 1. Skonfiguruj ustawienia w interfejsie LINE Ads Network

Zarejestruj się i zaloguj na konto LINE Ads Network.

Dodawanie nowej aplikacji

Otwórz kartę アプリ (Aplikacja) i kliknij przycisk 新規登録 (Nowa rejestracja).

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

Uwaga: musisz utworzyć osobną aplikację dla każdej platformy, którą chcesz obsługiwać.

Zanotuj アプリID (identyfikator aplikacji).

Android

iOS

Tworzenie boksu reklamowego

Na karcie アプリ (Aplikacja) wybierz aplikację, aby wyświetlić jej szczegóły. W sekcji スロット (Boks) kliknij 追加 (Dodaj).

Wypełnij formularz, podając szczegóły boksu. W przypadku Bidding Type (Typ określania stawek) wybierz Standard, aby skonfigurować ten boks pod kątem zapośredniczenia kaskadowego, lub Google SDK Bidding, aby skonfigurować ten boks pod kątem określania stawek przez pakiet SDK. Gdy formularz będzie wypełniony, kliknij 作成 (Utwórz).

Uwaga: po zarejestrowaniu boksu nie można zmienić 広告フォーマット (formatu reklamy) ani Bidding Type (typu określania stawek). Aby uzyskać dostęp do tworzenia miejsc docelowych reklam natywnych w interfejsie LINE Ads Network, skontaktuj się z menedżerem konta LINE Ads Network.

Zanotuj スロットID (identyfikator boksu).

Aktualizowanie pliku app-ads.txt

Authorized Sellers for Apps (czyli 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 utracie przychodów z reklam, użyj pliku app-ads.txt. Jeśli jeszcze tego nie zrobisz, utwórz plik app-ads.txt dla Ad Managera.

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

Krok 2. Skonfiguruj popyt LINE Ads Network w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 przewodnika dla Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.

Krok 3. Zaimportuj pakiet SDK i adapter LINE Ads Network

Uwaga: brak integracji zgodnych wersji pakietów SDK sieci reklamowej LINE Ads Network i pakietów SDK do reklam mobilnych Google może spowodować problemy z kompilacją.

Integracja przez pub.dev

Dodaj tę zależność z najnowszymi wersjami pakietu SDK i adaptera LINE Ads Network w pliku pubspec.yaml pakietu:

dependencies:
  gma_mediation_line: ^2.1.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla LINE Ads Network, rozpakuj pobrany plik i dodaj rozpakowany folder wtyczki (wraz z jego zawartością) do projektu Flutter. Następnie dodaj do pliku pubspec.yaml tę zależność, aby odwoływać się do wtyczki:

dependencies:
  gma_mediation_line:
    path: path/to/local/package

Krok 4. Dodaj wymagany kod

Android

Integracja z LINE Ads Network nie wymaga dodatkowego kodu.

iOS

Integracja SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją LINE Ads Network.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Zarejestruj urządzenie testowe w Ad Managerze.

**Ważne:** przed opublikowaniem aplikacji wyłącz tryb testowy w Ad Managerze i LINE Ads Network.

Sprawdzanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z LINE Ads Network, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, używając źródła lub źródeł reklam LINE Ads Network (Wodospad).

Kroki opcjonalne:

Parametry specyficzne dla sieci

Wtyczka zapośredniczenia LINE Ads Network do Fluttera obsługuje ten dodatkowy parametr żądania, który można przekazać do adaptera za pomocą klasy LineMediationExtras:

• enableAdSound : określa domyślny stan dźwięku początkowego banerów, reklam pełnoekranowych i reklam z nagrodą.

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

LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [lineExtras],
);

Kody błędów

Jeśli adapter nie otrzyma reklamy z LINE Ads Network, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy za pomocą ResponseInfo w tych klasach:

Android

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

iOS

GADMediationAdapterLine

Oto kody i towarzyszące im komunikaty zwracane przez adapter LINE Ads Network, gdy nie uda się wczytać reklamy:

Android

Kod błędu	Domena	Przyczyna
1-10	com.five_corp.ad	Pakiet SDK LINE Ads Network zwrócił błąd specyficzny dla pakietu SDK. Więcej informacji znajdziesz w dokumentacji LINE Ads Network.
101	com.google.ads.mediation.line	Brakujący lub nieprawidłowy identyfikator aplikacji.
102	com.google.ads.mediation.line	Brakujący lub nieprawidłowy identyfikator boksu.
103	com.google.ads.mediation.line	Żądany rozmiar reklamy nie pasuje do rozmiaru banera reklamowego obsługiwanego przez LINE Ads Network.
104	com.google.ads.mediation.line	Nie udało się wczytać reklamy pełnoekranowej ani reklamy z nagrodą z powodu braku kontekstu działania.
105	com.google.ads.mediation.line	Pakiet SDK LINE Ads Network 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 brakujących komponentów.

iOS

Kod błędu	Domena	Przyczyna
1-10	Wysłany przez pakiet SDK LINE Ads Network	Pakiet SDK LINE Ads Network zwrócił błąd specyficzny dla pakietu SDK. Więcej informacji znajdziesz w dokumentacji LINE Ads Network.
101	com.google.ads.mediation.line	Nieprawidłowe parametry serwera (np. brakujący identyfikator aplikacji lub identyfikator boksu).
102	com.google.ads.mediation.line	Żądany rozmiar reklamy nie pasuje do rozmiaru banera reklamowego obsługiwanego przez LINE Ads Network.
103	com.google.ads.mediation.line	Nie udało się wczytać komponentu z obrazem ikony informacji w reklamie natywnej.

Dziennik zmian adaptera zapośredniczenia Line do Fluttera

Wersja 2.1.0

• Zaktualizowano minimalną wersję Fluttera do 3.38.1.
• Zaktualizowano obsługę wtyczki reklam mobilnych Google do Fluttera w wersji 8.0.0.
• Obsługuje adapter Line na Androida w wersji 3.1.0.0.
• Obsługuje adapter Line na iOS w wersji 3.0.1.0.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 8.0.0.

Wersja 2.0.0

• Zaktualizowano minimalną wersję Fluttera do 3.35.1.
• Zaktualizowano obsługę wtyczki reklam mobilnych Google do Fluttera w wersji 7.0.0.
• Obsługuje adapter Line na Androida w wersji 3.0.1.0.
• Obsługuje adapter Line na iOS w wersji 3.0.0.0.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 7.0.0.

Wersja 1.0.6

• Obsługuje adapter Line na Androida w wersji 2.9.20251028.0.
• Obsługuje adapter Line na iOS w wersji 2.9.20251119.0.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.

Wersja 1.0.5

• Obsługuje adapter Line na Androida w wersji 2.9.20250924.1.
• Obsługuje adapter Line na iOS w wersji 2.9.20250930.0.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.

Wersja 1.0.4

• Obsługuje adapter Line na Androida w wersji 2.9.20250718.0.
• Obsługuje adapter Line na iOS w wersji 2.9.20250512.0.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.

Wersja 1.0.3

• Obsługuje adapter Line na Androida w wersji 2.9.20250519.0.
• Obsługuje adapter Line na iOS w wersji 2.9.20250512.0.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.

Wersja 1.0.2

• Obsługuje adapter Line na Androida w wersji 2.9.20250317.1.
• Obsługuje adapter Line na iOS w wersji 2.9.20241106.3.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.

Wersja 1.0.1

• Obsługuje adapter Line na Androida w wersji 2.9.20250110.1.
• Obsługuje adapter Line na iOS w wersji 2.9.20241106.2.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 5.3.1.

Wersja 1.0.0

• Pierwsza wersja.
• Obsługuje adapter Line na Androida w wersji 2.9.20250110.0.
• Obsługuje adapter Line na iOS w wersji 2.9.20241106.1.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 5.3.1.