Wypróbuj

Wtyczka Unity do reklam mobilnych Google pozwala programistom na Unity wyświetlać reklamy mobilne Google w aplikacjach na Androida i iOS bez konieczności pisania kodu w języku Java ani Objective-C. Wtyczka udostępnia interfejs w języku C# do wysyłania żądań reklam, który jest używany przez skrypty C# w projekcie Unity.

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

Wymagania wstępne

  • Używaj Unity w wersji 2019.4 lub nowszej
  • Aby wdrożyć to w iOS:
    • Xcode 15.3 lub nowsza wersja
    • Kierowanie na system iOS 12.0 lub nowszy
    • CocoaPods
  • Aby wdrożyć to na Androidzie:
    • Minimalny poziom interfejsu API Androida: 21 lub wyższy
    • Docelowy poziom interfejsu Android API na poziomie 31 lub wyższym

Poziom interfejsu Android API możesz ustawić w sekcji Ustawienia projektu > Odtwarzacz > Android > Inne ustawienia > Inne ustawienia.

Importowanie wtyczki do reklam mobilnych dla Unity

OpenUPM-CLI

Jeśli masz zainstalowany interfejs wiersza poleceń OpenUPM, możesz zainstalować rejestr OpenUPM przy użyciu tego polecenia:

openupm add com.google.ads.mobile

Usuń .unitypackage komponenty z wtyczką

Jeśli przechodzisz z .unitypackage na OpenUPM, musisz ręcznie odinstalować zasoby ze starej lokalizacji. Usuń te katalogi zaimportowane z .unitypackage:

  • Zasoby/ExternalDependencyManager
  • Komponenty/GoogleMobileAds
  • 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, wybierając w menu Unity opcję Edytuj > Ustawienia projektu > Menedżer pakietów.

  2. Dodaj OpenUPM jako rejestr o ograniczonym zakresie 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 opcję menu Unity Okno > Menedżer pakietów.

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

  5. Wybierz z listy pakietów pakiet Reklamy mobilne Google na Unity i kliknij Zainstaluj.

Usuń .unitypackage komponenty z wtyczką

Jeśli przechodzisz z .unitypackage na OpenUPM, musisz ręcznie odinstalować zasoby ze starej lokalizacji. Usuń te katalogi zaimportowane z .unitypackage:

  • Zasoby/ExternalDependencyManager
  • Komponenty/GoogleMobileAds
  • 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. W tym celu w menu Unity kliknij Zasoby > Importuj pakiet > Pakiet niestandardowy i zaimportuj wszystkie elementy.

Uwzględnij zależności zewnętrzne

Wtyczka Unity do reklam mobilnych Google jest rozpowszechniana wraz z biblioteką programu do rozpoznawania usług Unity Play. Ta biblioteka jest przeznaczona do użycia przez każdą wtyczkę Unity, która wymaga dostępu do bibliotek dla Androida, takich jak AAR czy CocoaPods na iOS. Zapewnia wtyczkom Unity możliwość deklarowania zależności, które są automatycznie rozpoznawane i kopiowane do projektu Unity.

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

Android

Otwórz Ustawienia projektu > Odtwarzacz > Android > Ustawienia publikowania > Kompilacja i wybierz:

  • Niestandardowy szablon głównego narzędzia Gradle
  • Szablon niestandardowych właściwości Gradle

W edytorze Unity wybierz Zasoby > Zewnętrzny menedżer zależności > Android > Rozpoznawanie, aby biblioteka zewnętrznego menedżera zależności Unity skopiowała zadeklarowane zależności do katalogu Assets/Plugins/Android aplikacji w Unity.

iOS

Unity na iOS używa CocoaPods do identyfikowania zależności i zarządzania nimi. Zapoznaj się z dokumentacją CocoaPods, aby poznać konkretne wymagania i sposoby rozwiązywania problemów związanych z zależnościami iOS.

Zależności wtyczki Unity do reklam mobilnych Google są wymienione tutaj: Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.

Ustaw identyfikator aplikacji AdMob

W menu edytora Unity wybierz Zasoby > Reklamy mobilne Google > Ustawienia.

Wpisz swoją aplikację z Androidem lub iOS Identyfikator aplikacji AdMob w każdym polu.

Inicjowanie pakietu SDK

Przed wczytaniem reklam poproś aplikację o zainicjowanie pakietu SDK do reklam mobilnych Google, wywołując wywołanie MobileAds.Initialize(). Wystarczy to zrobić tylko 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, by mieć pewność, że wszystkie adaptery zapośredniczenia zostały zainicjowane.

Wybierz format reklamy

Pakiet SDK do reklam mobilnych Google jest teraz dołączany do aplikacji w Unity podczas wdrażania na platformie Android lub iOS. Możesz teraz wdrożyć reklamę. AdMob oferuje wiele różnych formatów reklam, możesz więc wybrać taki, który zapewni Ci największą wygodę.

W jednostkach banerów reklamowych wyświetlane są prostokątne reklamy, które zajmują część układu aplikacji. Mogą być automatycznie odświeżane po upływie określonego czasu. Oznacza to, że użytkownicy widzą nową reklamę w regularnych odstępach czasu, nawet jeśli pozostają na tym samym ekranie aplikacji. Jest to również najprostszy format reklamy do wdrożenia.

Implementowanie banerów reklamowych

Pełnoekranowa

Pełnoekranowe jednostki reklamowe wyświetlają w aplikacji reklamy zajmujące całą stronę. Umieszczaj je w naturalnych przerwach i momentach przejściowych w interfejsie aplikacji, np. po ukończeniu poziomu w grze.

Zastosuj reklamy pełnoekranowe

Natywna

Reklamy natywne to reklamy, w których możesz dostosować sposób prezentowania zasobów, takich jak nagłówki czy wezwania do działania, w aplikacjach. Wybierając styl reklamy, możesz utworzyć naturalne, dyskretne prezentacje, które będą atrakcyjne dla użytkowników.

Implementowanie reklam natywnych

Otrzymano

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 poszczególnych jednostkach reklamowych i określić ich wartości oraz przedmioty, jakie użytkownik otrzymał.

Wdróż reklamy z nagrodą

Reklama pełnoekranowa z nagrodą

Reklama pełnoekranowa z nagrodą to nowy format reklamy zachęcającej do działania, który pozwala oferować nagrody, takie jak monety lub dodatkowe życia, za reklamy, które wyświetlają się automatycznie w naturalnych momentach przejściowych w aplikacji.

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

Zamiast komunikatu z prośbą o zgodę w reklamach z nagrodą reklamy pełnoekranowe z nagrodą wymagają ekranu z wprowadzeniem, na którym wyświetla się informacja o nagrodzie i pozwala użytkownikom zrezygnować z reklam z nagrodą.

Implementowanie reklam pełnoekranowych z nagrodą

Reklama przy otwarciu aplikacji

Przy otwarciu aplikacji to format reklamy, który pojawia się, gdy użytkownicy otwierają Twoją aplikację lub do niej wracają. Reklama nakłada się na ekran wczytywania.

Wdrażanie reklam wyświetlanych przy otwarciu aplikacji