Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam Line za pomocą zapośredniczenia obejmującego integracje kaskadowe. Dowiesz się z niego, jak dodać element Line do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK Line i adapter z aplikacją w Unity.
Obsługiwane integracje i formaty reklam
AdMob Adapter zapośredniczenia do Lineu zapewnia te możliwości:
Integracja | |
---|---|
Ustalanie stawek | |
Wodospad | 1 |
Formaty | |
Baner | |
Pełnoekranowa | |
Otrzymano |
1 Integracja Waterfall jest w otwartej wersji beta.
Wymagania
- Unity 4 lub nowsza
- Najnowszy pakiet SDK do reklam mobilnych Google
- Aby wdrożyć to na Androidzie:
- Interfejs API Androida na poziomie 21 lub wyższym
- Aby wdrożyć w iOS:
- Cel wdrożenia iOS w wersji 12.0 lub nowszej
- Działający projekt w Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
- Wykonaj czynności opisane w przewodniku dla początkujących zapośredniczenia
Krok 1. Skonfiguruj konfiguracje w interfejsie Line
Zaloguj się na konto Line.
Dodaj nową aplikację
Kliknij 広告枠管理 (Zarządzanie boksami reklamowymi) > 여デすア (multimedia). Następnie kliknij OPEN規作成 (Utwórz nowe).
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 przedział).
Wypełnij formularz, a następnie kliknij (登録) Zarejestruj się.
Zanotuj identyfikator przedziału.
Krok 2. Skonfiguruj oferty reklamowe AdMob w interfejsie
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 Line i adapter
Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla aplikacji Line, korzystając z linku pobierania w dzienniku zmian i wyodrębnij GoogleMobileAdsLineMediation.unitypackage
z pliku ZIP.
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 wybierz Zasoby > Program do rozpoznawania usług Google Play > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka programu do rozpoznawania nazw usług Unity Play od zera przeprowadzi analizę zależności 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 SKAdNetwork
Wykonaj instrukcje z dokumentacji Line, aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu.
Krok 5. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby AdMob.
Aby dowiedzieć się, jak włączyć reklamy testowe, postępuj zgodnie z instrukcjami podanymi w dotyczącej systemów Android i iOS
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyLine, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z Line (Waterfall) źródeł reklam.
Kroki opcjonalne:
Parametry charakterystyczne dla sieci
Wtyczka zapośredniczenia wiersza Unity obsługuje następujący 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 wiersza, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi na żądanie reklamy, używając polecenia ResponseInfo
z tych klas:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
Oto kody i powiązane z nimi komunikaty wysyłane przez adapter linii, gdy reklama nie zostaje wczytana:
Android
Kod błędu | Domena | Przyczyna |
---|---|---|
1-10 | com.five_corp.ad | Pakiet SDK Line zwrócił błąd związany z pakietem SDK. Więcej informacji znajdziesz w dokumentacji wiersza. |
101 | com.google.ads.mediation.line | Brak identyfikatora aplikacji lub jest on nieprawidłowy. |
102 | com.google.ads.mediation.line | Brak identyfikatora gniazda lub jest on nieprawidłowy. |
103 | com.google.ads.mediation.line | Żądany rozmiar reklamy nie pasuje do rozmiaru banera reklamowego obsługiwanego w wierszu. |
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 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 brakujących komponentów. |
iOS
Kod błędu | Domena | Przyczyna |
---|---|---|
1-10 | Wysłane przez Line SDK | Pakiet SDK Line zwrócił błąd związany z pakietem SDK. Więcej informacji znajdziesz w dokumentacji wiersza. |
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 pasuje do rozmiaru banera reklamowego obsługiwanego w wierszu. |
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.2.0
- Obsługuje przejściówkę linii Android w wersji 2.7.20240515.0.
- Obsługuje adapter Line iOS w wersji 2.8.20240612.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.1.
Wersja 1.1.2
- Obsługuje przejściówkę linii Android w wersji 2.7.20240515.0.
- Obsługuje adapter Line iOS w wersji 2.7.20240411.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google 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 iOS w wersji 2.7.20240411.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 1.1.0
- Dodano klasę
LineMediationExtras
z poniższymi metodami, aby obsługiwać przekazywanie dodatków do zapośredniczenia.SetEnabledAdSound(bool)
- Obsługuje przejściówkę linii Android w wersji 2.7.20240214.1.
- Obsługuje adapter Line iOS w wersji 2.7.20240318.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.0.0.
Wersja 1.0.0
- Data premiery.
- Obsługuje przejściówkę linii Android w wersji 2.6.20230607.0.
- Obsługuje adapter Line iOS w wersji 2.6.20230609.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.5.1.