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ą
Natywna

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

  • Najnowsza wersja Google Mobile Ads Flutter Plugin.
  • platformy Flutter w wersji 3.7.0 lub nowszej,
  • To deploy on Android
    • Android API na poziomie 24 lub wyższym.
  • Wdrażanie 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 sieci reklamowej LY

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

    Dodawanie nowej aplikacji

    Otwórz kartę Aplikacja i kliknij przycisk Nowa rejestracja.

    Nowa rejestracja

    Wypełnij formularz i kliknij rejestracja.

    Nowy formularz rejestracyjny

    Zapisz 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 Slot kliknij Dodaj.

    Dodaj boks

    Wypełnij formularz, aby podać szczegóły dotyczące miejsca docelowego. W sekcji Typ określania stawek wybierz Standardowe, aby skonfigurować ten slot pod kątem zapośredniczenia kaskadowego, lub Określanie stawek przez pakiet SDK Google, aby skonfigurować ten slot pod kątem określania stawek. Po wypełnieniu formularza kliknij Utwórz.

    Dodawanie formularza 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 Reporting API

    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

    Aktualizowanie pliku app-ads.txt

    Plik Authorized Sellers for Apps 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 tego nie zrobiono, utwórz plik app-ads.txt 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 sieci reklamowej LY Ads 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 przewodnika dotyczącego 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 jego 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 nie wymaga dodatkowego kodu.

    iOS

    Integracja SKAdNetwork

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

    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 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 sieci reklamowej LY Ads Network Flutter 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 LY Ads Network, wydawcy mogą sprawdzić błąd w odpowiedzi na żądanie reklamy, używając 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 zwrócił błąd specyficzny dla pakietu 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 Brakujący lub nieprawidłowy identyfikator miejsca docelowego.
    103 com.google.ads.mediation.line Żądany rozmiar reklamy nie pasuje do rozmiaru banera reklamowego obsługiwanego przez sieć LY Ads.
    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 zdołał 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ł moduł wczytywania reklam o wartości null.

    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ć LY Ads.
    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 wczytywania reklam pakietu SDK do reklam LINE.

    Historia zmian w adapterze do zapośredniczenia w przypadku reklam w Flutterze

    Wersja 2.2.2 (w toku)

    • Wymaga teraz minimalnej wersji iOS 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