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

AdMob Adapter pośredniczący Unity Ads ma te możliwości:

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

¹ Integracja ustalania stawek jest w zamkniętej fazie testów beta. Aby uzyskać dostęp, skontaktuj się z menedżerem konta.

Wymagania

• Najnowsza wersja pakietu SDK do reklam mobilnych Google
• Flutter 3.7.0 lub nowszy
• Aby wdrożyć na Androidzie:
  • Poziom interfejsu API 21 lub nowszy
• Aby wdrożyć aplikację na iOS:
  • docelowa wersja iOS 12.0 lub nowsza
• działający Flutter projekt 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 się lub zaloguj w Unity Ads.

Utwórz projekt

W panelu Unity Ads kliknij Projekty i wybierz Utwórz projekt.

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

Kliknij Zarabianie > Rozpocznij, a następnie Rozpocznij.

W oknie Konfiguracja projektu kliknij Zamierzam korzystać z pośrednictwa i Google AdMob w sekcji Partner do pośrednictwa, a potem kliknij Dalej.

Wybierz ustawienia reklamy i kliknij Dalej.

Wypełnij formularz i kliknij Dodaj projekt.

Zanotuj identyfikator gry.

Tworzenie jednostki reklamowej

Kliknij kolejno Generowanie przychodu > Jednostki reklamowe i Dodaj jednostkę reklamową.

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

Android

iOS

Na koniec kliknij Utwórz, aby zapisać jednostkę reklamową.

Dodawanie miejsca docelowego

Określanie stawek

Aby utworzyć miejsca docelowe ustalania stawek, skontaktuj się ze swoim menedżerem konta Google.

Wodospad

Po utworzeniu projektu kliknij Zarabianie > Miejsca docelowe. Aby utworzyć nowe miejsce docelowe, kliknij Dodaj miejsce docelowe dla swojej jednostki reklamowej.

Podaj niezbędne informacje i kliknij Dodaj miejsce.

Zanotuj identyfikator miejsca docelowego.

Android

iOS

Znajdowanie klucza interfejsu API do raportowania Unity Ads

Określanie stawek

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

Wodospad

Oprócz identyfikatora gry i identyfikatora miejsca docelowego do skonfigurowania identyfikatora jednostki reklamowej AdMob potrzebny będzie też klucz API i główny identyfikator organizacji Unity Ads.

Kliknij Zarabianie > Konfiguracja > Zarządzanie interfejsem API i zapisz klucz dostępu do interfejsu API Statystyki zarabiania.

Następnie otwórz Zarabianie > Ustawienia organizacji i zapisz identyfikator główny organizacji.

Włączanie trybu testowego

Tryb testowy można włączyć w panelu Unity Ads. W ustawieniach projektu kliknij kartę Testowanie.

Tryb testowy aplikacji możesz wymusić, klikając przycisk edycji na każdej platformie, zaznaczając Zastąp 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 przycisk Dodaj urządzenie testowe.

Wypełnij formularz i kliknij Zapisz.

Krok 2. Skonfiguruj zapotrzebowanie na reklamy Unity Ads w  AdMob UI

Konfigurowanie ustawień zapośredniczenia 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

Ważne: sprawdź, czy masz uprawnienia Zarządzanie kontem, aby skonfigurować zgodę użytkownika z UE i RODO, ustawę CPRA i Platformę do wysyłania wiadomości do użytkowników. Więcej informacji znajdziesz w artykule Zarządzanie dostępem użytkowników do konta.

Aby dodać Unity Ads do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w interfejsie AdMob, wykonaj czynności opisane w ustawieniach RODO i ustawieniach dotyczących przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter Unity Ads

Uwaga: brak integracji zgodnych wersji pakietów SDK Unity Ads i Google Mobile Ads może spowodować problemy z kompilacją.

Integracja przez pub.dev

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

dependencies:
  gma_mediation_unity: ^1.0.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki do zapośredniczenia reklam mobilnych Google dla 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

Zgoda użytkowników z UE i RODO

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 do mediowania reklam mobilnych Google dla Unity Adsobsługuje 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 dokumentach API dotyczące zgody na wykorzystanie danych i prywatności i wytycznych dotyczących zgodności z RODO Unity Ads.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności nakładają na Ciebie obowiązek zapewnienia użytkownikom możliwości wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu musisz umieścić na stronie głównej podmiotu sprzedającego dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”). Przewodnik po przepisach stanowych USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w przypadku 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 do mediowania reklam mobilnych Google dla Unity Adsobsługuje 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.

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy w AdMob i Unity Ads.

Weryfikowanie 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 (kaskadowych).

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 z poziomem DISABLED (WYŁĄCZONE).
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 aktywności.
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 finished presenting with error state 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.
106	UnityAds wywołało wywołanie zwrotne po zmianie miejsca docelowego z wartością kUnityAdsPlacementStateNoFill.
107	UnityAds wywołało wywołanie zwrotne zmiany miejsca docelowego z wartością 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.

Informacje o zmianach w Unity Ads Flutter Mediation Adapter

Wersja 1.1.0

• Weryfikowana zgodność z adapterem Unity Android w wersji 4.12.3.0
• Zweryfikowana zgodność z adapterem Unity iOS w wersji 4.12.3.1
• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.2.0.

Wersja 1.0.0

• Pierwsza wersja.
• Weryfikowana zgodność z adapterem Unity Android w wersji 4.10.0.0
• Weryfikowana zgodność z adapterem Unity iOS w wersji 4.10.0.0
• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.0.0.