Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Integrowanie LY Ads Network z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads SDK wczytywać i wyświetlać reklamy z sieci LY Ads Network przy użyciu zapośredniczenia AdMob, w tym integracji kaskadowych. Wyjaśnia, jak dodać sieć reklamową LY Ads Network do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter sieci reklamowej LY Ads Network z aplikacją na iOS.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia dla LY Ads Network ma te możliwości:

Integracja
Określanie stawek
Kaskada
Formaty
Baner
Pełnoekranowa
Z nagrodą
Natywna

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź, czy:

iOS w wersji 13.0 lub nowszej.
[W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam z określaniem stawek, użyj adaptera sieci reklam LY w wersji 2.8.20240827.0 lub nowszej (zalecana jest najnowsza wersja).

Najnowsza wersja Google Mobile Ads SDK.
Skonfiguruj zapośredniczenie AdMob.

Krok 1. Skonfiguruj ustawienia w interfejsie sieci reklamowej LY

Zarejestruj się i zaloguj na konto LY Ads Network.

Dodawanie nowej aplikacji

Otwórz kartę Aplikacja i kliknij przycisk Nowa rejestracja.

Nowa rejestracja

Wypełnij formularz i kliknij rejestracja.

Nowy formularz rejestracji

Zapisz identyfikator aplikacji.

Szczegółowe informacje na temat rejestracji

Tworzenie boksu reklamowego

Na karcie Aplikacja wybierz aplikację, aby wyświetlić jej szczegóły. W sekcji Miejsce reklamowe kliknij Dodaj.

Dodaj boks

Wypełnij formularz, aby podać szczegóły dotyczące miejsca docelowego. W sekcji Typ określania stawek wybierz Standardowe, aby skonfigurować ten slot pod kątem zapośredniczenia kaskadowego, lub Określanie stawek przez pakiet SDK Google, aby skonfigurować ten slot pod kątem określania stawek. Po wypełnieniu formularza kliknij Utwórz.

Dodawanie formularza boksu

Zanotuj identyfikator slota.

Szczegóły boksu

Po utworzeniu pierwszego miejsca reklamowego kliknij Sprawdź na stronie z informacjami o aplikacji, aby uzyskać zgodę od sieci reklamowej LY Ads Network. Może to chwilę potrwać. Jeśli masz pytania, skontaktuj się z przedstawicielem sieci reklamowej LY Ads.

Poproś o sprawdzenie

Tworzenie klucza interfejsu Reporting API

Otwórz kartę Zarządzanie kluczami interfejsu API do raportowania i kliknij przycisk Utwórz klucz interfejsu API.

Karta klucza interfejsu API do raportowania

Wypełnij formularz i kliknij Zapisz.

Formularz klucza interfejsu Reporting API

Zanotuj identyfikator klucza interfejsu API i klucz tajny interfejsu API.

Formularz klucza interfejsu Reporting API

Aktualizowanie pliku app-ads.txt

Plik Authorized Sellers for Apps app-ads.txt to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze tego nie zrobiono, skonfiguruj plik app-ads.txt pod kątem aplikacji.

Aby zaimplementować app-ads.txt w przypadku LY Ads Network, zapoznaj się z artykułem Informacje o pliku app-ads.txt.

Krok 2. Skonfiguruj popyt sieci LY Ads w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać LY Ads Network do konfiguracji mediacji w przypadku jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediacja. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie sieci LY Ads jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.

Wpisz format reklamy i platformę, a potem kliknij Dalej.

Nadaj grupie zapośredniczenia nazwę 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ą z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Powinna się teraz wyświetlić karta jednostek reklamowych z wybranymi przez Ciebie jednostkami:

Dodawanie LY Ads Network jako źródła reklam

Określanie stawek

W sekcji Źródła reklam odszukaj kartę Ustalanie stawek i kliknij Dodaj źródło reklam. Następnie wybierz LY Ads Network.

Kliknij Jak podpisać umowę partnerską i skonfiguruj partnerstwo w zakresie określania stawek z siecią reklamową LY Ads Network.

Kliknij Potwierdzam i akceptuję, a potem Kontynuuj.

Jeśli masz już mapowanie dla LY Ads Network, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz Identyfikator aplikacji i Identyfikator miejsca na reklamę uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Kaskada

Na karcie Kaskadowe w sekcji Źródła reklam kliknij Dodaj źródło reklam.

Wybierz LY Ads Network i włącz przełącznik Optymalizuj. Aby skonfigurować optymalizację źródeł reklam w LY Ads Network, wpisz identyfikator klucza interfejsu API i klucz tajny interfejsu API uzyskane w poprzedniej sekcji. Następnie wpisz wartość eCPM dla sieci LY Ads Network i kliknij Dalej.

Jeśli masz już mapowanie dla sieci reklamowej LY, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz Identyfikator aplikacji i Identyfikator miejsca uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Uwaga: optymalizacja źródła reklam wymaga kilku dni na zebranie wystarczającej ilości danych do dokładnego obliczenia eCPM w przypadku sieci zapośredniczenia. W tym czasie stan optymalizacji źródła reklam to PENDING, więc musisz ręcznie ustawić wartość eCPM dla sieci. Gdy eCPM będzie można obliczyć, źródło reklam automatycznie zacznie aktualizować eCPM w Twoim imieniu.

Krok 3. Zaimportuj pakiet SDK i adapter LY Ads Network

Korzystanie z Swift Package Manager

Zanim przejdziesz dalej, musisz mieć minimalną obsługiwaną wersję adaptera: 2.9.20251119.

Aby dodać zależność pakietu do projektu, wykonaj te czynności:

W Xcode kliknij kolejno File (Plik) > Add Package Dependencies... (Dodaj zależności pakietu…).

W wyświetlonym wierszu poleceń wyszukaj ten adres URL pakietu:

https://github.com/googleads/googleads-mobile-ios-mediation-line.git

W sekcji Reguła zależności wybierz Gałąź.
W polu tekstowym wpisz main.

Korzystanie z CocoaPods

Dodaj do pliku Podfile projektu ten wiersz:

pod 'GoogleMobileAdsMediationLine'

W wierszu poleceń uruchom:

pod install --repo-update

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK sieci reklamowej LY Ads i połącz go z projektemFiveAd.framework.
Pobierz najnowszą wersję adaptera LY Ads Network z linku do pobierania w sekcji Dziennik zmian i połącz LineAdapter.framework w projekcie.

Krok 4. Dodaj wymagany kod

Wdrażanie SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją sieci reklamowej LY.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob.

Adapter LY Ads Network zawiera metodę pomocniczą, która umożliwia włączenie trybu testowego w przypadku LY Ads Network. Musisz ustawić tę opcję przed zainicjowaniemGoogle Mobile Ads SDK, aby mieć pewność, że zostaną one prawidłowo przekazane do pakietu SDK sieci reklamowej LY.

Swift

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

Objective-C

#import <LineAdapter/LineAdapter.h>
// ...

GADMediationAdapterLine.testMode = YES;

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z sieci LY Ads Network, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając ze źródeł reklam LY Ads Network.

Kroki opcjonalne:

Parametry dotyczące sieci

Adapter sieci LY Ads 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 stan dźwięku na początku odtwarzania banerów, reklam pełnoekranowych i reklam z nagrodą.

Oto przykład kodu, który pokazuje, jak utworzyć żądanie reklamy z ustawionymi 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 sieci reklamowej LY Ads Network wypełnia te opisy zaawansowanych reklam natywnych w przypadku GADNativeAd.

Pole	Komponenty zawsze dołączane przez adapter LY Ads Network
Nagłówek
Obraz
Treść
Ikona aplikacji	¹.
Wezwanie do działania
Ocena w gwiazdkach
Sklep
Cena

¹ W przypadku reklam natywnych pakiet SDK sieci LY Ads nie udostępnia ikony aplikacji. Zamiast tego adapter sieci reklamowej LY Ads wypełnia ikonę aplikacji przezroczystym obrazem.

Kody błędów

Jeśli adapter nie otrzyma reklamy z sieci reklamowej LY, możesz sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z GADResponseInfo.adNetworkInfoArray w tych klasach:

GADMediationAdapterLine

Oto kody i komunikaty wyświetlane przez adapter LY Ads Network w przypadku niepowodzenia wczytania reklamy:

Kod błędu	Domena	Przyczyna
1-10	Wysyłane przez pakiet SDK LY Ads Network	Pakiet SDK sieci reklamowej LY zwrócił błąd specyficzny dla pakietu SDK. Więcej informacji znajdziesz w dokumentacji sieci reklamowej LY Ads Network.
101	com.google.ads.mediation.line	Nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub identyfikatora miejsca).
102	com.google.ads.mediation.line	Żądany rozmiar reklamy nie pasuje do rozmiaru banera reklamowego obsługiwanego przez sieć LY Ads.
103	com.google.ads.mediation.line	Nie udało się wczytać komponentu z obrazem ikony informacji w reklamie natywnej.
104	com.google.ads.mediation.line	Nie udało się zebrać sygnałów na potrzeby określania stawek.
105	com.google.ads.mediation.line	Nie udało się zainicjować modułu wczytywania reklam pakietu SDK do reklam LINE.