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 do platformy Line ma te funkcje:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | 1. |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą |
1. Integracja kaskadowa jest w otwartej wersji beta.
Wymagania
- Unity w wersji 4 lub nowszej
- Najnowszy pakiet SDK do reklam mobilnych Google
- Do wdrożenia na Androidzie
- Interfejs API Androida na poziomie 21 lub wyższym
- 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. Zobacz Rozpocznij, aby dowiedzieć się więcej.
- Wykonaj czynności opisane w przewodniku dla początkujących zapośredniczenia
Krok 1. Skonfiguruj konfiguracje w interfejsie Line
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 do reklam mobilnych Google dla linii
klikając link pobierania w
Historia zmian i wyodrębnienie
GoogleMobileAdsLineMediation.unitypackage
z pliku 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.
Potem kliknij Komponenty > Program do rozpoznawania usług Google Play > Program do rozpoznawania Androida >
Wymuś rozwiązanie. Biblioteka programu do rozpoznawania usług Unity Play
rozpoznania zależności od zera i skopiuj zadeklarowane zależności do
Katalog Assets/Plugins/Android
Twojej aplikacji w Unity.
Krok 4. Dodaj wymagany kod
Android
Integracja wiersza nie wymaga dodatkowego kodu.
iOS
Integracja SKAdNetwork
Postępuj zgodnie z dokumentacją 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 specyficzne dla sieci
Wtyczka zapośredniczenia Line Unity obsługuje poniższe dodatkowe żądanie
, który można przekazać do adaptera za pomocą funkcji LineMediationExtras
zajęcia:
SetEnableAdSound(boolean)
: określa domyślny stan rozpoczęcia odtwarzania 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 towarzyszące im komunikaty wysyłane przez adapter Line, gdy nie można załadować reklamy:
Android
Kod błędu | Domena | Przyczyna |
---|---|---|
1-10 | com.five_corp.ad | Pakiet SDK Line zwrócił błąd związany z pakietem SDK. Zobacz Dokumentacja wiersza . |
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 slotu. |
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. Zobacz Dokumentacja 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 ikony informacji w reklamie 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 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 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 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 na 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.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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 adapter Line na Androida 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 Androida w wersji 2.6.20230607.0.
- Obsługuje adapter Line 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.