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. Wyjaśniamy w nim, jak dodać sieć reklamową LY Ads Network do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter sieci reklamowej LY Ads Network z aplikacją w Unity.

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ą

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

  • 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 określaniu stawek, użyj wtyczki do zapośredniczenia reklam mobilnych Google dla sieci reklamowej LY Ads Network w wersji 1.5.0 lub nowszej (zalecana jest najnowsza wersja).
  • To deploy on Android
    • Android API na poziomie 24 lub wyższym.
  • Aby wdrożyć 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 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 rejestracji

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

    Formularz dodawania 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.

    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

    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 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 przewodnika dotyczącego Android.

    iOS

    Instrukcje znajdziesz w kroku 2 w przewodniku dla systemu iOS.

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

    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 wybierz Edit (Edytuj) > Project Settings (Ustawienia projektu) > Package Manager (Menedżer pakietów), aby otworzyć Unity Package Manager Settings (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ć Menedżera pakietów Unity, i w menu wybierz My Registries (Moje rejestry).

    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 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 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 dźwięku na początku wyświetlania reklam 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 reklamowej LY, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z ResponseInfo w tych klasach:

    Android

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

    iOS

    GADMediationAdapterLine

    Oto kody i komunikaty, które są zwracane przez adapter sieci reklamowej LY Ads, 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 brakujących 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 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 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 wczytywania reklam pakietu SDK do reklam LINE.

    Historia zmian wtyczki Line Unity Mediation

    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