Rozpocznij

Wtyczka Google Mobile Ads dla Unity umożliwia deweloperom Unity wyświetlanie reklam mobilnych Google w aplikacjach na Androida i iOS bez konieczności pisania kodu Java ani Objective-C. Plugin udostępnia interfejs C# do żądania reklam, który jest używany przez skrypty C# w Twoim projekcie Unity.

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

Wymagania wstępne

  • Użyj Unity w wersji 2019.4 lub nowszej.
  • Aby wdrożyć aplikację na iOS:
    • Xcode 16.0 lub nowsza
    • kierować reklamy na system iOS w wersji 12.0 lub nowszej,
    • CocoaPods
  • Aby wdrożyć aplikację na Androida:
    • Minimalny poziom interfejsu API Androida 23 lub wyższy
    • kierować aplikację na poziom API 34 lub nowszy.

Poziom interfejsu API Androida ustawiasz w sekcji Ustawienia projektu > Odtwarzacz > Android > Inne ustawienia > Inne ustawienia.

Importowanie wtyczki Reklamy mobilne dla Unity

OpenUPM-CLI

Jeśli masz zainstalowany interfejs wiersza poleceń OpenUPM, możesz zainstalować rejestr OpenUPM za pomocą tego polecenia:

openupm add com.google.ads.mobile

Usuwanie komponentów wtyczki .unitypackage

Jeśli przechodzisz z użycia .unitypackage do OpenUPM, musisz ręcznie odinstalować zasoby ze starej lokalizacji. Usuń te katalogi, które zostały zaimportowane z .unitypackage:

  • Komponenty/ExternalDependencyManager
  • Komponenty/Google Mobile Ads
  • Assets/Plugins/Android/googlemobileads-unity.aar
  • Assets/Plugins/Android/GoogleMobileAdsPlugin
  • Assets/Plugins/iOS/GADUAdNetworkExtras
  • Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

  1. Otwórz ustawienia menedżera pakietów, klikając opcję menu Unity Edytuj > Ustawienia projektu > Menedżer pakietów.

  2. Dodaj OpenUPM jako ograniczony rejestr do okna Menedżera pakietów:

    Name: OpenUPM
URL: https://package.openupm.com
Scopes: com.google

  3. Otwórz menu menedżera pakietów, wybierając w menu Unity opcję Okno > Menedżer pakietów.

  4. W menu zakresu menedżera wybierz Moje rejestry.

  5. Na liście pakietów wybierz pakiet Reklamy mobilne Google dla Unity i kliknij Zainstaluj.

Usuwanie komponentów wtyczki .unitypackage

Jeśli przechodzisz z użycia .unitypackage do OpenUPM, musisz ręcznie odinstalować zasoby ze starej lokalizacji. Usuń te katalogi, które zostały zaimportowane z .unitypackage:

  • Komponenty/ExternalDependencyManager
  • Komponenty/Google Mobile Ads
  • Assets/Plugins/Android/googlemobileads-unity.aar
  • Assets/Plugins/Android/GoogleMobileAdsPlugin
  • Assets/Plugins/iOS/GADUAdNetworkExtras
  • Assets/Plugins/iOS/unity-plugin-library.a

Importuj z GitHuba

  1. Pobierz najnowszą wersję .unitypackage z GitHuba.
  2. Zaimportuj plik .unitypackage, wybierając opcję menu Unity Zasoby > Importuj pakiet > Własny pakiet i importując wszystkie elementy.

Uwzględnij zależności zewnętrzne

Wtyczka reklam mobilnych Google dla Unity jest dystrybuowana z biblioteką Resolver rozhamu Unity Play Services. Ta biblioteka jest przeznaczona do użytku przez dowolny wtyczkę Unity, która wymaga dostępu do bibliotek specyficznych dla Androida, takich jak AAR lub CocoaPods na iOS. Umożliwia wtyczkom Unity deklarowanie zależności, które są następnie automatycznie rozwiązywane i kopiowane do projektu Unity.

Aby mieć pewność, że projekt zawiera wszystkie zależności:

Android

Kliknij Ustawienia projektu > Odtwarzacz > Android > Ustawienia publikacji > Kompilacja i wybierz:

  • Niestandardowy główny szablon Gradle
  • Szablon niestandardowych właściwości Gradle

W edytorze Unity wybierz Zasoby > Menedżer zewnętrznych zależności > Rozwiązanie Androida > Rozwiąż, aby biblioteka Unity External Dependency Manager skopiowała zadeklarowane zależności do katalogu Assets/Plugins/Android Twojej aplikacji Unity.

iOS

Unity for iOS używa CocoaPods do identyfikowania zależności i zarządzania nimi. Szczegółowe wymagania lub czynności związane z rozwiązywaniem problemów z zależnościami na iOS znajdziesz w dokumentacji CocoaPods.

Zależność wtyczki reklam mobilnych Google dla środowiska Unity są wymienione w pliku Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.

Ustawianie identyfikatora aplikacji AdMob

W edytorze Unity kliknij menu Komponenty > Reklamy mobilne Google > Ustawienia.

W każdym polu wpisz identyfikator aplikacji AdMob na Androida i iOS.

Inicjowanie pakietu SDK

Przed wczytaniem reklam zainicjuj pakiet SDK do reklam mobilnych Google w aplikacji, wywołując funkcję MobileAds.Initialize(). Wystarczy to zrobić tylko raz, najlepiej podczas uruchamiania aplikacji.

Oto przykład wywołania funkcji Initialize() w metodzie Start() skryptu dołączonego do elementu 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 zaczekaj na wywołanie zwrotne, aby mieć pewność, że wszystkie adaptery zapośredniczenia są zainicjowane.

Wybierz format reklamy

Pakiet SDK do reklam mobilnych Google jest teraz dołączany do aplikacji Unity podczas wdrażania na platformę Android lub iOS. Teraz możesz wdrożyć reklamę. AdMob oferuje różne formaty reklam, więc możesz wybrać ten, który zapewni użytkownikom najlepsze wrażenia.

W jednostkach z banerami reklamowymi wyświetlają się prostokątne reklamy, które zajmują część układu aplikacji. Mogą one być automatycznie odświeżane po upływie określonego czasu. Oznacza to, że użytkownicy zobaczą nowe reklamy w regularnych odstępach czasowych, nawet jeśli pozostaną na tym samym ekranie w aplikacji. Jest to format reklamy najprostszy do wdrożenia.

Wdrażanie banerów reklamowych

Pełnoekranowa

Jednostki reklam pełnoekranowych wyświetlają w aplikacji reklamy zajmujące całą stronę. Umieść je w naturalnych przerwach między elementami strony lub podczas przejścia z jednego etapu do następnego w interfejsie aplikacji, np. po ukończeniu poziomu w aplikacji z grą mobilną.

Wdrażanie reklam pełnoekranowych

Natywna

Reklamy natywne umożliwiają dostosowanie sposobu wyświetlania w aplikacji komponentów takich jak nagłówki i wezwania do działania. Samodzielne nadawanie reklamie stylu pozwala tworzyć naturalne, nieinwazyjne prezentacje reklam, które mogą wzbogacić wrażenia użytkownika.

Wdrażanie reklam natywnych

Z nagrodą

Jednostki reklamowe z nagrodą umożliwiają użytkownikom granie w gry, wypełnianie ankiet lub oglądanie filmów, aby zdobywać nagrody w aplikacji, takie jak monety, dodatkowe życia lub punkty. Możesz ustawić różne nagrody w różnych jednostkach reklamowych i określić wartości nagród oraz korzyści, które otrzymają użytkownicy.

Wdrażanie reklam z nagrodą

Reklama pełnoekranowa z nagrodą

Reklama pełnoekranowa z nagrodą to nowy format reklamy zachęcającej użytkownika do jej obejrzenia. Umożliwia uzyskanie nagród w aplikacji, takich jak monety lub dodatkowe życia. Reklamy tego typu wyświetlają się automatycznie w naturalnych momentach przejściowych w aplikacji.

W przeciwieństwie do reklam z nagrodą użytkownicy nie muszą wyrażać zgody na wyświetlenie reklamy pełnoekranowej z nagrodą.

Zamiast prośby o zgodę stosowanej w reklamach z nagrodą reklamy pełnoekranowe z nagrodą na początku wyświetlają ekran z informacjami o nagrodzie za obejrzenie danej reklamy i dają użytkownikowi możliwość jej pominięcia.

Wdrażanie reklam pełnoekranowych z nagrodą

Reklama przy otwarciu aplikacji

Reklama wyświetlana przy otwarciu aplikacji to format reklamy, który wyświetla się, gdy użytkownicy otwierają aplikację lub do niej wracają. Reklama nakłada się na ekran wczytywania.

Wdrażanie reklam wyświetlanych przy otwarciu aplikacji