Integrowanie LY Ads Network z zapośredniczeniem

Wybierz platformę: Android Nowy Android iOS Unity Flutter

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads Unity Plugin wczytywać i wyświetlać reklamy z sieci LY Ads Network przy użyciu zapośredniczenia, w tym integracji kaskadowych. Wyjaśnia, jak dodać sieć LY Ads Network do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter sieci 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
Wodospad
Formaty
Baner
Pełnoekranowa
Z nagrodą

Wymagania

  • Nowości na kanale Google Mobile Ads Unity Plugin
  • Unity 4 lub nowsza
  • [W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w określaniu stawek, użyj wtyczki do mediacji w reklamach mobilnych Google dla pakietu SDK sieci reklamowej LY Ads w wersji 1.5.0 lub nowszej (zalecana jest najnowsza wersja).
  • Wdrażanie na Androidzie
    • Android w wersji 23 lub nowszej
  • Wdrażanie na iOS
    • iOS w wersji 13.3 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 Ads Network.

Dodawanie nowej aplikacji

Przejdź na 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 Miejsce reklamowe kliknij Dodaj.

Dodaj boks

Wypełnij formularz, aby podać szczegóły dotyczące miejsca. W sekcji Rodzaj 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 miejsca docelowego.

Szczegóły przedziału

Po utworzeniu pierwszego miejsca reklamowego kliknij Sprawdź na stronie szczegółów aplikacji, aby uzyskać zgodę sieci reklamowej LY. 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ę Zarządzanie kluczami interfejsu API raportowania i kliknij przycisk Utwórz klucz interfejsu API.

Karta Klucz API 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

Authorized Sellers for Apps (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 dla usługi Ad Manager.

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

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.

Krok 3. Zaimportuj pakiet SDK i adapter sieci reklamowej LY

OpenUPM-CLI

Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę do mediacji sieci reklamowych LY Ads 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 o ograniczonym zakresie) dodaj OpenUPM jako rejestr o ograniczonym zakresie, podając te informacje:

  • 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 kliknij My Registries (Moje rejestry).

Rejestry Unity

Wybierz pakiet Google Mobile Ads Line Mediation i kliknij Zainstaluj.

Instalowanie z OpenUPM

Pakiet Unity

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla sieci reklamowej LY Ads z linku do pobierania w dzienniku zmian i wyodrębnij plik GoogleMobileAdsLineMediation.unitypackage z pliku ZIP.

W edytorze projektu Unity wybierz Assets (Zasoby) > Import Package (Importuj pakiet) > Custom Package (Własny pakiet) i znajdź pobrany plik GoogleMobileAdsLineMediation.unitypackage. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.

Importowanie z Unity

Następnie wybierz Assets (Zasoby) > External Dependency Manager (Menedżer zależności zewnętrznych) > Android Resolver (Rozwiązywanie zależności w Androidzie) > Force Resolve (Wymuś rozwiązanie). Biblioteka External Dependency Manager od nowa rozwiąże zależności i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android w aplikacji Unity.

Wymuś rozwiązanie

Krok 4. Dodaj wymagany kod

Android

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

iOS

Integracja z 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 zarejestrowano urządzenie testowe w Ad Managerze.

Weryfikowanie reklam testowych

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

Kroki opcjonalne:

Parametry dotyczące sieci

Wtyczka zapośredniczenia LY Ads Network Unity 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 w reklamach banerowych, pełnoekranowych i z nagrodą.

Oto przykład kodu, który pokazuje, jak utworzyć żądanie reklamy z ustawionymi 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 LY Ads Network, 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 specyficzny dla pakietu SDK. Więcej informacji znajdziesz w dokumentacji sieci reklamowej LY Ads Network.
101 com.google.ads.mediation.line Brak identyfikatora aplikacji lub jest on nieprawidłowy.
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 ani reklamy z nagrodą z powodu braku kontekstu działania.
105 com.google.ads.mediation.line Pakiet SDK sieci 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 brakujących komponentów.

iOS

Kod błędu Domena Przyczyna
1-10 Wysyłane przez pakiet SDK LY Ads Network Pakiet SDK sieci reklamowej LY Ads Network 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 miejsca).
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.

Historia zmian wtyczki zapośredniczenia Line Unity

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 polegający na tym, że instalacja za pomocą OpenUPM powodowała nieprawidł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