Integrowanie LY Ads Network z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

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 kaskadowych. 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:

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

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 Fluttera 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).

Nowa rejestracja

Wypełnij formularz i kliknij registration (rejestracja).

Nowy formularz rejestracyjny

Zanotuj identyfikator aplikacji.

Android

Szczegółowe informacje na temat rejestracji

iOS

Szczegółowe informacje na temat rejestracji

Tworzenie boksu reklamowego

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

Dodaj boks

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

Formularz dodawania boksu

Zanotuj identyfikator boksu.

Szczegóły przedziału

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

Poproś o sprawdzenie

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

Karta Klucz API raportowania

Wypełnij formularz i kliknij Save (Zapisz).

Formularz klucza interfejsu API do raportowania

Zanotuj identyfikator klucza interfejsu API i tajny klucz interfejsu API.

Formularz klucza interfejsu API do raportowania

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 zaimplementować 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

Android

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego iOS.

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 (oraz jego zawartość) do projektu Fluttera. Następnie dodaj do pliku pubspec.yaml tę zależność:

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

Krok 4. Dodaj wymagany kod

Android

W przypadku integracji z LY Ads Network nie jest wymagany żaden dodatkowy kod.

iOS

Integracja SKAdNetwork

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

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 Fluttera 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:

Android

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

iOS

GADMediationAdapterLine

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

Android

Kod błędu Domena Przyczyna
1-10 com.five_corp.ad Pakiet SDK LY Ads Network zwrócił błąd specyficzny dla pakietu SDK. Więcej informacji znajdziesz w dokumentacjiLY Ads Network's.
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 LY Ads Network.
104 com.google.ads.mediation.line Nie udało się wczytać reklamy pełnoekranowej ani reklamy z nagrodą z powodu braku kontekstu Activity.
105 com.google.ads.mediation.line Pakietowi SDK LY Ads Network nie udało się wyświetlić reklamy pełnoekranowej ani 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 LY Ads Network Pakiet SDK LY Ads Network zwrócił błąd specyficzny dla pakietu SDK. Więcej informacji znajdziesz w dokumentacjiLY Ads Network's.
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 LY 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 Fluttera dla Line

Wersja 2.1.2

Wersja 2.1.1

Wersja 2.1.0

Wersja 2.0.0

Wersja 1.0.6

Wersja 1.0.5

Wersja 1.0.4

Wersja 1.0.3

Wersja 1.0.2

Wersja 1.0.1

Wersja 1.0.0