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

Integracja Unity Ads 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 Zapośredniczenie AdMob, 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

¹ Integracja ustalania stawek jest zamknięta w wersji 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
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.

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.

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.

Możesz wymusić tryb testowy aplikacji, klikając przycisk edycji obok Sklep Google Play , zaznacz Zastąp tryb testowy klienta i wybierz Wymuś włączenie trybu testowego (tj. 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 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 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 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 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. Zobacz kod .