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 Unity Editor w wersji 2019.4 lub nowszej.
  • Zalecamy wersję 2022.2 lub nowszą.
• Wdrażanie na iOS
  • Xcode w wersji 16.0 lub nowszej
  • Kierowanie na iOS 13.0 lub nowszy
  • CocoaPods
• Aby wdrożyć aplikację na Androida:
  • Minimalny poziom interfejsu API Androida to 24 lub wyższy.
  • kierować aplikację na Androida w wersji API 35 lub nowszej;

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 .unitypackage na OpenUPM, musisz ręcznie odinstalować komponenty ze starej lokalizacji. Usuń te katalogi, które zostały zaimportowane z .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 określonym zakresie w oknie Package Manager:

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

3. Otwórz menu menedżera pakietów, wybierając opcję menu Unity Window > Package Manager.

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

   

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

Usuwanie komponentów wtyczki .unitypackage

Jeśli przechodzisz z .unitypackage na OpenUPM, musisz ręcznie odinstalować komponenty ze starej lokalizacji. Usuń te katalogi, które zostały zaimportowane z .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ść OpenUPM w zakresie, 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 .unitypackage na OpenUPM, musisz ręcznie odinstalować komponenty ze starej lokalizacji. Usuń te katalogi, które zostały zaimportowane z .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 (Zasoby) > Google Mobile Ads (Reklamy mobilne Google) > Settings (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 Assets/GoogleMobileAds/Resources/GoogleMobileAdsSettings.asset konfiguracyjnym.

Inicjowanie pakietu SDK

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

Ostrzeżenie: reklamy mogą być wstępnie wczytywane przez pakiety SDK Google Mobile Ads Unity Plugin lub partnera zapośredniczenia po wywołaniu funkcji MobileAds.Initialize(). Jeśli musisz uzyskać zgodę użytkowników z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii lub Szwajcarii, ustaw dowolne flagi dotyczące konkretnego żądania, np. tagForChildDirectedTreatment lub tag_for_under_age_of_consent, albo podejmij inne działania przed wczytaniem reklam. Zanim zainicjujesz Google Mobile Ads Unity Plugin, sprawdź, czy to robisz.

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.
    });
});
GoogleMobileAdsController.cs

Wchodzenie w interakcję z obiektami Unity w wątku głównym

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

Wybierz format reklamy

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

Baner

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.

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 grze mobilnej.

Wdrażanie reklam pełnoekranowych

Natywna

Reklamy natywne to reklamy, w których możesz dostosować sposób wyświetlania w aplikacjach zasobó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ą wzbogacać wrażenia użytkowników.

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 elementy, które otrzymał użytkownik.

Wdrażanie reklam z nagrodą