Integracja LY Ads Network z zapośredniczeniem AdMob

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads SDK for React Native do wczytywania i wyświetlania reklam z sieci reklamowej LY Ads Network za pomocą zapośredniczenia, które 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ą React Native.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob do sieci reklamowej LY Ads Network ma te funkcje:

Integracja
Określanie stawek
Kaskada
Formaty
Otwarcie aplikacji
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Rodzimy użytkownik

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

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

Android

Szczegółowe informacje na temat rejestracji

iOS

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

Android

Instrukcje znajdziesz w kroku 2 w przewodniku dla Android.

iOS

Instrukcje znajdziesz w kroku 2 w przewodniku dla iOS.

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

W katalogu głównym projektu zainstaluj adapter zapośredniczenia Google Mobile Ads SDK for React Native dla sieci reklamowej LY Ads Network. Wykonaj te czynności:

  1. Skopiuj plik tar adaptera Google Mobile Ads SDK for React Native z katalogu gma-sdk-react-native/adapters/line/ do katalogu local_packages/ projektu. Jeśli nie masz folderu adapters, zapoznaj się z sekcją Wymagania wstępne.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/line/gma-mediation-line-0.1.0.tgz local_packages/

    Zastąp EXTRACT_DIR ścieżką do katalogu, w którym zostało wyodrębnione archiwum.

  2. Zainstaluj pakiet adaptera za pomocą preferowanego systemu zarządzania pakietami:

    npm

    npm install ./local_packages/gma-mediation-line-0.1.0.tgz

    włóczka

    yarn add ./local_packages/gma-mediation-line-0.1.0.tgz

Krok 4. Dodaj wymagany kod

Android

Integracja z siecią reklamową LY Ads Network nie wymaga dodatkowego kodu.

iOS

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

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

Wtyczka zapośredniczenia React Native sieci reklamowej LY Ads obsługuje ten dodatkowy parametr żądania, który można przekazać do adaptera za pomocą klasy LineMediationExtras:

  • enableAdSound : określa domyślny stan początkowy dźwięku w reklamach banerowych, pełnoekranowych i z nagrodą.

Oto przykładowy kod, który pokazuje, jak utworzyć żądanie reklamy z tymi parametrami:

import { LineMediationExtras } from '@google/gma-mediation-line';

const request = {
  // ...
  mediationExtras: [
    new LineMediationExtras({
      enableAdSound: true,
    }),
  ],
};

Kody błędów

Jeśli adapter nie otrzyma reklamy z sieci reklamowej LY Ads Network, wydawcy mogą sprawdzić błąd w odpowiedzi na żądanie reklamy, używając metody ResponseInfo w tych klasach:

Android

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

iOS

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:

Android

Kod błędu Domena Przyczyna
1-10 com.five_corp.ad 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 Brak identyfikatora aplikacji lub jest on nieprawidłowy.
102 com.google.ads.mediation.line Brak identyfikatora boksu lub jest on nieprawidłowy.
103 com.google.ads.mediation.line Żądany rozmiar reklamy nie pasuje do rozmiaru banera reklamowego obsługiwanego przez sieć reklamową LY Ads Network.
104 com.google.ads.mediation.line Nie udało się wczytać reklamy pełnoekranowej ani reklamy z nagrodą z powodu braku kontekstu aktywności.
105 com.google.ads.mediation.line Pakiet SDK sieci reklamowej LY 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 brakujących komponentów.
107 com.google.ads.mediation.line Pakiet SDK FiveAd zwrócił pusty obiekt do wczytywania reklam.

iOS

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.

Wersja 0.1.0

  • Pierwsza wersja.