Ta strona została przetłumaczona przez Cloud Translation API.

Integracja Unity Ads z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Unity Ads za pomocą zapośredniczenia AdMob,integracji kaskadowej. Dowiesz się z niego, jak dodać reklamy Unity do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować z Android aplikacją pakiet SDK i adapter Unity Ads.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia do Unity Ads ma następujące możliwości:

Integracja
Ustalanie stawek	¹
Wodospad
Formaty
Baner
Pełnoekranowa
Otrzymano
Natywna

¹ Integracja określania stawek jest w fazie zamkniętych testów beta. Skontaktuj się ze swoim menedżerem konta i poproś o dostęp.

Wymagania

Interfejs API Androida na poziomie 21 lub wyższym

Najnowszy pakiet SDK do reklam mobilnych Google
Wykonaj zapośredniczenie Przewodnik dla początkujących

Krok 1. Skonfiguruj konfiguracje w interfejsie Unity Ads

Zarejestruj się lub zaloguj w Unity Ads.

Tworzenie projektu

W panelu reklam Unity otwórz Projects (Projekty) i kliknij Create Project (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 Chcę korzystać z zapośredniczenia i Google AdMob w polu Partner zapośredniczenia, a potem 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, a następnie kliknij Dodaj jednostkę reklamową.

Wpisz nazwę jednostki reklamowej, a potem wybierz opcje Platforma i Format reklamy.

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

Dodaj miejsce docelowe

Ustalanie stawek

Aby utworzyć miejsca docelowe z ustalaniem stawek, skontaktuj się z menedżerem konta Unity Ads.

Wodospad

Po utworzeniu projektu kliknij Generowanie przychodu > Miejsca docelowe. Aby utworzyć nowe miejsce docelowe, kliknij Dodaj miejsce docelowe obok jednostki reklamowej.

Podaj niezbędne informacje i kliknij Dodaj miejsce docelowe.

Zanotuj identyfikator miejsca docelowego.

Znajdź klucz interfejsu Unity Ads Reporting API

Ustalanie stawek

Nie musisz tego robić w przypadku integracji z określaniem stawek.

Wodospad

Oprócz identyfikatora gry i identyfikatora miejsca docelowego do skonfigurowaniaAdMob identyfikatora jednostki reklamowej będą też potrzebne klucz interfejsu API Unity Ads i główny identyfikator organizacji.

Kliknij Zarabianie > Konfiguracja > Zarządzanie interfejsem API i zanotuj klucz dostępu do interfejsu Monetization Stats API.

Następnie otwórz Zarabianie > Ustawienia organizacji i zanotuj podstawowy identyfikator organizacji.

Włącz tryb testowy

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

Aby wymusić tryb testowy w swojej aplikacji, kliknij przycisk edycji obok: Sklep Google Play , zaznacz Zastąp tryb testowy klienta i wybierz Wymuś włączenie trybu testowego (czyli używaj reklam testowych) na wszystkich urządzeniach.

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

Musisz dodać Unity Ads do konfiguracji zapośredniczenia jednostki reklamowej.

Najpierw zaloguj się na swoje konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź od razu do sekcji Dodawanie Unity Ads jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, wybierz Utwórz grupę zapośredniczenia.

Podaj format reklamy i platformę, a następnie kliknij Dalej.

Nazwij grupę zapośredniczenia i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z co najmniej jedną istniejącą jednostką reklamowąAdMob . Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny się pojawić wybrane przez Ciebie jednostki reklamowe:

Dodaj Unity Ads jako źródło reklam

Ustalanie stawek

Na karcie Określanie stawek w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie kliknij Unity Ads.

Kliknij Jak podpisać umowę partnerską i zawrzeć umowę partnerską z firmąUnity Ads.

Kliknij Potwierdzam i akceptuję, a następnie kliknij Dalej.

Jeśli masz już mapowanie Unity Ads, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz dane Game ID and Placement IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.

Ważne: Game ID musi być powiązany z aplikacją docelową, tak jak w interfejsieUnity Ads .

Wodospad

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklamy. Następnie kliknij Unity Ads.

Kliknij Unity Ads i włącz przełącznik Optymalizuj. Wpisz API Key and Organization core IDuzyskane w poprzedniej sekcji, aby skonfigurować optymalizację źródła reklam dla:Unity Ads. Następnie wpisz wartość eCPM dlaUnity Ads i kliknij Dalej.

Jeśli masz już mapowanie Unity Ads, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz dane Game ID and Placement IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.

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 z Android Studio (zalecana)

W pliku build.gradle.kts na poziomie aplikacji dodaj poniższe zależności i konfiguracje implementacji. Użyj najnowszych wersji pakietu SDK i adaptera Unity Ads:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.unity3d.ads:unity-ads:4.12.1")
    implementation("com.google.ads.mediation:unity:4.12.1.0")
}

Integracja ręczna

Pobierz najnowszy pakiet SDK Unity Ads (unity-ads.aar) ze swojego repozytorium GitHub i dodaj go do swojego projektu.
Otwórz artefakty adaptera Unity Ads w repozytorium Google Maven. Wybierz najnowszą wersję, pobierz plik .aar adaptera Unity Ads i dodaj go do projektu.

Krok 4. Wdróż ustawienia prywatności w pakiecie SDK do wyświetlania reklam Unity

Zgoda użytkowników z UE i RODO

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali określone informacje na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz aby uzyskać od nich zgodę. 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). Podczas uzyskiwania zgody musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe, a także podać informacje o sposobie ich wykorzystania. Obecnie Google nie może automatycznie przekazać tym sieciom wyboru użytkownika dotyczącego zgody.

W pakiecie SDK w wersji 2.0.0 dodano interfejs API do obsługi ustawień prywatności. Poniższy przykładowy kod pokazuje, jak przekazać informacje o zgodzie do pakietu SDK Unity Ads. Jeśli zdecydujesz się ręcznie przekazywać informacje o zgodzie do pakietu SDK Unity Ads, zalecamy wywołanie tego kodu przed wysłaniem żądania reklam za pomocą tego pakietu.

Java

import com.unity3d.ads.metadata.MetaData;
// ...

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();

Kotlin

import com.unity3d.ads.metadata.MetaData
// ...

val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()

Więcej informacji oraz wartości, które można podać w przypadku poszczególnych metod, znajdziesz w przewodnikach poświęconych interfejsom API do uzyskiwania zgody na przetwarzanie danych i danych o prywatności. Zgodność z RODO

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają umożliwienia użytkownikom wycofania zgody na sprzedaż danych osobowych (w znaczeniu określonym w ustawie), za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej sprzedawcy. Przewodnik dotyczący zgodności z amerykańskimi przepisami stanowymi o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych na potrzeby wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia do każdej sieci reklamowej w łańcuchu zapośredniczenia. Musisz więc wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i zastosować się do zaleceń każdej z nich, by zapewnić zgodność z zasadami.

Java

import com.unity3d.ads.metadata.MetaData;
// ...

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();

Kotlin

import com.unity3d.ads.metadata.MetaData
// ...

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()

Więcej informacji oraz informacje o wartościach, które można podać w przypadku poszczególnych metod, znajdziesz w przewodnikach dotyczących interfejsów API dotyczących zgody na przetwarzanie danych i danych o prywatności i zachowania zgodności z ustawą CCPA

Krok 5. Dodaj wymagany kod

Integracje z Unity Ads nie wymagają dodatkowego kodu.

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ć błąd w odpowiedzi za pomocą polecenia ResponseInfo.getAdapterResponses() w ramach tych klas:

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

Oto kody i powiązane z nimi komunikaty wysyłane przez adapter UnityAds, gdy reklama się nie wczytuje:

Kod błędu	Przyczyna
0-10	Pakiet UnityAds SDK zwrócił komunikat o błędzie. Więcej informacji znajdziesz w opisie kodu.
101	Brak parametrów serwera UnityAds skonfigurowanych w AdMob interfejsie 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 związany z banerem UnityAds. Więcej informacji znajdziesz w opisie kodu.
0-9	Pakiet UnityAds SDK zwrócił komunikat o błędzie. Więcej informacji znajdziesz w dokumentacji Unity.
101	Brak parametrów serwera UnityAds skonfigurowanych w AdMob interfejsie 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	Parametr UnityAds nazywa się wywołaniem zwrotnym miejsca docelowego ze stanem miejsca docelowego kUnityAdsplacementStateDisabled.
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.