Integracja Moloco z zapośredniczeniem (beta)

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Moloco przy użyciu mediacji, w tym integracji z licytowaniem. Wyjaśniamy w nim, jak dodać Moloco do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Moloco z aplikacją Unity.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dla Moloco ma te funkcje:

Integracja
Określanie stawek  1
Wodospad
Formaty
Otwarcie aplikacji
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą

1 Integracja określania stawek jest dostępna w ramach zamkniętych testów beta.

Wymagania

  • Najnowszy pakiet SDK do reklam mobilnych Google
  • Unity w wersji 5.6 lub nowszej
  • Wtyczka Moloco Unity w wersji 1.2.0 lub nowszej
  • Wdrażanie na Androidzie
    • Android API na poziomie 23 lub wyższym
  • Wdrażanie na iOS
    • iOS w wersji 12.0 lub nowszej
  • Działający projekt Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia.

Krok 1. Skonfiguruj ustawienia w interfejsie Moloco

Zaloguj się w portalu wydawców Moloco.

Otwórz kolejno karty Przegląd i Aplikacje, a następnie kliknij przycisk Dodaj aplikację, aby utworzyć nową aplikację.

Wybierz system operacyjny i ustawienia prywatności aplikacji, wypełnij pozostałe pola formularza, a potem kliknij Utwórz.

Android

iOS

Po utworzeniu aplikacji wybierz ją na karcie Aplikacje, aby wyświetlić szczegóły, i zanotuj klucz aplikacji.

Android

iOS

Otwórz kartę Przegląd > Jednostki reklamowe, wybierz aplikację z menu i kliknij Nowa jednostka reklamowa.

Wybierz Ustalanie stawek w aplikacji jako Metodę aukcji i wypełnij pozostałą część formularza. Następnie kliknij Utwórz.

Na karcie Jednostki reklamowe otwórz nowo utworzoną jednostkę reklamową, aby wyświetlić jej szczegóły. Zanotuj identyfikator jednostki reklamowej.

Krok 2. Skonfiguruj popyt Moloco w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego iOS.

Dodawanie Moloco Ads do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA

Aby dodać Moloco Ads do listy partnerów reklamowych w zakresie rozporządzeń europejskich i amerykańskich przepisów stanowych w interfejsie AdMob, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące amerykańskich przepisów stanowych.

Krok 3. Zaimportuj pakiet SDK i adapter Moloco

OpenUPM-CLI

Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę do mediacji pakietu SDK do reklam mobilnych Google i reklam Moloco w Unity, uruchamiając to polecenie z katalogu głównego projektu:

openupm add com.google.ads.mobile.mediation.moloco

OpenUPM

W edytorze projektu Unity kliknij Edit (Edytuj) > Project Settings (Ustawienia projektu) > Package Manager (Menedżer pakietów), aby otworzyć Ustawienia menedżera pakietów Unity.

Na karcie Scoped Registries (Rejestry o ograniczonym zakresie) dodaj OpenUPM jako rejestr o ograniczonym zakresie, podając te informacje:

  • Nazwa: OpenUPM
  • URL: https://package.openupm.com
  • Zakresy: com.google

Szczegóły OpenUPM

Następnie kliknij Window (Okno) > Package Manager (Menedżer pakietów), aby otworzyć Menedżera pakietów Unity, i w menu kliknij My Registries (Moje rejestry).

Rejestry Unity

Wybierz pakiet Google Mobile Ads Moloco Mediation i kliknij Install (Zainstaluj).

Instalowanie z OpenUPM

Pakiet Unity

Pobierz najnowszą wersję wtyczki do zapośredniczenia reklam mobilnych Google dla pakietu SDK do reklam Moloco, korzystając z linku do pobierania w dzienniku zmian, i wyodrębnij plik GoogleMobileAdsMolocoMediation.unitypackage z pliku ZIP.

W edytorze projektu Unity wybierz Assets (Zasoby) > Import Package (Importuj pakiet) > Custom Package (Własny pakiet) i znajdź pobrany plik GoogleMobileAdsMolocoMediation.unitypackage. Sprawdź, czy wszystkie pliki są zaznaczone, i kliknij Importuj.

Importowanie z Unity

Następnie wybierz Assets (Zasoby) > External Dependency Manager (Menedżer zależności zewnętrznych) > Android Resolver (Rozwiązywanie zależności w Androidzie) > Force Resolve (Wymuś rozwiązanie). Biblioteka External Dependency Manager od nowa rozwiąże zależności i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android w aplikacji Unity.

Wymuś rozwiązanie

Krok 4. Dodaj wymagany kod

Integracja z Moloco nie wymaga dodatkowego kodu.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe w AdMob.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z pakietu SDK Moloco Ads, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródeł reklam Moloco (licytowanie).

Kody błędów

Jeśli adapter nie otrzyma reklamy od Moloco, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na reklamę za pomocą ResponseInfo w tych klasach:

Android

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

iOS

MolocoSDK.MolocoError
GADMediationAdapterMoloco

Oto kody i komunikaty wyświetlane przez adapter Moloco, gdy nie uda się wczytać reklamy:

Android

Kod błędu Domena Przyczyna
101 com.google.ads.mediation.moloco Brakujący lub nieprawidłowy klucz aplikacji Moloco.
102 com.google.ads.mediation.moloco Brakujący lub nieprawidłowy identyfikator jednostki reklamowej Moloco.
103 com.google.ads.mediation.moloco Zwrócony obiekt reklamy Moloco miał wartość null.
Od -1 do 5000 com.moloco.sdk Pakiet SDK Moloco zwrócił błąd. Więcej informacji znajdziesz w dokumentacji Moloco.

iOS

Kod błędu Domena Przyczyna
101 com.google.ads.mediation.moloco Pakiet SDK Moloco nie obsługuje wyświetlania reklam w systemie iOS 12 i starszych.
102 com.google.ads.mediation.moloco Brakujący lub nieprawidłowy klucz aplikacji Moloco.
103 com.google.ads.mediation.moloco Brakujący lub nieprawidłowy identyfikator jednostki reklamowej Moloco.
104 com.google.ads.mediation.moloco Reklama nie jest gotowa do wyświetlania.
105 com.google.ads.mediation.moloco Nie udało się wyświetlić reklamy.
106 com.google.ads.mediation.moloco Brak danych renderowania, które umożliwiłyby wyświetlenie reklamy.
Od -1 do 5000 Wysłano przez pakiet SDK Moloco Pakiet SDK Moloco zwrócił błąd. Więcej informacji znajdziesz w dokumentacji Moloco.

Weryfikacja po stronie serwera w przypadku reklam z nagrodą

Jeśli weryfikujesz wywołania zwrotne weryfikacji po stronie serwera (SSV), identyfikator źródła reklamy w przypadku Moloco to 8267622065755668722.

Historia zmian wtyczki Moloco Unity Mediation

Wersja 1.5.0

Wersja 1.4.0

Wersja 1.3.1

Wersja 1.3.0

Wersja 1.2.1

Wersja 1.2.0

Wersja 1.1.0

Wersja 1.0.0