Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z linii wykorzystującej kolumnę Zapośredniczenie AdMob, na temat integracji kaskadowych. Omawiamy sposób dodawania linii do konfiguracji zapośredniczenia i integracji pakietu SDK Line i adaptera aplikację iOS .
Etykiety w interfejsie wiersza są zapisane w języku japońskim, przyciski i opisy. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. Jednak w opisach i instrukcjach tego przewodnika etykiety i przyciski są przetłumaczone z odpowiednimi odpowiednikami w języku angielskim w nawiasach.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia na potrzeby linii ma te funkcje:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | 1. |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Natywna |
1. Integracja kaskadowa jest w otwartej wersji beta.
Wymagania
- Cel wdrożenia iOS w wersji 12.0 lub nowszej
Najnowszy pakiet SDK do reklam mobilnych Google
Dokończ zapośredniczenie Przewodnik dla początkujących
Krok 1. Skonfiguruj konfiguracje w interfejsie Line
Krok 2. Skonfiguruj oferty reklamowe AdMob w interfejsie
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Musisz dodać Line do konfiguracji zapośredniczenia jednostki reklamowej.
Najpierw zaloguj się na swoje konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź od razu do sekcji Dodawanie Line jako źródła reklam.
Aby utworzyć nową grupę zapośredniczenia, wybierz Utwórz grupę zapośredniczenia.
Podaj format reklamy i platformę, a następnie kliknij Dalej.
Nazwij grupę zapośredniczenia i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.
Powiąż tę grupę zapośredniczenia z co najmniej jedną istniejącą jednostką reklamowąAdMob . Następnie kliknij Gotowe.
Na karcie jednostek reklamowych powinny się pojawić wybrane przez Ciebie jednostki reklamowe:
Dodaj Line jako źródło reklam
Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklamy. Następnie kliknij Line.
Kliknij Line. Następnie wpisz wartość eCPM dlaLine i kliknij Dalej.Jeśli masz już mapowanie Line, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.
Następnie wpisz dane Application ID and Slot IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.
Krok 3. Zaimportuj pakiet SDK Line i adapter
Używanie CocoaPods (zalecane)
Dodaj ten wiersz do pliku Podfile projektu:
pod 'GoogleMobileAdsMediationLine'
W wierszu poleceń:
pod install --repo-update
Integracja ręczna
- Pobierz najnowszą wersję Line
Pakiet SDK i link
FiveAd.framework
w projekcie. - Pobierz najnowszą wersję adaptera Lines, klikając link pobierania w
Historia zmian i
połącz projekt
LineAdapter.framework
w swoim projekcie.
Krok 4. Dodaj wymagany kod
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 dokumentacji linii
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
Adapter liniowy obsługuje dodatkowy parametr żądania, który można przekazać
z adapterem za pomocą klasy GADMediationAdapterLineExtras
. Te zajęcia
zawiera te właściwości:
adAudio
- Określa domyślny stan początkowy dźwięku banera, reklamy pełnoekranowej i reklamy pełnoekranowej reklam z nagrodą.
Oto przykładowy kod, który pokazuje, jak utworzyć żądanie reklamy z tymi parametrami:
Swift
import LineAdapter
// ...
let request = GADRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)
Objective-C
#import <LineAdapter/LineAdapter.h>
// ...
GADRequest *request = [GADRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];
Korzystanie z reklam natywnych
Renderowanie reklam
Adapter liniowy wypełnia te
Opisy pól w zaawansowanych reklamach natywnych
dla
GADNativeAd
Pole | Zasoby zawsze uwzględniane przez adapter linii |
---|---|
Nagłówek | |
Obraz | |
Treść | |
Ikona aplikacji | 1 |
Wezwanie do działania | |
Ocena w gwiazdkach | |
Sklep | |
Cena |
1 W przypadku reklam natywnych pakiet Line SDK nie zawiera komponentu z ikoną aplikacji. Zamiast tego aplikację wypełnia adapter liniowy. z przezroczystym obrazem.
Kody błędów
Jeśli adapter nie odbierze reklamy z linii, możesz sprawdzić
bazowego błędu w odpowiedzi na żądanie reklamy za pomocą funkcji
GADResponseInfo.adNetworkInfoArray
.
w następujących klasach:
GADMediationAdapterLine
Oto kody i towarzyszące im komunikaty wysyłane przez adapter Line, gdy nie można wczytać reklamy:
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 z ikoną informacji do reklamy natywnej. |
LINE Historia zmian adaptera zapośredniczenia iOS
Wersja 2.8.20240612.0
- Dodano opcję sterowania dźwiękiem w reklamie natywnej za pomocą GADVideoOptions.
- Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.8.20240612.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 11.5.0.
- Pakiet SDK FiveAd w wersji 2.8.20240612.
Wersja 2.7.20240411.0
- Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.7.20240411.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 11.3.0.
- Pakiet SDK FiveAd w wersji 2.7.20240411.
Wersja 2.7.20240318.0
- Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.7.20240318.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 11.2.0.
- Pakiet SDK FiveAd w wersji 2.7.20240318.
Wersja 2.7.20240214.1
- Teraz wymaga to systemu iOS w wersji co najmniej 12.0.
- Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 11.0 lub nowszej.
- Uwzględniono
Info.plist
w platformachLineAdapter.xcframework
.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
- Pakiet SDK FiveAd w wersji 2.7.20240214.
Wersja 2.7.20240214.0
- Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.7.20240214.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
- Pakiet SDK FiveAd w wersji 2.7.20240214.
Wersja 2.7.20240126.0
- Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.7.20240126.
- Zaktualizowaliśmy implementację adaptera, dodając nowe protokoły przekazywania dostępu do pakietu SDK FiveAd.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
- Pakiet SDK FiveAd w wersji 2.7.20240126.
Wersja 2.7.20231115.0
- Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.7.20231115.
- Uwzględniono nagłówek
GADMediationAdapterLineExtras
w mapie modułu.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
- Pakiet SDK FiveAd w wersji 2.7.20231115.
Wersja 2.6.20230609.1
- Dodano element
GADMediationAdapterLineAudioState
umożliwiający zarządzanie początkowym stanem dźwięku banera, reklamy pełnoekranowej i reklamy z nagrodą w chwili wyświetlenia.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
- Pakiet SDK FiveAd w wersji 2.6.20230609.
Wersja 2.6.20230609.0
- Pierwsza wersja!
- Dodaliśmy obsługę kaskady formatów banerów, reklam pełnoekranowych, reklam z nagrodą i reklam natywnych.
- Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.6.20230609.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 10.9.0.
- Pakiet SDK FiveAd w wersji 2.6.20230609.