Integracja Unity Ads z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Unity Ads przy użyciu mediacji, która obejmuje integrację kaskadową. Znajdziesz w nim informacje o tym, jak dodać Unity Ads do konfiguracji pośrednictwa jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Unity Ads z aplikacją Flutter.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dla Unity Ads ma te możliwości:

Integracja
Określanie stawek  1
Wodospad
Formaty
Baner
Pełnoekranowa
Z nagrodą

1 Integracja określania stawek jest w wersji beta dostępnej publicznie.

Wymagania

  • Najnowsza wersja pakietu SDK do reklam mobilnych Google
  • Flutter w wersji 3.7.0 lub nowszej
  • [Do określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w określaniu stawek, użyj wtyczki Google Mobile Ads do pośrednictwa reklamowego w Unity Ads w wersji 1.1.0 lub nowszej (zalecana najnowsza wersja).
  • Aby wdrożyć na Androidzie:
    • interfejsu API na poziomie 23 lub wyższym,
  • Aby wdrożyć aplikację na iOS:
    • docelowa wersja iOS 12.0 lub nowsza,
  • działający projekt Flutter skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.

Krok 1. Skonfiguruj ustawienia w interfejsie Unity Ads

Zarejestruj lub zaloguj się w Unity Ads.

Utwórz projekt

W panelu Unity Ads otwórz Projekty i kliknij Nowy.

Wypełnij formularz i kliknij Utwórz, aby dodać projekt.

Kliknij kolejno Zarabianie na reklamach Unity Ads i Rozpocznij.

W oknie Nowy projekt kliknij Użyję pośrednictwa i Google AdMob w sekcji Partner pośredniczący, a potem kliknij Dalej.

Wybierz opcję ustawień reklam, a potem kliknij Dalej.

Wybierz ustawienia miejsca docelowego, a potem kliknij Dalej.

Określanie stawek

Wodospad

Wypełnij formularz i kliknij Dodaj projekt.

Zanotuj identyfikator gry.

Tworzenie jednostek reklamowych i miejsc docelowych

Kliknij kolejno Zarabianie na reklamach Unity Ads > Miejsca docelowe, wybierz swój projekt i kliknij Dodaj jednostkę reklamową.

Wpisz Nazwa jednostki reklamowej, a następnie wybierz Platformę i Format reklamy.

Android

iOS

Określanie stawek

W sekcji Konfiguracja wybierz Określanie stawek. W sekcji Miejsce docelowe wpisz nazwę miejsca docelowego.

Zanotuj identyfikator miejsca docelowego.

Wodospad

W sekcji Konfiguracja wybierz Kaskada. W sekcji Placement (Miejsce docelowe) wpisz Name of placement (Nazwa miejsca docelowego), GEO Tagging (Tagowanie geograficzne) i Target (Cele).

Zanotuj identyfikator miejsca docelowego.

Na koniec kliknij Dodaj jednostkę reklamową, aby zapisać jednostkę reklamową i miejsce docelowe.

Znajdowanie klucza interfejsu API do raportowania Unity Ads

Określanie stawek

Ten krok nie jest wymagany w przypadku integracji określania stawek.

Wodospad

Kliknij Generowanie przychodów z reklam Unity Ads > Zarządzanie interfejsem API i zapisz klucz interfejsu API w sekcji Dostęp do interfejsu Monetization Stats API.

Następnie kliknij Zarabianie w Unity Ads > Ustawienia organizacji i zapisz główny identyfikator organizacji.

Zaktualizuj plik app-ads.txt

Authorized Sellers for Apps (plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec utracie przychodów z reklam, użyj pliku app-ads.txt. Jeśli jeszcze tego nie zrobiono, utwórz plik app-ads.txt na potrzeby Ad Managera.

Aby zaimplementować app-ads.txt w Unity Ads, zapoznaj się z informacjami o pierwszym konfigurowaniu pliku app-ads.txt.

Włączanie trybu testowego

Tryb testowy można włączyć w panelu Unity Ads. Kliknij Generowanie przychodu z Unity Ads > Testowanie.

Tryb testowy możesz włączyć w swojej aplikacji, klikając przycisk edycji na każdej platformie, zaznaczając opcję Anuluj tryb testowy klienta i wybierając Włącz tryb testowy (czyli używaj reklam testowych) na wszystkich urządzeniach.

Android

iOS

Możesz też włączyć tryb testowy na określonych urządzeniach, klikając Dodaj urządzenie testowe.

Wpisz szczegóły urządzenia testowego i kliknij Zapisz.

Krok 2. Skonfiguruj popyt Unity Ads w interfejsie AdMob

Konfigurowanie ustawień pośrednictwa dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.

Dodawanie Unity Ads do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA

Wykonaj czynności opisane w ustawieniach dotyczących europejskich przepisów i amerykańskich przepisów stanowych, aby dodać Unity Ads do listy partnerów reklamowych w ramach europejskich i amerykańskich przepisów stanowych w interfejsie AdMob.

Krok 3. Zaimportuj pakiet SDK i adapter Unity Ads

Integracja za pomocą pub.dev

Dodaj te zależności z najnowszymi wersjami pakietu SDK i adaptera Unity Ads w pliku pubspec.yaml pakietu:

dependencies:
  gma_mediation_unity: ^

Integracja ręczna

Pobierz najnowszą wersję wtyczki pośredniczącej reklam mobilnych Google do Unity Ads, wyodrębnij pobrany plik i dodaj wyodrębniony folder wtyczki (oraz jego zawartość) do projektu Flutter. Następnie odwołuj się do wtyczki w pliku pubspec.yaml, dodając tę zależność:

dependencies:
  gma_mediation_unity:
    path: path/to/local/package

Krok 4. Wdróż ustawienia prywatności w pakiecie SDK Unity Ads

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz zadbać o to, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali odpowiednie informacje i wyrazili zgodę na wykorzystywanie identyfikatorów urządzeń i danych osobowych. Polityka ta odzwierciedla wymagania UE zawarte w dyrektywie o prywatności i łączności elektronicznej oraz w Ogólnym rozporządzeniu o ochronie danych (RODO). Aby uzyskać zgodę, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub używać danych osobowych, oraz podać informacje o wykorzystywaniu tych danych przez każdą z nich. Obecnie Google nie może automatycznie przekazywać wyboru użytkownika dotyczącego wyrażenia zgody do takich sieci.

Wtyczka zapośredniczenia reklam mobilnych Google dla Unity Ads wykorzystuje metodęGmaMediationUnity.setGDPRConsent(). Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu Unity Ads SDK. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setGDPRConsent(true);

Więcej informacji oraz wartości, które można podać w ramach poszczególnych metod, znajdziesz w przewodnikach API dotyczące zgody na wykorzystanie danych i prywatności i Zgodność z RODO Unity Ads.

Amerykańskie przepisy stanowe o ochronie prywatności

Przepisy stanowe w USA wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” swoich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu na stronie głównej podmiotu „sprzedającego” musi się znajdować dobrze widoczny link „Nie sprzedawaj moich danych osobowych”. Przewodnik dotyczący zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w celu wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia w przypadku każdej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność.

Wtyczka zapośredniczenia reklam mobilnych Google dla Unity Ads wykorzystuje metodęGmaMediationUnity.setCCPAConsent(). Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu Unity Ads SDK. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

Krok 5. Dodaj wymagany kod

Android

Integracja Unity Ads na Androida nie wymaga dodatkowego kodu.

iOS

Integracja z SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją Unity Ads.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob i włączyć tryb testowy w interfejsie Unity Ads.

Weryfikacja reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z Unity Ads, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając z źródeł reklam Unity Ads (z określaniem stawek) i Unity Ads (kaskadowe).

Kody błędów

Jeśli adapter nie otrzyma reklamy z Unity Ads, wydawcy mogą sprawdzić błąd podstawowy w odpowiedzi reklamy, korzystając z funkcji ResponseInfo w tych klasach:

Android

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

iOS

GADMAdapterUnity
GADMediationAdapterUnity

Oto kody i odpowiednie komunikaty zwracane przez adapter UnityAds, gdy nie udaje się załadować reklamy:

Android

Kod błędu Przyczyna
0-10 Pakiet SDK UnityAds zwrócił błąd. Więcej informacji znajdziesz w kodowaniu.
101 Parametry serwera UnityAds skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje.
102 UnityAds zwrócił miejsce docelowe ze stanem NO_FILL.
103 UnityAds zwrócił miejsce docelowe w stanie WYŁĄCZONO.
104 UnityAds próbował wyświetlić reklamę z kontekstem o wartości null.
105 Kontekst używany do inicjowania, wczytywania lub wyświetlania reklam z Unity Ads nie jest wystąpieniem Activity.
106 UnityAds próbował wyświetlić reklamę, która nie jest gotowa do wyświetlenia.
107 Na urządzeniu nie można korzystać z UnityAds.
108 UnityAds może wczytywać tylko 1 reklamę na miejsce docelowe naraz.
109 UnityAds zakończyło działanie w stanie BŁĄD.
200-204 UnityAds Banner a specific error. Więcej informacji znajdziesz w kodowaniu.

iOS

0-9 Pakiet SDK UnityAds zwrócił błąd. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją Unity.
101 Parametry serwera UnityAds skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje.
102 Urządzenie nie jest obsługiwane przez UnityAds.
103 UnityAds zakończyło prezentowanie z błędem kUnityAdsFinishStateError.
104 Po wywołaniu inicjalizatora obiekt reklamy w Unity jest pusty.
105 Nie udało się wyświetlić reklamy Unity Ads, ponieważ reklama nie jest gotowa.
107 UnityAds wywołało wywołanie zwrotne po zmianie miejsca docelowego o stanie kUnityAdsPlacementStateDisabled.
108 Reklama została już załadowana w tym miejscu docelowym. Pakiet SDK UnityAds nie obsługuje wczytywania wielu reklam w przypadku tego samego miejsca docelowego.
109 Baner reklamowy zwrócony przez UnityAds nie pasuje do żądanego rozmiaru.
110 UnityAds zwrócił błąd inicjalizacji.
111 Nieobsługiwany format reklamy.

changelog adaptera zapośredniczenia Fluttera Unity Ads;

Wersja 1.4.0

  • Skompilowano i przetestowano za pomocą wtyczki Flutter do reklam mobilnych Google w wersji 6.0.0.

Wersja 1.3.0

  • Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla Fluttera w wersji 5.3.1.

Wersja 1.2.0

  • Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla Fluttera w wersji 5.3.1.

Wersja 1.1.0

  • Skompilowano i przetestowano z użyciem wtyczki Google Mobile Ads dla Fluttera w wersji 5.2.0.

Wersja 1.0.0

  • Skompilowano i przetestowano za pomocą wtyczki Google Mobile Ads dla Fluttera w wersji 5.0.0.