Konfigurowanie wtyczki reklam mobilnych Google dla środowiska Unity

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

Wtyczka reklam mobilnych Google dla środowiska Unity umożliwia programistom Unity wyświetlanie reklam mobilnych Google w aplikacjach na Androida i iOS bez konieczności pisania kodu w języku Java lub Objective-C. Wtyczka udostępnia interfejs 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 Unity.

Wymagania wstępne

  • Używaj edytora Unity w wersji 2019.4 lub nowszej.
    • Zalecamy wersję 2022.2 lub nowszą.
  • Aby wdrożyć aplikację na iOS:
    • Xcode 16.0 lub nowszy
    • iOS 13.0 lub nowszy
    • CocoaPods
  • Aby wdrożyć aplikację na Androida:
    • Minimalny poziom interfejsu API Androida to 23 lub wyższy.
    • Poziom interfejsu API Androida to 35 lub wyższy.

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

Importowanie wtyczki reklam mobilnych dla środowiska 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żywania pliku .unitypackage na OpenUPM, musisz ręcznie odinstalować komponenty ze starej lokalizacji. Usuń te katalogi zaimportowane z pliku .unitypackage:

  • Assets/ExternalDependencyManager
  • Assets/GoogleMobileAds
  • Assets/Plugins/Android/googlemobileads-unity.aar
  • Assets/Plugins/Android/GoogleMobileAdsPlugin
  • Assets/Plugins/iOS/GADUAdNetworkExtras
  • Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM z interfejsem

  1. Otwórz ustawienia menedżera pakietów wybierając w menu Unity opcję Edit > Project Settings > Package Manager (Edytuj > Ustawienia projektu > Menedżer pakietów).

  2. Dodaj OpenUPM jako rejestr o ograniczonym zakresie w oknie Menedżer 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ę Window > Package Manager (Okno > Menedżer pakietów).

  4. W menu zakresu menedżera wybierz My Registries (Moje rejestry).

  5. Na liście pakietów wybierz pakiet Google Mobile Ads for Unity (Reklamy mobilne Google dla środowiska Unity) i kliknij Install (Zainstaluj).

Usuwanie komponentów wtyczki .unitypackage

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

  • Assets/ExternalDependencyManager
  • Assets/GoogleMobileAds
  • Assets/Plugins/Android/googlemobileads-unity.aar
  • Assets/Plugins/Android/GoogleMobileAdsPlugin
  • Assets/Plugins/iOS/GADUAdNetworkExtras
  • Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

  1. Pobierz tag wersji najnowszej wersji. Tag zwrócony, bez prefiksu v to wersja Google Mobile Ads Unity Plugin.

    • macOS i Linux

      curl -sS https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest | jq -r '.tag_name'

    • Windows PowerShell

      (Invoke-RestMethod -Uri "https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest").tag_name

  2. Zmodyfikuj plik Packages/manifest.json, aby dodać rejestr i zależność o ograniczonym zakresie OpenUPM, używając wersji uzyskanej z poprzedniego polecenia:

    {
  "scopedRegistries": [
    {
      "name": "google",
      "url": "https://package.openupm.com",
      "scopes": [
        "com.google"
      ]
    }
  ],
  "dependencies": {
    "com.google.ads.mobile": "11.5.0"
  }
}

Usuwanie komponentów wtyczki .unitypackage

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

  • Assets/ExternalDependencyManager
  • Assets/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 wersję .unitypackage z GitHuba.
  2. Zaimportuj plik .unitypackage, wybierając w menu Unity opcję Assets > Import package > Custom Package (Zasoby > Importuj pakiet > Własny pakiet) i importując wszystkie elementy.

Ustawianie identyfikatora aplikacji Ad Managera

W edytorze Unity w menu wybierz Assets > Google Mobile Ads > Settings (Zasoby > Reklamy mobilne Google > Ustawienia).

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

Google Mobile Ads Unity Plugin zapisuje te ustawienia jako tekst w pliku konfiguracji Assets/GoogleMobileAds/Resources/GoogleMobileAdsSettings.asset.

Inicjowanie pakietu SDK

Zanim aplikacja wczyta reklamy, musi zainicjować Google Mobile Ads Unity Plugin przez wywołanie MobileAds.Initialize(). Należy to zrobić tylko raz, najlepiej przy uruchomieniu aplikacji.

Oto przykład wywołania funkcji MobileAds.Initialize():

MobileAds.Initialize((InitializationStatus initstatus) => { if (initstatus == null) { Debug.LogError("Google Mobile Ads initialization failed."); return; } Debug.Log("Google Mobile Ads initialization complete."); MobileAdsEventExecutor.ExecuteInUpdate(() => { // Interact with UnityEngine objects on the main thread here. }); });

Interakcja z obiektami Unity w wątku głównym

Google Mobile Ads Unity Plugin wywołuje zdarzenia reklam w wątku w tle. Jeśli wywołania zwrotne reklam wchodzą w interakcję z obiektami Unity, takimi jak UnityEngine, wyraźnie zaplanuj tę pracę w wątku głównym Unity za pomocą metody MobileAdsEventExecutor.ExecuteInUpdate. Szczegółowe informacje o implementacji, zobacz Wywoływanie zdarzeń reklam w wątku głównym Unity.

Wybierz format reklamy

Google Mobile Ads Unity Plugin jest teraz dołączana do aplikacji Unity podczas wdrażania na platformie Android lub iOS. Możesz teraz zaimplementować reklamę. AdMob oferuje wiele różnych formatów reklam, dzięki czemu możesz wybrać ten, który zapewnia najlepsze wrażenia użytkownika.

W jednostkach banerów reklamowych wyświetlane są 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.

Implementowanie banerów reklamowych

Pełnoekranowa

Pełnoekranowe jednostki reklamowe wyświetlają w Twojej aplikacji reklamy na całej stronie. Zamieść je w naturalnych przerwach i etapach przejściowych działania interfejsu aplikacji, na przykład po ukończeniu poziomu w grze mobilnej.

Implementowanie reklam pełnoekranowych

Natywna

Reklamy natywne to reklamy, w których możesz dostosować sposób prezentowania w aplikacjach komponentów takich jak nagłówki i wezwania do działania. Dzięki samodzielnemu stylowi reklamy możesz tworzyć naturalne, nienachalne prezentacje reklam, które mogą wzbogacić wrażenia użytkowników.

Implementowanie 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 elementy, które otrzymają użytkownicy.

Implementowanie reklam z nagrodą