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, w tym integracji kaskadowych. 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:

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 określaniu 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.

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).

Wypełnij formularz i kliknij Rejestracja.

Zanotuj identyfikator aplikacji.

Tworzenie boksu reklamowego

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

Wypełnij formularz, aby uzyskać szczegółowe informacje o miejscu. 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.

Zanotuj identyfikator boksu.

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

Tworzenie klucza interfejsu Reporting API

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

Wypełnij formularz i kliknij Zapisz.

Zapisz identyfikator klucza interfejsu API i klucz tajny interfejsu 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 nie masz pliku app-ads.txt, utwórz go na potrzeby Ad Managera.

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 reklamowej LY w interfejsie Ad Managera

Zaloguj się na konto Ad Managera.

Dodawanie LY Ads Network do firm

Włącz udostępnianie bezpiecznych sygnałów

Udostępnianie bezpiecznych sygnałów w pytaniach o stawkę

Zezwalanie na udostępnianie bezpiecznych sygnałów na potrzeby określania stawek przez pakiet SDK

Konfigurowanie określania stawek w sieci reklamowej LY Ads

Konfigurowanie mapowania jednostki reklamowej

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

Używanie Swift Package Managera

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

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

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

2. W wyświetlonym oknie wyszukaj ten adres URL pakietu:

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

3. W sekcji Reguła zależności wybierz Gałąź.

4. W polu tekstowym wpisz main.

Używanie 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 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 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 Ads Network.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że urządzenie testowe jest zarejestrowane w usłudze Ad Manager.

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.

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

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

GADMediationAdapterLine.testMode = YES;

Sprawdzanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z sieci reklamowej 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:

import LineAdapter
// ...

let request = GAMRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

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

GAMRequest *request = [GAMRequest 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 w przypadku GADNativeAd.

¹ W przypadku reklam natywnych pakiet SDK sieci reklamowej LY nie udostępnia zasobu ikony aplikacji. Zamiast tego adapter sieci reklamowej LY 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 reklamę, korzystając z 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:

Historia zmian adaptera do zapośredniczenia LINE na iOS

Wersja 3.1.1.0

• Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 3.1.1.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 13.9.0.
• Pakiet SDK FiveAd w wersji 3.1.1.

Wersja 3.1.0.0

• Teraz wymagana jest minimalna wersja iOS 15.0.
• Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 3.1.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 13.8.0.
• FiveAd SDK w wersji 3.1.0.

Wersja 3.0.1.2

• Zaktualizuj minimalną wersję iOS, aby zmniejszyć zależność od pakietu SDK do reklam mobilnych Google i umożliwić korzystanie z wersji podrzędnych.
• Rozwiązaliśmy problem, który powodował, że ikona Informacja w reklamach natywnych była zbyt duża.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 13.4.0.
• Wersja pakietu SDK FiveAd 3.0.1.

Wersja 3.0.1.1

• Adapter przekazuje teraz flagę ageRestrictedTreatment pakietu SDK do reklam mobilnych Google do interfejsu API COPPA pakietu SDK FiveAd.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 13.3.0.
• Pakiet SDK FiveAd w wersji 3.0.1.

Wersja 3.0.1.0

• Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 3.0.1.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 13.1.0.
• Wersja pakietu SDK FiveAd 3.0.1.

Wersja 3.0.0.1

• Zaktualizowano zależność pakietu SDK do reklam mobilnych Google do wersji 13.0.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 13.0.0.
• Wersja pakietu SDK FiveAd 3.0.0.

Wersja 3.0.0.0

• Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 3.0.0.0.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 12.14.0.
• Pakiet SDK FiveAd w wersji 3.0.0.

Wersja 2.9.20251119.1

• Dodaliśmy obsługę przekazywania parametrów tagForUnderAgeOfConsent pakietu SDK do reklam mobilnych Google do pakietu SDK FiveAd.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 12.14.0.
• Pakiet SDK FiveAd w wersji 2.9.20251119.

Wersja 2.9.20251119.0

• Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.9.20251119.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 12.14.0.
• Pakiet SDK FiveAd w wersji 2.9.20251119.

Wersja 2.9.20250930.0

• Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.9.20250930.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 12.12.0.
• Pakiet SDK FiveAd w wersji 2.9.20250930.

Wersja 2.9.20250912.0

• Adapter inicjuje teraz pakiet SDK FiveAd przed każdym żądaniem reklamy.
• Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.9.20250912.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 12.11.0.
• FiveAd SDK w wersji 2.9.20250912.

Wersja 2.9.20250512.0

• Teraz wymagany jest system iOS w wersji co najmniej 13.0.
• Sprawdzona zgodność z pakietem SDK FiveAd w wersji 2.9.20250512.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 12.4.0.
• Pakiet SDK FiveAd w wersji 2.9.20250512.

Wersja 2.9.20241106.3

• Rozwiązaliśmy problem, który powodował, że GADMediationAdapterLine.h nie był nagłówkiem publicznym.
• Włączono flagi -fobjc-arc i -fstack-protector-all.
• Usunęliśmy weryfikację rozmiaru reklamy banerowej na potrzeby określania stawek po pomyślnym wczytaniu.
  • Banery reklamowe kaskadowe będą nadal sprawdzać rozmiary banerów reklamowych po ich wczytaniu.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 12.2.0.
• FiveAd SDK w wersji 2.9.20241106.

Wersja 2.9.20241106.2

• Dodaliśmy właściwość GADMediationAdapterLine.testMode, aby wskazać, czy pakiet SDK FiveAd ma być inicjowany w trybie testowym. Tę flagę należy ustawić przed zainicjowaniem pakietu SDK do reklam mobilnych Google.
• Usunęliśmy sprawdzanie stanu inicjowania pakietu SDK FiveAd przed jego zainicjowaniem.
• Usunięto wycofane sprawdzanie stanu reklamy natywnej przed pobraniem komponentów reklamy natywnej.
• Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 12.0.0 lub nowszej.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 12.0.0.
• Pakiet SDK FiveAd w wersji 2.9.20241106.

Wersja 2.9.20241106.1

• Zaktualizowano adapter, aby używał najnowszego interfejsu API wczytywania reklam do określania stawek za banery reklamowe.
• Rozwiązaliśmy problem, który uniemożliwiał prawidłowe przekazywanie zdarzeń reklamowych w przypadku reklam pełnoekranowych z określaniem stawek.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 11.12.0.
• Pakiet SDK FiveAd w wersji 2.9.20241106.

Wersja 2.9.20241106.0

• Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.9.20241106.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 11.12.0.
• FiveAd SDK w wersji 2.9.20241106.

Wersja 2.8.20240827.1

• Zaktualizowano CFBundleShortVersionString, aby zawierał 3 komponenty zamiast 4.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 11.10.0.
• Pakiet SDK FiveAd w wersji 2.8.20240827.

Wersja 2.8.20240827.0

• Zweryfikowano zgodność z pakietem FiveAd SDK w wersji 2.8.20240827.
• Dodano obsługę określania stawek w przypadku banerów, reklam pełnoekranowych, reklam z nagrodą i formatów reklam natywnych.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 11.8.0.
• Wersja pakietu FiveAd SDK 2.8.20240827.

Wersja 2.8.20240612.0

• Dodano sterowanie dźwiękiem w reklamie natywnej za pomocą GADVideoOptions.
• Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.8.20240612.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 11.5.0.
• Pakiet SDK FiveAd w wersji 2.8.20240612.

Wersja 2.7.20240411.0

• Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.7.20240411.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 11.3.0.
• Pakiet SDK FiveAd w wersji 2.7.20240411.

Wersja 2.7.20240318.0

• Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.7.20240318.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 11.2.0.
• Pakiet SDK FiveAd w wersji 2.7.20240318.

Wersja 2.7.20240214.1

• Wymaga teraz systemu iOS w wersji co najmniej 12.0.
• Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 11.0 lub nowszej.
• Uwzględniono Info.plist w platformach w ramach LineAdapter.xcframework.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
• FiveAd SDK w wersji 2.7.20240214.

Wersja 2.7.20240214.0

• Sprawdzona zgodność z pakietem FiveAd SDK w wersji 2.7.20240214.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
• FiveAd SDK w wersji 2.7.20240214.

Wersja 2.7.20240126.0

• Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.7.20240126.
• Zaktualizowano implementację adaptera o nowe protokoły delegowane pakietu SDK FiveAd.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
• Pakiet SDK FiveAd w wersji 2.7.20240126.

Wersja 2.7.20231115.0

• Zweryfikowana zgodność z pakietem SDK FiveAd w wersji 2.7.20231115.
• Uwzględniony nagłówek GADMediationAdapterLineExtras w pliku modulemap.

Zaprojektowano i przetestowano z użyciem:

• 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 GADMediationAdapterLineAudioState, aby zarządzać początkowym stanem dźwięku banera, reklamy pełnoekranowej i reklamy z nagrodą, gdy są wyświetlane po raz pierwszy.

Zbudowano i przetestowano z:

• 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 banerów, reklam pełnoekranowych, reklam z nagrodą i formatów reklam natywnych.
• Zweryfikowano zgodność z pakietem SDK FiveAd w wersji 2.6.20230609.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 10.9.0.
• FiveAd SDK w wersji 2.6.20230609.