Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Unity Ads za pomocą zapośredniczenia, na temat integracji kaskadowych. Wyjaśniamy, jak dodać Unity Ads do konfiguracji zapośredniczenia i integracji pakietu SDK Unity Ads oraz adaptera Flutter aplikacji.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia AdMob do Unity Ads zawiera te funkcje:
| Integracja | |
|---|---|
| Określanie stawek | 1. |
| Wodospad | |
| Formaty | |
| Baner | |
| Pełnoekranowa | |
| Z nagrodą | |
Wymagania
- Najnowszy pakiet SDK do reklam mobilnych Google
- Flutter w wersji 3.7.0 lub nowszej
- Do wdrożenia na Androidzie
- Interfejs API Androida na poziomie 21 lub wyższym
- Do wdrożenia na iOS
- Cel wdrożenia iOS w wersji 12.0 lub nowszej
- Działający Flutter projekt skonfigurowany w Google Pakiet SDK do reklam mobilnych. Zobacz Rozpocznij, aby dowiedzieć się więcej.
- Dokończ zapośredniczenie Przewodnik dla początkujących
Krok 1. Skonfiguruj konfiguracje w interfejsie Unity Ads
Zarejestruj się lub zaloguj w Unity Ads.
Utwórz projekt
W panelu reklam Unity otwórz Projekty i kliknij Utwórz projekt.
Wypełnij formularz i kliknij Create Project (Utwórz projekt), aby dodać projekt.
Otwórz Zarabianie > Rozpocznij, a potem kliknij Rozpocznij.
W oknie Konfiguracja projektu wybierz Planuję korzystać z zapośredniczenia, a następnie Google AdMob dla partnera zapośredniczenia, a następnie kliknij Dalej.
Wybierz ustawienia reklam i kliknij Dalej.
Wypełnij formularz i kliknij Add Project (Dodaj projekt).
Zanotuj identyfikator gry.
Utwórz jednostkę reklamową
Otwórz Zarabianie > Jednostki reklamowe i kliknij Dodaj jednostkę reklamową.
Wpisz nazwę jednostki reklamowej, a potem wybierz opcje Platforma i Format reklamy.
Android
iOS
Na koniec kliknij Utwórz, aby zapisać jednostkę reklamową.
Dodaj miejsce docelowe
Określanie stawek
Aby utworzyć miejsca docelowe z ustalaniem stawek, skontaktuj się ze swoim menedżerem konta Google.
Wodospad
Po utworzeniu projektu kliknij Zarabianie > Miejsca docelowe. Do utwórz nowe miejsce docelowe, kliknij Dodaj miejsce docelowe.
Podaj niezbędne informacje i kliknij Dodaj miejsce docelowe.
Zanotuj identyfikator miejsca docelowego.
Android
iOS
Znajdź klucz interfejsu Unity Ads Reporting API
Określanie stawek
Nie musisz tego robić w przypadku integracji z określaniem stawek.
Wodospad
Oprócz identyfikatora gry i identyfikatora miejsca docelowego będziesz też potrzebować Klucz interfejsu API Unity Ads i główny identyfikator organizacji do skonfigurowania AdMob identyfikatora jednostki reklamowej.
Otwórz Zarabianie > Konfiguracja > Zarządzanie interfejsami API i zanotuj klucza dostępu do interfejsu Monetization Stats API.
Potem otwórz sekcję Zarabianie > Ustawienia organizacji i zapisz je podstawowego identyfikatora organizacji.
Włącz tryb testowy
Tryb testowy możesz włączyć w Panel Unity Ads W obszarze roboczym Twojego projektu kliknij kartę Testowanie.
Aby wymusić tryb testowy dla swojej aplikacji, kliknij przycisk edycji każdego z nich platformy, zaznaczając Zastąp tryb testowy klienta i wybierając Wymuś włączenie trybu testowego (tj. używaj reklam testowych) na wszystkich urządzeniach.
Android
iOS
Możesz też włączyć tryb testowy na konkretnych urządzeniach, klikając Przycisk Dodaj urządzenie testowe.
Wypełnij formularz i kliknij Zapisz.
Krok 2. Skonfiguruj żądania reklam Unity Ads w AdMob interfejsie
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 instrukcji na Androida.
iOS
Instrukcje znajdziesz w kroku 2 przewodnika po iOS.
Dodaj Unity Ads do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi
Wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia amerykańskich przepisów stanowych , aby dodać Unity Ads do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w AdMob UI.
Krok 3. Zaimportuj pakiet SDK Unity Ads i adapter
Integracja przez pub.dev
Dodaj tę zależność z najnowszymi wersjami
Unity Ads Pakiet SDK i adapter w pakiecie
Plik pubspec.yaml:
dependencies:
gma_mediation_unity: ^1.0.0
Integracja ręczna
Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla
Unity Ads
rozpakuj pobrany plik i dodaj wyodrębniony folder wtyczki
(i jego zawartość) do projektu Flutter. Następnie sprawdź informacje o wtyczce w
pubspec.yaml przez dodanie tej zależności:
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
Obowiązujące w Google zgoda użytkownika z UE Google, musisz dopilnować, aby takie oświadczenia zostały ujawnione. zgody uzyskane od użytkowników z Europejskiego Obszaru Gospodarczego dotyczące: wykorzystywania identyfikatorów urządzeń i danych osobowych. Zasady te odzwierciedlają wymagania unijnej dyrektywy o prywatności i łączności elektronicznej oraz Ogólnej ustawy o ochronie danych Rozporządzenie (RODO). Wyświetlając prośbę o zgodę na wykorzystanie danych, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe i dostarczają informacji o korzystaniu z poszczególnych sieci. Google obecnie nie może automatycznego przekazywania do takich sieci wyboru użytkownika dotyczącego zgody.
Wtyczka zapośredniczenia do reklam mobilnych Google dla Unity Ads
obejmuje
GmaMediationUnity.setGDPRConsent()
. Poniższy przykładowy kod pokazuje, jak przekazać informacje o zgodzie do
pakietu SDK Unity Ads. Jeśli chcesz wywoływać tę metodę, zalecamy wykonanie
więc 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);
Zobacz reklamy Unity Interfejsy API związane z prywatnością i prywatnością oraz Zgodność z RODO zawiera więcej informacji i wartości, które można podać w przypadku poszczególnych metod.
Amerykańskie przepisy stanowe o ochronie prywatności
Stany Zjednoczone przepisy stanowe o ochronie prywatności wymagają dawania użytkownikom zrezygnować z „wyprzedaży”, „danych osobowych” (zgodnie z definicją w ustawie tych haseł) z opcją rezygnacji dostępną za pomocą dobrze widocznego powiadomienia „Nie sprzedawaj Informacje” w wierszu „sprzedaż”, na stronie głównej strony. Stany Zjednoczone stanowa prywatność użytkowników przewodnik dotyczący zgodności z przepisami prawa umożliwia włączenie ograniczone przetwarzanie danych wyświetlania reklam przez Google, ale Google nie może stosować tego ustawienia do poszczególnych reklam w łańcuchu zapośredniczenia. W przypadku każdej sieci reklamowej należy w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży i postępuj zgodnie ze wskazówkami dotyczącymi tych sieci, aby zapewnić zgodność z przepisami.
Wtyczka zapośredniczenia do reklam mobilnych Google dla Unity Ads
obejmuje
GmaMediationUnity.setCCPAConsent()
. Poniższy przykładowy kod pokazuje, jak przekazać informacje o zgodzie do
pakietu SDK Unity Ads. Jeśli chcesz wywoływać tę metodę, zalecamy wykonanie
więc 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
Integracje z Unity Ads na Androida nie wymagają dodatkowego kodu.
iOS
Integracja SKAdNetwork
Obserwuj Unity Ads' dokumentacja
aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu.
Krok 6. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby AdMob i włącz tryb testowy w Unity Ads interfejsie użytkownika.
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyUnity Ads, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z Unity Ads (Waterfall) źródeł reklam.
Kody błędów
Jeśli adapter nie otrzyma reklamy z Unity Ads, wydawcy mogą sprawdzić
bazowego błędu w odpowiedzi na żądanie reklamy za pomocą funkcji
ResponseInfo w
następujące klasy:
Android
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
iOS
GADMAdapterUnity
GADMediationAdapterUnity
Oto kody i powiązane z nimi komunikaty wysyłane przez adapter UnityAds, gdy: nie można wczytać reklamy:
Android
| Kod błędu | Przyczyna |
|---|---|
| 0-10 | Pakiet UnityAds SDK zwrócił komunikat o błędzie. Zobacz kod . |
| 101 | W interfejsie AdMob brakuje parametrów serwera UnityAds lub są one nieprawidłowe. |
| 102 | UnityAds zwróciło miejsce docelowe ze stanem NO_FILL. |
| 103 | UnityAds zwróciło miejsce docelowe ze stanem DISABLED. |
| 104 | UnityAds próbowała wyświetlić reklamę bez kontekstu. |
| 105 | Kontekst używany do inicjowania, wczytywania lub wyświetlania reklam z Unity Ads nie jest instancją aktywności. |
| 106 | Firma UnityAds próbowała wyświetlić reklamę, która nie jest gotowa do wyświetlenia. |
| 107 | Urządzenie nie obsługuje UnityAds. |
| 108 | UnityAds może wczytywać tylko 1 reklamę na miejsce docelowe naraz. |
| 109 | Reklamy UnityAds zakończyły działanie ze stanem ERROR (błąd). |
| 200-204 | Błąd banera UnityAds. Zobacz kod . |
iOS
| 0-9 | Pakiet UnityAds SDK zwrócił komunikat o błędzie. Zobacz dokumentację Unity . |
| 101 | W interfejsie AdMob brakuje parametrów serwera UnityAds lub są one nieprawidłowe. |
| 102 | Urządzenie nieobsługiwane przez UnityAds. |
| 103 | Reklamy UnityAds zakończyły prezentację ze stanem błędu kUnityAdsFinishStateError. |
| 104 | Po wywołaniu inicjatora obiekt reklamy Unity jest pusty. |
| 105 | Nie udało się wyświetlić reklam Unity, ponieważ reklama nie jest gotowa. |
| 106 | Nazwa miejsca docelowego UnityAds nazywa się wywołaniem zwrotnym ze stanem miejsca docelowego kUnityAdsplacementStateNoFill. |
| 107 | Metoda UnityAds nazywa się wywołaniem zwrotnym ze stanem miejsca docelowego kUnityAdsDestinationStateDisabled. |
| 108 | Reklama na potrzeby tego miejsca docelowego została już wczytana. Pakiet UnityAds SDK nie obsługuje wczytywania wielu reklam w przypadku tego samego miejsca docelowego. |
Historia zmian adaptera zapośredniczenia Flutter w reklamach Unity
Wersja 1.0.0
- Pierwsza wersja.
- Zweryfikowano zgodność z adapterem Unity na Androida w wersji 4.10.0.0
- Zweryfikowano zgodność z adapterem systemu iOS Unity w wersji 4.10.0.0