Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Line za pomocą zapośredniczenia, w tym integracji kaskadowych. Przewodnik zawiera informacje o dodawaniu Line do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera Line z aplikacją Unity.
Obsługiwane integracje i formaty reklam
AdMob Adapter zapośredniczenia dla aplikacji Line umożliwia:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | 1 |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą |
1 Integracja kaskadowa jest dostępna w otwartej wersji beta.
Wymagania
- Unity 4 lub nowsza
- Najnowsza wersja pakietu SDK do reklam mobilnych Google
- Aby wdrożyć na Androidzie:
- poziom interfejsu API 21 lub nowszy,
- Aby wdrożyć aplikację na iOS:
- docelowa wersja iOS 12.0 lub nowsza
- działający projekt Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
- Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia.
Krok 1. Skonfiguruj konfiguracje w interfejsie Line
Zaloguj się na konto Line.
Dodawanie nowej aplikacji
Kliknij 広告枠管理 (Zarządzanie boksami reklamowymi) > メディア (Media). Następnie kliknij 新規作成 (Utwórz nowy).
Wypełnij formularz i kliknij 登録 (Zarejestruj).
Zanotuj identyfikator aplikacji.
Tworzenie miejsca docelowego reklamy
Kliknij identyfikator aplikacji, do której chcesz dodać miejsce docelowe reklamy. Następnie wybierz 詳細 (Szczegóły).
Kliknij スロット 追加 (Dodaj slot).
Wypełnij formularz i kliknij (登録) Register.
Zapisz identyfikator slotu.
Krok 2. Skonfiguruj zapotrzebowanie na usługi w AdMob UI
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym Android.
iOS
Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym iOS.
Krok 3. Zaimportuj pakiet SDK i adapter Line
OpenUPM-CLI
Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę Google Mobile Ads Line Mediation Plugin for Unity, uruchamiając to polecenie w katalogu głównym projektu:
openupm add com.google.ads.mobile.mediation.line
OpenUPM
W edytorze projektu Unity wybierz Edytuj > Ustawienia projektu > 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
- Adres URL:
https://package.openupm.com
- Zakres:
com.google
Następnie kliknij Okno > Menedżer pakietów, aby otworzyć Menedżera pakietów Unity, a potem w menu kliknij Moje rejestry.
Wybierz pakiet Google Ads – zapobieganie podwójnemu wyświetlaniu reklam w mobilnych i kliknij Zainstaluj.
Pakiet Unity
Pobierz najnowszą wersję wtyczki Google Mobile Ads do pośredniczenia w przypadku Line z linku do pobrania w Changelog i rozpakuj plik zipGoogleMobileAdsLineMediation.unitypackage
.
W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsLineMediation.unitypackage
. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Następnie kliknij Zasoby > Menedżer zależności zewnętrznych > Rozwiązanie Androida > Wymuś rozwiązanie. Biblioteka menedżera zależności zewnętrznej wykona rozwiązanie zależności od podstaw i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
Twojej aplikacji Unity.
Krok 4. Dodaj wymagany kod
Android
Integracja z Line nie wymaga dodatkowego kodu.
iOS
Integracja z SKAdNetwork
Aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu, postępuj zgodnie z dokumentacją Line.
Krok 5. Przetestuj implementację
Włączanie reklam testowych
Pamiętaj, aby zarejestrować urządzenie testowe w AdMob.
Postępuj zgodnie z instrukcjami w dokumentacji Line na Android i iOS, aby włączyć reklamy testowe w Line.
Weryfikowanie reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z Line, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając z źródeł reklam Line (kaskada).
Kroki opcjonalne:
Parametry związane z siecią
Wtyczka zapośredniczenia Line 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 włączenia dźwięku w banerach, reklamach pełnoekranowych i reklamach z nagrodą.
Oto przykład kodu, 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 Line, wydawcy mogą sprawdzić błąd w odpowiedzi reklamy, korzystając z ResponseInfo
w ramach tych klas:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
Oto kody i odpowiednie komunikaty generowane przez adapter Line, gdy nie udaje się załadować pliku:
Android
Kod błędu | Domena | Przyczyna |
---|---|---|
1-10 | com.five_corp.ad | Pakiet SDK usługi Line zwrócił błąd specyficzny dla tego pakietu. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją Line. |
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 slotu. |
103 | com.google.ads.mediation.line | Żądany rozmiar reklamy nie odpowiada rozmiarowi banera reklamowego obsługiwanemu przez Line. |
104 | com.google.ads.mediation.line | Nie udało się załadować reklamy przejściowej ani reklamy z nagrodą z powodu braku kontekstu aktywności. |
105 | com.google.ads.mediation.line | Nie udało się wyświetlić reklamy pełnoekranowej ani reklamy z nagrodą za pomocą pakietu Line SDK. |
106 | com.google.ads.mediation.line | Nie udało się załadować reklamy natywnej z powodu braku komponentów. |
iOS
Kod błędu | Domena | Przyczyna |
---|---|---|
1-10 | Wysłano za pomocą pakietu Line SDK | Pakiet SDK usługi Line zwrócił błąd specyficzny dla tego pakietu. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją Line. |
101 | com.google.ads.mediation.line | nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub identyfikatora slotu); |
102 | com.google.ads.mediation.line | Żądany rozmiar reklamy nie odpowiada rozmiarowi banera reklamowego obsługiwanemu przez Line. |
103 | com.google.ads.mediation.line | Nie udało się wczytać komponentu z obrazem ikony informacji w reklamie natywnej. |
Historia zmian wtyczki zapośredniczenia reklam Line Unity
Wersja 1.4.0
- Obsługuje adapter Line na Androida w wersji 2.8.20240827.0.
- Obsługuje adapter Line na iOS w wersji 2.9.20241106.1.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.4.0.
Wersja 1.3.1
- Obsługuje adapter Line na Androida w wersji 2.8.20240808.0.
- Obsługuje adapter Line na iOS w wersji 2.8.20240612.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.2.0.
Wersja 1.3.0
- Obsługuje adapter Line na Androida w wersji 2.8.20240722.0.
- Obsługuje adapter Line na iOS w wersji 2.8.20240612.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.2.0.
Wersja 1.2.0
- Obsługuje adapter Line na Androida w wersji 2.7.20240515.0.
- Obsługuje adapter Line na iOS w wersji 2.8.20240612.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.1.1.
Wersja 1.1.2
- Obsługuje adapter Line na Androida w wersji 2.7.20240515.0.
- Obsługuje adapter Line na iOS w wersji 2.7.20240411.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.1.0.
Wersja 1.1.1
- Obsługuje adapter Line na Androida w wersji 2.7.20240214.1.
- Obsługuje adapter Line na iOS w wersji 2.7.20240411.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.1.0.
Wersja 1.1.0
- Dodaliśmy klasę
LineMediationExtras
z tymi metodami, aby umożliwić przekazywanie dodatkowych informacji zapośredniczenia.SetEnabledAdSound(bool)
- Obsługuje adapter Line na Androida w wersji 2.7.20240214.1.
- Obsługuje adapter Line na iOS w wersji 2.7.20240318.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.0.0.
Wersja 1.0.0
- Pierwsza wersja.
- Obsługuje adapter Line na Androida w wersji 2.6.20230607.0.
- Obsługuje adapter Line na iOS w wersji 2.6.20230609.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.5.1.