Integracja Moloco z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Ten przewodnik pokazuje, jak za pomocą Google Mobile Ads Unity Plugin wczytywać i wyświetlać reklamy z pakietu Moloco Ads SDK przy użyciu zapośredniczenia, w tym integracji z licytowaniem. Wyjaśniamy w nim, jak dodać pakiet SDK Moloco Ads do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK Moloco Ads i adapter z aplikacją Unity.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dla pakietu SDK Moloco Ads ma te funkcje:

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

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te informacje:

  • Najnowsza wersja Google Mobile Ads Unity Plugin.
  • Edytor Unity w wersji 5.6 lub nowszej.
  • Wtyczka Moloco Unity w wersji 1.2.0 lub nowszej.
  • Wdrażanie na Androidzie
    • Android w wersji API 23 lub nowszej.
  • Wdrażanie na iOS
    • iOS w wersji 13.0 lub nowszej.
  • działający projekt Unity skonfigurowany za pomocą Google Mobile Ads Unity Plugin; Więcej informacji znajdziesz w artykule Konfigurowanie Google Mobile Ads Unity Plugin.
  • Konfigurowanie zapośredniczenia AdMob

Krok 1. Skonfiguruj ustawienia w interfejsie pakietu Moloco Ads SDK

Zaloguj się w portalu wydawców Moloco.

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

Wybierz system operacyjny i ustawienia prywatności aplikacji, wypełnij pozostałą część formularza, a następnie kliknij Utwórz.

Android

iOS

Po utworzeniu aplikacji wybierz ją na karcie Aplikacje, aby wyświetlić szczegóły i zanotować 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łe pola 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 na reklamy 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 dla iOS.

Dodawanie Moloco Ads do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi

Aby dodać Moloco Ads do listy partnerów reklamowych wymaganych przez rozporządzenia europejskie i przepisy stanowe w USA w interfejsie AdMob, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK Moloco Ads SDK i adapter

OpenUPM-CLI

Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę do mediacji pakietu SDK do reklam mobilnych Google i pakietu SDK do reklam Moloco dla 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 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. Upewnij się, że 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 pakietem SDK do reklam 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 żądanie reklamy, korzystając z 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 Moloco SDK 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 do wyświetlenia reklamy.
Od -1 do 5000 Wysłane przez pakiet Moloco SDK Pakiet Moloco SDK 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 3.8.1

Wersja 3.8.0

Wersja 3.7.0

Wersja 3.6.1

Wersja 3.6.0

Wersja 3.5.1

Wersja 3.5.0

Wersja 3.4.1

Wersja 3.4.0

Wersja 3.3.1

Wersja 3.3.0

Wersja 3.2.0

Wersja 3.1.0

Wersja 3.0.0

Wersja 2.2.1

Wersja 2.2.0

Wersja 2.1.0

Wersja 2.0.0

Wersja 1.6.1

Wersja 1.6.0

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