Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z elementu zamówienia liniowego z wykorzystaniem zapośredniczenia w zakresie integracji kaskady. Opisano w nim, jak dodać wiersz do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter wiersza z aplikacją iOS .
Interfejs panelu wiersza poleceń zawiera etykiety, przyciski i opisy w języku japońskim. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak tłumaczone z angielskimi odpowiednikami w nawiasach.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia AdMob dotyczący linii ma te możliwości:
| Integracja | |
|---|---|
| Ustalanie stawek | |
| Wodospad | 1 |
| Formaty | |
| Baner | |
| Pełnoekranowa | |
| Otrzymano | |
| Natywna | |
1 Integracja kaskadowa znajduje się w otwartej wersji beta.
Wymagania
- Wartość docelowa wdrożenia iOS w wersji 12.0 lub nowszej
Najnowszy pakiet SDK do reklam mobilnych Google
Skorzystaj z zapośredniczenia Wprowadzenie
Krok 1. Skonfiguruj konfiguracje w interfejsie wiersza
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 żądania liniowe w AdMob interfejsie użytkownika
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 Line SDK 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ę pakietu SDK Line i umieść w swoim projekcie link
FiveAd.framework. - Pobierz najnowszą wersję adaptera liniowego, korzystając z linku do pobierania w historii zmian, i umieść link
LineAdapter.frameworkw swoim projekcie.
Krok 4. Dodaj wymagany kod
Integracja SKAdNetwork
Wykonaj dokumentację Lineu, 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 specyficzne dla sieci
Adapter liniowy obsługuje dodatkowy parametr żądania, który można przekazać do adaptera za pomocą klasy GADMediationAdapterLineExtras. Ta klasa zawiera te właściwości:
adAudio- Określa domyślny dźwięk początkowy banerów, reklam pełnoekranowych i reklam z nagrodą.
Oto przykład kodu, który pokazuje, jak utworzyć żądanie reklamy ustawiające te parametry:
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 zaawansowanych pól reklam natywnych
elementów
GADNativeAd
| Pole | Zasoby zawsze uwzględnione przez adapter liniowy |
|---|---|
| Nagłówek | |
| Obraz | |
| Treść | |
| Ikona aplikacji | 1 |
| Wezwanie do działania | |
| Ocena w gwiazdkach | |
| Sklep | |
| Cena |
1 W przypadku reklam natywnych pakiet SDK linii nie zawiera komponentu z ikoną aplikacji. Zamiast tego adapter wypełnia ikonę aplikacji przezroczystym obrazem.
Kody błędów
Jeśli adapter nie otrzyma reklamy z wiersza, możesz sprawdzić podstawowy błąd w odpowiedzi reklamy, używając właściwości
GADResponseInfo.adNetworkInfoArray
w ramach tych zajęć:
GADMediationAdapterLine
Oto kody i powiązane z nimi komunikaty wysyłane przez adapter liniowy, gdy nie można wczytać reklamy:
| Kod błędu | Domena | Przyczyna |
|---|---|---|
| 1-10 | com.five_corp.ad | Pakiet SDK linii zwrócił błąd związany z pakietem SDK. Więcej informacji znajdziesz w dokumentacji linii. |
| 101 | com.google.ads.mediation.line | Brak identyfikatora aplikacji lub jest on nieprawidłowy. |
| 102 | com.google.ads.mediation.line | Brak identyfikatora przedziału lub jest on nieprawidłowy. |
| 103 | com.google.ads.mediation.line | Żądany rozmiar reklamy nie pasuje do rozmiaru banera reklamowego obsługiwanego przez wiersze. |
| 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 linii nie wyświetlił reklamy pełnoekranowej ani reklamy z nagrodą. |
| 106 | com.google.ads.mediation.line | Nie udało się wczytać reklamy natywnej z powodu braku komponentów. |
| 1-10 | Wysłane przez Line SDK | Pakiet SDK linii zwrócił błąd związany z pakietem SDK. Więcej informacji znajdziesz w dokumentacji linii. |
| 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 przez wiersze. |
| 103 | com.google.ads.mediation.line | Nie udało się wczytać w reklamie natywnej komponentu z obrazem ikony informacji. |
Historia zmian adaptera zapośredniczenia w iOS LINE
Wersja 2.7.20240214.1
- Teraz wymagany jest iOS w wersji co najmniej 12.0.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 11.0 lub nowszej.
- Uwzględniono
Info.plistw ramach platformyLineAdapter.xcframework.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
- FiveAd SDK w wersji 2.7.20240214.
Wersja 2.7.20240214.0
- Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.7.20240214.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
- FiveAd SDK w wersji 2.7.20240214.
Wersja 2.7.20240126.0
- Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.7.20240126.
- Zaktualizowano implementację adaptera o nowe protokoły przekazywania dostępu do pakietu SDK FiveAd.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
- FiveAd SDK w wersji 2.7.20240126.
Wersja 2.7.20231115.0
- Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.7.20231115.
- Do mapy modułów dodano nagłówek
GADMediationAdapterLineExtras.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
- FiveAd SDK w wersji 2.7.20231115.
Wersja 2.6.20230609.1
- Dodano
GADMediationAdapterLineAudioStatew celu zarządzania początkowym stanem dźwięku banera, reklamy pełnoekranowej i reklamy z nagrodą przy pierwszym wyświetleniu.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
- FiveAd SDK w wersji 2.6.20230609.
Wersja 2.6.20230609.0
- Pierwsza wersja!
- Dodaliśmy obsługę kaskady w przypadku formatów banerów, reklam pełnoekranowych, reklam z nagrodą i reklam natywnych.
- Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.6.20230609.
Stworzone i przetestowane w:
- Pakiet SDK do reklam mobilnych Google w wersji 10.9.0.
- FiveAd SDK w wersji 2.6.20230609.