Integracja nend z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z aplikacji za pomocą zapośredniczenia w zakresie integracji kaskady. Opisano w nim, jak dodać komponent nend do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter nend z aplikacją na Unity.

Interfejs panelu nend w etykietach, przyciskach i opisach zawiera tekst w języku japońskim, a widoczne poniżej zrzuty ekranu nie zostały przetłumaczone. Jednak w tekście tego przewodnika etykiety i przyciski odnoszą się do ich angielskich nazw. np. „URL カーム”, to „Schemat URL” i tak dalej.

Obsługiwane integracje i formaty reklam

Integracja
Ustalanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Otrzymano

Wymagania

  • Unity 4 lub nowsza
  • Najnowszy pakiet SDK do reklam mobilnych Google
  • Aby przeprowadzić wdrożenie na Androidzie:
    • Interfejs API Androida na poziomie 19 lub wyższym
  • Aby wdrożyć w iOS:
    • Wartość docelowa wdrożenia iOS w wersji 12.0 lub nowszej
  • Działający projekt na Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • Wykonaj czynności dotyczące zapośredniczenia Wprowadzenie
GoogleMobileAdsNendMediation.unitypackage

Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika Nend

Zarejestruj się lub zaloguj na konto Nend.

Aby dodać aplikację do panelu nend, najpierw kliknij kartę Zarządzanie miejscami docelowymi, a następnie wybierz Witryna/aplikacja. Kliknij przycisk Dodaj aplikację, by dodać aplikację do oferty.

Tworzenie aplikacji

Wpisz nazwę swojej aplikacji i jako typ aplikacji wybierz platformę, na której jest ona dostępna. Wpisz URL i sprawdź, czy Twoja aplikacja jest dostępna w odpowiednim sklepie z aplikacjami.

(jeśli Twoja aplikacja nie została jeszcze opublikowana, zapoznaj się z najczęstszymi pytaniami na temat nieopublikowanych aplikacji). Wybierz kategorię dla swojej aplikacji i kliknij Utwórz.

Android

iOS

Po utworzeniu aplikacja zostanie wyświetlona w panelu.

Android

iOS

Tworzenie miejsca docelowego

Po zarejestrowaniu aplikacji możesz przejść do tworzenia miejsca docelowego. Aby utworzyć miejsce docelowe na potrzeby banerów reklamowych, otwórz kartę Zarządzanie miejscami docelowymi i kliknij Miejsce docelowe. Następnie kliknij przycisk Utwórz nowe miejsce docelowe.

Wybierz aplikację w menu. Następnie postępuj zgodnie z instrukcjami odpowiednimi dla Twojego preferowanego formatu reklamy.

Jako Typ reklamy wybierz Obraz i Baner jako Typ zasobów reklamowych. Gdy skończysz, wpisz Nazwę miejsca docelowego, wypełnij Wprowadzenie do zasobów reklamowych, wybierz Format zasobów reklamowych, a na koniec określ Rozmiar zasobów reklamowych. Gdy skończysz, kliknij przycisk Utwórz, aby utworzyć miejsce docelowe.

Pełnoekranowa

Jako Typ reklamy wybierz Nieruchomy obraz i Reklama pełnoekranowa jako Typ zasobów reklamowych. Gdy skończysz, wpisz nazwę miejsca docelowego, wypełnij Wprowadzenie do zasobów reklamowych i wybierz z listy Częstotliwość wyświetlania reklam. Gdy skończysz, kliknij przycisk Utwórz, aby utworzyć miejsce docelowe.

W przypadku pełnoekranowych reklam wideo wybierz Wideo jako Typ reklamy i Pełnoekranowa jako Typ zasobów reklamowych. Gdy skończysz, wpisz nazwę miejsca docelowego, przeczytaj Wprowadzenie do zasobów reklamowych i wybierz odpowiednią kategorię z listy. Gdy skończysz, kliknij przycisk Utwórz, aby utworzyć miejsce docelowe.

Otrzymano

Jako Typ reklamy wybierz Wideo, a jako Typ zasobów reklamowych – Nagroda. Gdy skończysz, wpisz nazwę miejsca docelowego, wypełnij Wprowadzenie do zasobów reklamowych i wybierz odpowiednią kategorię z listy.

W sekcji Ustawienia nagrody wybierz Treści nagrody, korzystając z listy. Wpisz preferowaną nazwę waluty wirtualnej. Gdy skończysz, kliknij przycisk Utwórz, aby utworzyć miejsce docelowe.

Natywna

Jako Typ reklamy wybierz Nieruchomy obraz i Natywna jako Typ zasobów reklamowych. Gdy skończysz, wpisz nazwę miejsca docelowego, wypełnij artykuł Wprowadzenie do zasobów reklamowych i wybierz Wybór obrazu reklamy. Gdy skończysz, kliknij przycisk Utwórz, aby utworzyć miejsce docelowe.

W przypadku natywnych reklam wideo jako Typ reklamy wybierz Wideo i jako Typ zasobów reklamowych wybierz Natywna (niestandardowa). Gdy skończysz, wpisz nazwę miejsca docelowego, przeczytaj Wprowadzenie do zasobów reklamowych i wybierz odpowiednią kategorię z listy.

W sekcji Ustawienia natywne wybierz z listy Orientację reklamy wideo i Typ reklamy natywnej. Gdy skończysz, kliknij przycisk Utwórz, aby utworzyć miejsce docelowe.

Aby skonfigurować AdMob jednostkę reklamową w kolejnej sekcji, będziesz potrzebować apiKey i spotID dla każdego miejsca docelowego. Aby je znaleźć, otwórz kartę Zarządzanie miejscami docelowymi i kliknij przycisk SDK pod nazwą aplikacji.

Zwróć uwagę na apiKey i spotID.

Potrzebny będzie też klucz interfejsu API do interfejsu API do raportowania nend, który wywołuje klucz interfejsu API do wydobywania danych. Znajdziesz go na karcie Narzędzia.

Krok 2. Skonfiguruj zapotrzebowanie AdMob w interfejsie

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 instrukcji na Androida.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika po iOS.

Krok 3. Zaimportuj pakiet SDK i adapter nend

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google na potrzeby Nend, korzystając z linku do pobierania w dzienniku zmian, i wyodrębnij pakiet GoogleMobileAdsNendMediation.unitypackage z pliku zip.

W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsNendMediation.unitypackage. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.

Następnie wybierz Zasoby > Program do rozpoznawania Usług Google Play > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka programu do rozpoznawania zależności w Usługach Unity Play przeprowadzi rozpoznawanie zależności od zera i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android aplikacji Unity.

Krok 4. Dodaj wymagany kod

Android

Integracja z bazą danych nie wymaga dodatkowego kodu.

iOS

Integracja SKAdNetwork

Postępuj zgodnie z dokumentacją, 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 uzyskać reklamy testowe dla banerów, reklam pełnoekranowych i reklam z nagrodą, zalecamy użycie kluczy interfejsu API i identyfikatorów Spotów podanych na stronie dołącz do testowych jednostek reklamowych . Podczas testowania można je wpisać jako klucze interfejsu API i identyfikatory Spota jednostek reklamowych AdMob podczas testowania, a następnie zastąpić je rzeczywistym kluczem interfejsu API i identyfikatorem Spota, gdy aplikacja będzie gotowa do produkcji.

Weryfikacja reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynynend, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z nend (Waterfall) źródeł reklam.

Kody błędów

Jeśli adapter nie otrzyma reklamy z nend, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z ResponseInfo w tych klasach:

Android

com.google.ads.mediation.nend.NendAdapter
com.google.ads.mediation.nend.NendRewardedAdapter
com.google.ads.mediation.nend.NendMediationAdapter

iOS

GADMAdapterNend
GADMAdapterNend
GADMAdapterNendRewarded
GADMediationAdapterNend

Oto kody i powiązane z nimi wiadomości wysyłane przez adapter Nend, gdy nie można wczytać reklamy:

Android

Kod błędu Domena Przyczyna
101 com.google.ads.mediation.nend Żeby wczytać i wyświetlić reklamy, nend wymaga kontekstu aktywności.
102 com.google.ads.mediation.nend Brakuje parametrów serwera Nend skonfigurowanych w interfejsie AdMob lub są one nieprawidłowe.
103 com.google.ads.mediation.nend reklama nie jest jeszcze gotowa do wyświetlania.
104 com.google.ads.mediation.nend nend nie odtworzył(a) reklamy.
105 com.google.ads.mediation.nend Żądany rozmiar reklamy nie pasuje do obsługiwanego rozmiaru banera.
106 com.google.ads.mediation.nend Odwołanie do obiektu kontekstu to null lub zostało niedawno zwolnione z pamięci.
200-299 net.nend.android Pakiet SDK nend zwrócił błąd ładowania reklamy pełnoekranowej. Więcej informacji znajdziesz w kodzie.
300-399 net.nend.android Pakiet SDK nend zwrócił błąd reklamy pełnoekranowej. Więcej informacji znajdziesz w kodzie.
400-499 net.nend.android Pakiet SDK nend zwrócił błąd reklamy. Więcej informacji znajdziesz w kodzie.

iOS

Kod błędu Domena Przyczyna
101 com.google.mediation.nend Pakiet nend SDK zwrócił wywołanie zwrotne o nieudanym obciążeniu bez dodatkowych informacji o błędzie.
102 com.google.mediation.nend Pakiet nend SDK zwrócił wywołanie zwrotne o nieudanym wyświetleniu bez dodatkowych informacji o błędzie.
103 com.google.mediation.nend Brakuje parametrów serwera Nend skonfigurowanych w interfejsie AdMob lub są one nieprawidłowe.
104 com.google.mediation.nend Nie udało się wczytać komponentów z obrazem reklam natywnych.
105 com.google.mediation.nend Nie udało się wyświetlić zapowiedzi, ponieważ reklama nie jest gotowa.
106 com.google.mediation.nend Żądany rozmiar banera reklamowego nie pasuje do rozmiaru banera obsługiwanego przez te firmy.
200-699 Wysłane przez pakiet SDK nend. Pakiet SDK nend zwrócił błąd. Więcej informacji znajdziesz w dokumentacji nend.

Historia zmian wtyczki Unity Mediation

Wersja 8.0.0

Wersja 7.0.0

Wersja 6.0.1

Wersja 6.0.0

Wersja 5.2.0

Wersja 5.1.0

Wersja 5.0.0

Wersja 4.0.1

Wersja 4.0.0

Wersja 3.0.0

Wersja 2.3.0

Wersja 2.2.0

Wersja 2.1.0

  • Zaktualizowano wtyczkę, aby obsługiwała nowy interfejs Rewarded API.
  • Obsługuje adapter Androida w wersji 5.1.0.2.
  • Obsługuje adapter iOS w wersji 5.1.1.0.

Wersja 2.0.3

  • Obsługuje adapter Androida w wersji 5.0.2.1.
  • Obsługuje adapter iOS w wersji 5.0.2.0.

Wersja 2.0.2

  • Obsługuje adapter Androida w wersji 5.0.2.0.
  • Obsługuje adapter iOS w wersji 5.0.2.0.

Wersja 2.0.1

  • Obsługuje adapter Androida w wersji 5.0.2.0.
  • Obsługuje adapter iOS w wersji 5.0.1.0.

Wersja 2.0.0

  • Obsługuje adapter Androida w wersji 5.0.0.0.
  • Obsługuje adapter iOS w wersji 5.0.0.0.

Wersja 1.0.2

  • Obsługuje adapter Androida w wersji 4.0.5.0.
  • Obsługuje adapter iOS w wersji 4.0.6.0.

Wersja 1.0.1

  • Obsługuje pakiet Android SDK w wersji 4.0.4.
  • Obsługuje pakiet SDK na iOS w wersji 4.0.4.

Wersja 1.0.0

  • Pierwsza wersja!
  • Obsługuje pakiet Android SDK w wersji 4.0.2.
  • Obsługuje pakiet SDK na iOS w wersji 4.0.2.