Pierwsze kroki

Ten przewodnik jest przeznaczony dla wydawców, którzy chcą zarabiać na aplikacji w Unity.

Integrowanie wtyczki Google Mobile Ads Unity z aplikacją, która będzie tu widoczna, stanowi pierwszy krok w kierunku wyświetlania reklam AdMob i zarabiania. Po zakończeniu integracji możesz wybrać format reklamy (np. reklamę natywną lub wideo z nagrodą), aby zobaczyć szczegółowe instrukcje implementacji.

Wymagania wstępne

  • Korzystanie z Unity 2019 lub nowszej wersji
  • Aby wdrożyć w iOS:
    • Xcode 14.1 lub nowsza wersja
    • Kieruj reklamy na iOS 11.0 lub nowszy
    • CocoaPods,
  • Aby wdrożyć w Androidzie:
    • Usługi Google Play w wersji 18.1.0 lub nowszej
    • Kierowanie na interfejs API Androida na poziomie 16 lub wyższym
  • Zalecane: utwórz konto AdMob i zarejestruj aplikację na Androida lub iOS

Pobierz wtyczkę Mobile Ads Unity

Wtyczka Unity do reklam mobilnych Google pozwala deweloperom Unity łatwo wyświetlać reklamy mobilne Google na urządzeniach z Androidem i aplikacjach na iOS bez konieczności pisania kodu Java lub celu C. Wtyczka zapewnia interfejs C# do wysyłania żądań reklam używanych przez skrypty C# w Twoim projekcie w Unity.

Aby pobrać pakiet Unity na potrzeby wtyczki lub zobaczyć jej kod na GitHubie, skorzystaj z poniższych linków.

POBIERZ Wtyczkę WYŚWIETL ŹRÓDŁO

Importuj wtyczkę Mobile Ads Unity

Otwórz projekt w edytorze Unity. Wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany przez siebie plik GoogleMobileAdsPlugin.unitypackage.

Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.

Uwzględnij pakiet SDK do reklam mobilnych

Wtyczka Unity do reklam mobilnych Google jest rozpowszechniana za pomocą biblioteki resolverów usług Play. Ta biblioteka jest przeznaczona do użycia przez każdą wtyczkę Unity, która wymaga dostępu do bibliotek specyficznych dla Androida (np. AAR) lub iOS CocoaPods. Umożliwia wtyczkam Unity deklarowanie zależności, które są automatycznie rozpoznawane i kopiowane do projektu Unity.

Wykonaj podane niżej czynności, by upewnić się, że projekt zawiera pakiet SDK do reklam mobilnych.

Android

W edytorze Unity wybierz Assets (Zasoby) > Zewnętrzny menedżer zależności > resolver Android > Rozwiąż. Biblioteka zewnętrznego menedżera zależności Unity skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android aplikacji Unity.

iOS

Aby dodać pakiet SDK do reklam mobilnych do projektu Unity, nie musisz niczego robić.

  • Jeśli używasz Unity 5.6 lub nowszego, generowany jest xcworkspace z wymaganymi bibliotekami zależności. Użyj wygenerowanego obiektu xcworkspace zamiast standardowego projektu Xcode.
  • Jeśli używasz starszych wersji Unity, zależności są uwzględnione w standardowym projekcie Xcode.

Ustaw identyfikator aplikacji AdMob

W edytorze Unity wybierz z menu Zasoby > Reklamy mobilne Google > Ustawienia.

W odpowiednich polach wpisz identyfikator aplikacji na Androida i iOS.

Zgłaszanie zdarzeń reklamowych w głównym wątku Unity

Pakiet SDK do reklam mobilnych Google czasami wysyła zdarzenia w innym wątku niż wątek główny w Unity. Może to powodować problemy podczas interakcji z obiektami Unity ze zdarzeń wysyłanych z pakietu SDK do reklam mobilnych Google. Aby obejść ten problem, dodaj kod pakietu SDK do reklam mobilnych do głównego wątku Unity.

Jeśli chcesz, aby pakiet SDK do reklam mobilnych radził sobie z wątkami, ustaw MobileAds.RaiseAdEventsOnUnityMainThread na true. Wymusi to pakiet SDK do reklam mobilnych do wywołania wszystkich zdarzeń i wywołań zwrotnych w głównym wątku Unity.

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be raised
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;
    }
}

Zainicjuj pakiet SDK do reklam mobilnych

Przed załadowaniem reklam poproś aplikację o zainicjowanie pakietu SDK do reklam mobilnych, wywołując metodę MobileAds.Initialize(). Wystarczy to zrobić raz, najlepiej przy uruchamianiu aplikacji.

Oto przykład wywołania Initialize() w metodzie Start() skryptu dołączonego do GameObject:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

Jeśli korzystasz z zapośredniczenia, przed załadowaniem reklam poczekaj na wywołanie zwrotne, aby upewnić się, że wszystkie adaptery zapośredniczenia zostały zainicjowane.

Wybierz format reklamy

Pakiet SDK do reklam mobilnych jest teraz częścią aplikacji Unity podczas wdrażania na platformie Android lub iOS. Możesz już wdrożyć reklamę. AdMob oferuje wiele różnych formatów reklam, dzięki czemu możesz wybrać ten, który najlepiej odpowiada Twoim potrzebom.

Banery reklamowe to prostokątne reklamy graficzne lub tekstowe, które zajmują miejsce w układzie aplikacji. Pozostają na ekranie, gdy użytkownicy korzystają z aplikacji, i po określonym czasie mogą się automatycznie odświeżać. Jeśli dopiero zaczynasz przygodę z reklamami mobilnymi,

Implementowanie banera

Pełnoekranowa

Reklamy pełnoekranowe zajmują cały ekran aplikacji, dopóki użytkownik ich nie zamknie. Najlepiej robić to w naturalnych przerwach w wyświetlaniu aplikacji, np. między poziomami gry lub zaraz po ukończeniu zadania.

Stosowanie reklamy pełnoekranowej

Natywny

Reklamy natywne to format reklamy oparty na komponentach, który pozwala dowolnie dostosowywać sposób wyświetlania w aplikacjach zasobów, takich jak nagłówki i wezwania do działania. Wybierając czcionki, kolory i inne szczegóły, możesz tworzyć naturalne, dyskretne prezentacje reklam, które wzbogacą Twoje reklamy.

Implementowanie reklam natywnych

Otrzymano

Reklamy wideo z nagrodą to pełnoekranowe reklamy wideo, które użytkownicy mogą oglądać w zamian za nagrody w aplikacji.

Wdrażanie reklam z nagrodą

Poproś o autoryzację w ramach programu App Tracking Transparency

Aby wyświetlić żądanie autoryzacji App Tracking Transparency (ATT) dotyczące dostępu do IDFA, skorzystaj z pakietu pomocy dotyczącej reklam na iOS 14.

Ta sama klucz aplikacji

Wymagania wstępne: wtyczka Unity do reklam mobilnych Google w wersji 6.1.0 lub nowszej

Pakiet SDK do reklam mobilnych Google wprowadza taki sam klucz aplikacji, który pozwala wyświetlać trafniejsze i spersonalizowane reklamy na podstawie danych zebranych z aplikacji, z której korzysta użytkownik.

Funkcja Same App Key jest domyślnie włączona, ale możesz ją wyłączyć za pomocą tego interfejsu API:

public void Start()
    {
        RequestConfiguration requestConfiguration =
            new RequestConfiguration.Builder()
            .SetSameAppKeyEnabled(true).build();
        MobileAds.SetRequestConfiguration(requestConfiguration);

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(HandleInitCompleteAction);
    }