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

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads SDK do wczytywania i wyświetlania reklam z sieci reklamowej LY Ads Network za pomocą zapośredniczenia AdMob, co obejmuje integracje kaskadowe. Dowiesz się z niego, jak dodać LY Ads Network do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter LY Ads Network z aplikacją na iOS.

Obsługiwane integracje i formaty reklam

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

Integracja
Określanie stawek
Kaskada
Formaty
Baner
Pełnoekranowa
Z nagrodą
Rodzimy użytkownik

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

iOS w wersji 13.0 lub nowszej.
[W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w ramach określania stawek, użyj adaptera sieci reklamowej LY w wersji 2.8.20240827.0 lub nowszej (zalecamy najnowszą wersję).

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 Sieć reklamowa.

Dodawanie nowej aplikacji

Otwórz kartę App (Aplikacja) i kliknij przycisk New registration (Nowa rejestracja).

Nowa rejestracja

Wypełnij formularz i kliknij Rejestracja.

Nowy formularz rejestracyjny

Zanotuj App ID (Identyfikator aplikacji).

Szczegółowe informacje na temat rejestracji

Tworzenie boksu reklamowego

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

Dodaj boks

Wypełnij formularz, aby uzyskać szczegółowe informacje o miejscu. W sekcji Typ określania stawek wybierz Standardowe, aby skonfigurować ten boks na potrzeby zapośredniczenia kaskadowego, lub Określanie stawek przez pakiet SDK Google, aby skonfigurować ten boks na potrzeby określania stawek. Po wypełnieniu formularza kliknij Utwórz.

Formularz dodawania boksu

Zanotuj identyfikator boksu.

Szczegóły boksu

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

Poproś o sprawdzenie

Tworzenie klucza interfejsu API raportowania

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 API do raportowania

Zapisz identyfikator klucza interfejsu API i klucz tajny interfejsu API.

Formularz klucza interfejsu API do raportowania

Zaktualizuj plik app-ads.txt

Authorized Sellers for Apps (czyli plik 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 nie masz pliku app-ads.txt, skonfiguruj go pod kątem swojej aplikacji.

Aby wdrożyć app-ads.txt w przypadku sieci reklamowej LY, zapoznaj się z artykułem Informacje o pliku app-ads.txt.

Krok 2. Skonfiguruj w interfejsie AdMob źródła ofert reklamowych z sieci reklamowej LY Ads Network

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać LY Ads Network do konfiguracji zapośredniczenia jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie sieci reklamowej LY Ads Network 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 nazwę grupie 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ą z istniejących jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny być teraz widoczne wybrane przez Ciebie jednostki reklamowe:

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

Określanie stawek

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

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

Kliknij Potwierdź i wyraź zgodę, a następnie Dalej.

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

Następnie wpisz identyfikator aplikacji i identyfikator boksu uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Kaskada

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

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

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 boksu uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Uwaga: optymalizacja źródła reklam potrzebuje kilku dni na zebranie wystarczającej ilości danych, aby dokładnie obliczyć eCPM dla 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 będzie można obliczyć eCPM, źródło reklam automatycznie zacznie aktualizować eCPM w Twoim imieniu.

Krok 3. Zaimportuj pakiet SDK i adapter sieci reklamowej LY Ads

Zalecane: użyj Swift Package Managera

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

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

W Xcode kliknij File (Plik) > Add Package Dependencies… (Dodaj zależności pakietów…).

W wyświetlonym oknie 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.

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK sieci reklamowej LY i połącz FiveAd.framework w projekcie.
Pobierz najnowszą wersję adaptera sieci reklamowej LY Ads, korzystając z linku do pobrania w liście zmian, i połącz LineAdapter.framework ze swoim projektem.

Używanie CocoaPods

Dodaj do pliku Podfile projektu ten wiersz:

pod 'GoogleMobileAdsMediationLine'

W wierszu poleceń uruchom:

pod install --repo-update

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 Ads Network.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

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

Adapter sieci reklamowej LY Ads Network zawiera metodę pomocniczą, która umożliwia włączenie trybu testowego w sieci reklamowej LY Ads Network. Tę opcję musisz ustawić przed zainicjowaniem Google Mobile Ads SDK, aby mieć pewność, że dane będą prawidłowo przekazywane do pakietu SDK sieci reklamowej LY.

Swift

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

Objective-C

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

GADMediationAdapterLine.testMode = YES;

Sprawdzanie 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 reklamowej LY Ads obsługuje dodatkowy parametr żądania, który można przekazać do adaptera za pomocą klasy GADMediationAdapterLineExtras. Ta klasa obejmuje te właściwości:

adAudio: Określa domyślny stan początkowy dźwięku w banerach reklamowych, reklamach pełnoekranowych i reklamach 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 sieci reklamowej LY Ads wypełnia te pola zaawansowanych reklam natywnych w przypadku GADNativeAd.

Pole	Zasoby zawsze uwzględniane przez adapter sieci reklamowej LY Ads
Nagłówek
Obraz
Treść
Ikona aplikacji	¹.
Wezwanie do działania
Ocena w gwiazdkach
Sklep
Cena

¹ W przypadku reklam natywnych pakiet SDK sieci reklamowej LY nie udostępnia zasobu 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 Ads Network, możesz sprawdzić błąd w odpowiedzi na żądanie reklamy, korzystając z metody GADResponseInfo.adNetworkInfoArray w tych klasach:

GADMediationAdapterLine

Oto kody i powiązane z nimi komunikaty, które adapter sieci reklamowej LY Ads Network wyświetla, gdy nie uda się wczytać reklamy:

Kod błędu	Domena	Przyczyna
1-10	Wysłane przez pakiet SDK sieci reklamowej LY	Pakiet SDK sieci LY Ads Network zwrócił błąd związany z pakietem SDK. Więcej informacji znajdziesz w dokumentacji sieci reklamowej LY Ads.
101	com.google.ads.mediation.line	Nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub identyfikatora boksu).
102	com.google.ads.mediation.line	Żądany rozmiar reklamy nie pasuje do rozmiaru banera reklamowego obsługiwanego przez sieć reklamową LY Ads Network.
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 do ładowania reklam pakietu SDK LINE Ads.