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 pakietu Line do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera Line z aplikacją Unity.
Obsługiwane integracje i formaty reklam
Ad Manager Adapter zapośredniczenia dla aplikacji Line umożliwia:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | 1 |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą |
1 Integracja z metodą kaskadową jest dostępna w ramach zamkniętych testów beta. Aby uzyskać dostęp, skontaktuj się z menedżerem konta.
Wymagania
- Unity w wersji 4 lub nowszej
- 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 Ad Manager 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
Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla Line za pomocą linku do pobrania w Changelog i rozpakujGoogleMobileAdsLineMediation.unitypackage
plik zip.
W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Własny pakiet i znajdź pobrany plik GoogleMobileAdsLineMediation.unitypackage
. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Następnie kliknij Zasoby > Rozwiązywanie problemów z usługami Play > Rozwiązywanie problemów z Androidem > Wymuś rozwiązanie. Biblioteka Resolver usług Play w Unity wykona rozwiązywanie zależności od podstaw i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
aplikacji w 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 towarzyszące im 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.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.