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
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 nową).
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 instrukcji na Androida.
iOS
Instrukcje znajdziesz w kroku 2 przewodnika po 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 Unity Play Services Resolver wykona rozwiązanie 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 wiersza 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 Androida 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 początkowy dźwięku banerów, reklam pełnoekranowych i reklam 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 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. Więcej informacji znajdziesz w dokumentacji wiersza. |
101 | com.google.ads.mediation.line | Brakujący lub nieprawidłowy identyfikator aplikacji. |
102 | com.google.ads.mediation.line | Brak identyfikatora gniazda lub jest on nieprawidłowy. |
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 | Pakiet SDK wiersza nie wyświetlił reklamy pełnoekranowej lub reklamy z nagrodą. |
106 | com.google.ads.mediation.line | Nie udało się wczytać reklamy natywnej z powodu braku komponentów. |
iOS
Kod błędu | Domena | Przyczyna |
---|---|---|
1-10 | Wysłane przez 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 przedziału). |
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 z ikoną informacji do reklamy natywnej. |
Historia zmian wtyczki Line Unity Mediation
Wersja 1.3.1
- Obsługuje przejściówkę linii Android 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.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google 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 przejściówkę linii Android 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.
- Stworzona i przetestowana z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.5.1.