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 Unity 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ą Unity.

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ą

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź, czy:

  • Najnowsza wersja Google Mobile Ads Unity Plugin.
  • Unity Editor w wersji 4 lub nowszej.
  • [W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w ramach określania stawek, użyj wtyczki zapośredniczenia reklam mobilnych Google do sieci reklamowej LY w wersji 1.5.0 lub nowszej (zalecamy najnowszą wersję).
  • 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 Unity skonfigurowany za pomocą Google Mobile Ads Unity Plugin. Szczegółowe informacje znajdziesz w artykule Konfigurowanie Google Mobile Ads Unity Plugin.
  • Skonfiguruj mediację.

    • 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

    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 miejsca reklamowego kliknij Sprawdź na stronie z informacjami o aplikacji, aby uzyskać zgodę od sieci reklamowej LY Ads Network. Może to chwilę potrwać. Jeśli masz pytania, skontaktuj się z przedstawicielem sieci reklamowej LY Ads.

    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

    Zanotuj 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 popyt sieci reklamowej LY 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 LY Ads Network

    OpenUPM-CLI

    Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę do zapośredniczenia sieci reklamowych LY Ads Network w Google Mobile Ads na potrzeby Unity, uruchamiając to polecenie z katalogu głównego projektu:

    openupm add com.google.ads.mobile.mediation.line

    OpenUPM

    W edytorze projektu Unity kliknij Edit (Edytuj) > Project Settings (Ustawienia projektu) > Package Manager (Menedżer pakietów), aby otworzyć Ustawienia menedżera pakietów Unity.

    Na karcie Scoped Registries (Rejestry ograniczone) dodaj OpenUPM jako rejestr ograniczony z tymi informacjami:

    • Nazwa: OpenUPM
    • URL: https://package.openupm.com
    • Zakresy: com.google

    Szczegóły OpenUPM

    Następnie kliknij Window (Okno) > Package Manager (Menedżer pakietów), aby otworzyć Unity Package Manager (Menedżer pakietów Unity), i wybierz My Registries (Moje rejestry) z menu.

    Rejestry Unity

    Wybierz pakiet Google Mobile Ads Line Mediation i kliknij Install (Zainstaluj).

    Instalowanie z OpenUPM

    Pakiet Unity

    Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla sieci reklamowej LY Ads Network, korzystając z linku pobierania w liście zmian, i wyodrębnij plik GoogleMobileAdsLineMediation.unitypackage z pliku ZIP.

    W edytorze projektu Unity kliknij Assets (Zasoby) > Import Package (Importuj pakiet) > Custom Package (Pakiet niestandardowy) i znajdź pobrany plik GoogleMobileAdsLineMediation.unitypackage. Sprawdź, czy wszystkie pliki są zaznaczone, i kliknij Importuj.

    Importowanie z Unity

    Następnie kliknij Assets (Zasoby) > External Dependency Manager (Menedżer zależności zewnętrznych) > Android Resolver (Narzędzie do rozwiązywania problemów z Androidem) > Force Resolve (Wymuś rozwiązanie). Biblioteka External Dependency Manager przeprowadzi od podstaw proces rozwiązywania zależności i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android aplikacji Unity.

    Wymuś rozwiązanie

    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.

    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 Unity sieci reklamowej LY obsługuje ten dodatkowy parametr żądania, który można przekazać do adaptera za pomocą klasy LineMediationExtras:

    • SetEnableAdSound(boolean) : 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:

    using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...

var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(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 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 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ł 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 miejsca).
    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 wtyczki do zapośredniczenia w Unity w przypadku usługi LINE

    Wersja 2.2.1

    Wersja 2.2.0

    Wersja 2.1.1

    Wersja 2.1.0

    Wersja 2.0.2

    Wersja 2.0.1

    Wersja 2.0.0

    Wersja 1.5.10

    Wersja 1.5.9

    Wersja 1.5.8

    Wersja 1.5.7

    Wersja 1.5.6

    Wersja 1.5.5

    • Rozwiązaliśmy problem, który powodował, że instalacja za pomocą OpenUPM uniemożliwiała prawidłowe importowanie pakietów przez wtyczkę.

    Wersja 1.5.4

    Wersja 1.5.3

    Wersja 1.5.2

    Wersja 1.5.1

    Wersja 1.5.0

    Wersja 1.4.0

    Wersja 1.3.1

    Wersja 1.3.0

    Wersja 1.2.0

    Wersja 1.1.2

    Wersja 1.1.1

    Wersja 1.1.0

    Wersja 1.0.0