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

Zintegruj reklamy z Unity z zapośredniczeniem

Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z Unity Ads wykorzystujące mediacji, na temat integracji kaskadowych. Wyjaśniamy, jak dodać Unity Ads do konfiguracji zapośredniczenia i integracji pakietu SDK Unity Ads oraz adaptera aplikację Android .

Obsługiwane integracje i formaty reklam

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

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

Wymagania

Interfejs API Androida na poziomie 21 lub wyższym

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

Krok 1. Skonfiguruj konfiguracje w interfejsie Unity Ads

Krok 2. Skonfiguruj żądania reklam Unity Ads w Ad Manager interfejsie

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 Ad Manager UI.

Krok 3. Zaimportuj pakiet SDK Unity Ads i adapter

Integracja z Android Studio (zalecana)

W pliku build.gradle.kts na poziomie aplikacji dodaj tę implementację zależności i konfiguracji. Użyj najnowszych wersji pakietu SDK Unity Ads i adapter:

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

Integracja ręczna

Pobierz najnowszy pakiet Unity Ads SDK (unity-ads.aar) ze swojego Repozytorium GitHub i dodaj ją do projektu.
Przejdź do Artefakty adaptera Unity Ads w repozytorium Google Maven. Wybierz najnowszą wersję i pobierz Unity .aar adaptera reklam i dodaj go do projektu.

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.

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

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()

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.

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()

Zobacz reklamy Unity Interfejsy API związane z prywatnością i prywatnością oraz Zgodność z ustawą CCPA zawiera więcej informacji i wartości, które można podać w przypadku poszczególnych metod.

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 Ad Manager 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 odbierze reklamy z Unity Ads, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi za pomocą polecenia ResponseInfo.getAdapterResponses() . w następujących klasach:

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: nie można wczytać reklamy:

Kod błędu	Przyczyna
0-10	Pakiet UnityAds SDK zwrócił komunikat o błędzie. Zobacz kod .
101	Brak parametrów serwera UnityAds skonfigurowanych w Ad Manager 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. Zobacz kod .