Integrowanie LY Ads Network z zapośredniczeniem

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

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads Flutter Plugin do wczytywania i wyświetlania reklam z sieci reklamowej LY Ads Network za pomocą zapośredniczenia, które obejmuje integracje kaskadowe. Dowiesz się z niego, jak dodać LY Ads Network do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter LY Ads Network z aplikacją we Flutterze.

Obsługiwane integracje i formaty reklam

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

Integracja
Określanie stawek
Kaskada
Formaty
Baner
Pełnoekranowa
Z nagrodą
Rodzimy użytkownik

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

  • Najnowsza wersja Google Mobile Ads Flutter Plugin.
  • Flutter w wersji 3.7.0 lub nowszej.
  • To deploy on Android
    • Android z interfejsem API na poziomie 24 lub wyższym.
  • 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. Szczegółowe informacje znajdziesz w artykule Konfigurowanie Google Mobile Ads Flutter Plugin.
  • Skonfiguruj zapośredniczenie.

    • Krok 1. Skonfiguruj ustawienia w interfejsie sieci reklamowej LY

    Zarejestruj się i zaloguj na konto LY Sieć reklamowa.

    Dodawanie nowej aplikacji

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

    Nowa rejestracja

    Wypełnij formularz i kliknij 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 Aplikacja wybierz aplikację, aby wyświetlić jej szczegóły. W sekcji Boks kliknij Dodaj.

    Dodaj boks

    Wypełnij formularz, aby uzyskać szczegółowe informacje o miejscu. W sekcji Typ określania stawek wybierz Standardowe, aby skonfigurować ten boks na potrzeby zapośredniczenia kaskadowego, lub Określanie stawek przez pakiet SDK Google, aby skonfigurować ten boks na potrzeby określania stawek. Po wypełnieniu formularza kliknij Utwórz.

    Formularz dodawania boksu

    Zanotuj identyfikator boksu.

    Szczegóły boksu

    Po utworzeniu pierwszego boksu kliknij Sprawdź na stronie z informacjami o aplikacji, aby uzyskać zatwierdzenie od sieci reklamowej LY Ads Network. Może to chwilę potrwać. Jeśli masz pytania, skontaktuj się z przedstawicielem sieci reklamowej LY.

    Poproś o sprawdzenie

    Tworzenie klucza interfejsu API raportowania

    Otwórz kartę Zarządzanie kluczami interfejsu API do raportowania i kliknij przycisk Utwórz klucz interfejsu API.

    Karta klucza interfejsu API do raportowania

    Wypełnij formularz i kliknij Zapisz.

    Formularz klucza interfejsu API do raportowania

    Zapisz identyfikator klucza interfejsu API i klucz tajny interfejsu API.

    Formularz klucza interfejsu API do raportowania

    Zaktualizuj plik 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 znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze nie masz pliku app-ads.txt, utwórz go na potrzeby Ad Managera.

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

    Krok 2. Skonfiguruj żądania LY Ads Network w interfejsie Ad Managera

    Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

    Android

    Instrukcje znajdziesz w kroku 2 w przewodniku dla Android.

    iOS

    Instrukcje znajdziesz w kroku 2 w przewodniku dla systemu iOS.

    Krok 3. Zaimportuj pakiet SDK i adapter sieci reklamowej LY Ads

    Integracja przez pub.dev

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

    dependencies:
  gma_mediation_line: ^2.2.1

    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 zawartością) do projektu Flutter. Następnie dodaj odwołanie do wtyczki w pliku pubspec.yaml, dodając tę zależność:

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

    Krok 4. Dodaj wymagany kod

    Android

    Integracja z siecią reklamową LY Ads Network nie wymaga dodatkowego kodu.

    iOS

    Integracja SKAdNetwork

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

    Krok 5. Przetestuj implementację

    Włączanie reklam testowych

    Upewnij się, że urządzenie testowe jest zarejestrowane w usłudze Ad Manager.

    Sprawdzanie reklam testowych

    Aby sprawdzić, czy otrzymujesz reklamy testowe z sieci reklamowej LY Ads Network, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając ze źródeł reklam LY Ads Network.

    Kroki opcjonalne:

    Parametry dotyczące sieci

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

    • enableAdSound : określa domyślny stan początkowy dźwięku w reklamach banerowych, pełnoekranowych i z nagrodą.

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

    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ć błąd w odpowiedzi na żądanie reklamy, używając metody ResponseInfo w tych klasach:

    Android

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

    iOS

    GADMediationAdapterLine

    Oto kody i powiązane z nimi komunikaty, które adapter sieci reklamowej LY Ads Network wyświetla, gdy nie uda się wczytać reklamy:

    Android

    Kod błędu Domena Przyczyna
    1-10 com.five_corp.ad Pakiet SDK sieci reklamowej LY Ads Network zwrócił błąd związany z pakietem SDK. Więcej informacji znajdziesz w dokumentacji sieci reklamowej LY Ads Network.
    101 com.google.ads.mediation.line Brakujący lub nieprawidłowy identyfikator aplikacji.
    102 com.google.ads.mediation.line Brak identyfikatora boksu lub jest on nieprawidłowy.
    103 com.google.ads.mediation.line Żądany rozmiar reklamy nie pasuje do rozmiaru banera reklamowego obsługiwanego przez sieć reklamową LY Ads Network.
    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 sieci reklamowej LY Ads 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.
    107 com.google.ads.mediation.line Pakiet SDK FiveAd zwrócił pusty obiekt do wczytywania reklam.

    iOS

    Kod błędu Domena Przyczyna
    1-10 Wysłane przez pakiet SDK sieci reklamowej LY Pakiet SDK sieci reklamowej LY Ads Network zwrócił błąd związany z pakietem SDK. Więcej informacji znajdziesz w dokumentacji sieci reklamowej LY Ads Network.
    101 com.google.ads.mediation.line Nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub identyfikatora boksu).
    102 com.google.ads.mediation.line Żądany rozmiar reklamy nie pasuje do rozmiaru banera reklamowego obsługiwanego przez sieć reklamową LY Ads Network.
    103 com.google.ads.mediation.line Nie udało się wczytać komponentu z obrazem ikony informacji w reklamie natywnej.
    104 com.google.ads.mediation.line Nie udało się zebrać sygnałów na potrzeby określania stawek.
    105 com.google.ads.mediation.line Nie udało się zainicjować modułu do ładowania reklam pakietu SDK LINE Ads.

    Historia zmian adaptera zapośredniczenia Line Flutter

    Wersja 2.2.2 (w toku)

    • Teraz wymagany jest system iOS w wersji co najmniej 15.0.

    Wersja 2.2.1

    Wersja 2.2.0

    Wersja 2.1.3

    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