Integrowanie LY Ads Network z zapośredniczeniem

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

Obsługiwane integracje i formaty reklam

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

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te informacje:

• Najnowsza wersja Google Mobile Ads Flutter Plugin.
• Platforma Flutter w wersji 3.7.0 lub nowszej.
• Aby wdrożyć aplikację na Androidzie:
  • Android w wersji 23 lub nowszej.
• Aby wdrożyć aplikację 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 LY Ads Network

Zarejestruj się i zaloguj na konto LY Ads Network.

Dodawanie nowej aplikacji

Otwórz kartę App (Aplikacja) i kliknij przycisk New registration (Nowa rejestracja).

Wypełnij formularz i kliknij registration (rejestracja).

Zanotuj identyfikator aplikacji.

Tworzenie boksu reklamowego

Na karcie App (Aplikacja) wybierz aplikację, aby wyświetlić jej szczegóły. W sekcji Slot (Miejsce na reklamę) kliknij Add (Dodaj).

Wypełnij formularz, podając szczegóły miejsca na reklamę. W przypadku opcji Bidding Type (Typ określania stawek) wybierz Standard (Standardowy), aby skonfigurować to miejsce na reklamę pod kątem zapośredniczenia kaskadowego, lub Google SDK Bidding (Określanie stawek przez pakiet SDK Google), aby skonfigurować to miejsce na reklamę pod kątem określania stawek. Po wypełnieniu formularza kliknij Create (Utwórz).

Zanotuj identyfikator miejsca na reklamę.

Po utworzeniu pierwszego miejsca na reklamę kliknij Review (Sprawdź) na stronie ze szczegółami aplikacji, aby uzyskać zgodę od LY Ads Network. Może to chwilę potrwać. Jeśli masz pytania, skontaktuj się z przedstawicielem LY Ads Network.

Tworzenie klucza interfejsu API raportowania

Otwórz kartę Managing reporting API keys (Zarządzanie kluczami interfejsu API raportowania) i kliknij przycisk Create API key (Utwórz klucz interfejsu API).

Wypełnij formularz i kliknij Save (Zapisz).

Zanotuj identyfikator klucza interfejsu API i tajny klucz interfejsu API.

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, musisz wdrożyć plik 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 LY Ads Network, zapoznaj się z artykułem Informacje o pliku app-ads.txt.

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

Konfigurowanie ustawień zapośredniczenia jednostki reklamowej

Krok 3. Zaimportuj pakiet SDK i adapter LY Ads Network

Integracja przez pub.dev

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

dependencies:
  gma_mediation_line: ^2.1.2

Integracja ręczna

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla LY 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ść:

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

Krok 4. Dodaj wymagany kod

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Zarejestruj urządzenie testowe w Ad Managerze.

Sprawdzanie reklam testowych

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

Kroki opcjonalne:

Parametry specyficzne dla sieci

Wtyczka zapośredniczenia Flutter dla LY Ads Network 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 w reklamach banerowych, pełnoekranowych i 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 sieci reklamowej LY Ads Network, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy za pomocą ResponseInfo w tych klasach:

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

GADMediationAdapterLine

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

Dziennik zmian adaptera zapośredniczenia Line Flutter

Wersja 2.1.2

• Obsługuje adapter Line na Androida w wersji 3.1.1.1.
• Obsługuje adapter Line na iOS w wersji 3.0.1.2.
• Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 9.0.0.

Wersja 2.1.1

• Obsługuje adapter Line na Androida w wersji 3.1.1.0.
• Obsługuje adapter Line na iOS w wersji 3.0.1.2.
• Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 9.0.0.

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.
• Zbudowany i przetestowany 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.
• Zbudowany i przetestowany 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.
• Zbudowany i przetestowany 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.
• Zbudowany i przetestowany 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.
• Zbudowany i przetestowany 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.
• Zbudowany i przetestowany 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.
• Zbudowany i przetestowany 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.
• Zbudowany i przetestowany 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.
• Zbudowany i przetestowany za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 5.3.1.