Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania z reklam myTarget za pomocą zapośredniczenia. na temat integracji kaskadowych. Wyjaśniamy, jak dodać element myTarget do konfiguracji zapośredniczenia i integracji pakietu SDK myTarget z adapterem. i aplikacja na Unity.
Obsługiwane integracje i formaty reklam
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Reklama pełnoekranowa z nagrodą |
Wymagania
- Unity 4 lub nowsza
- Najnowszy pakiet SDK do reklam mobilnych Google
- 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 projekt w Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Zobacz Rozpocznij, aby dowiedzieć się więcej.
- Dokończ zapośredniczenie Przewodnik dla początkujących
Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika myTarget
Najpierw zarejestruj się lub zaloguj na konto myTarget. Otwórz stronę Aplikacje, klikając APLIKACJE w nagłówku. Aby dodać aplikację, kliknij DODAJ APLIKACJĘ.
Jeśli Twoja aplikacja obsługuje zarówno platformy Android, jak i iOS, musisz skonfigurować każdą z nich osobno.
Android
Następnie podaj adres URL swojej aplikacji w Google Play.
iOS
Następnie podaj adres URL w iTunes** swojej aplikacji.
Gdy dodajesz aplikację, myTarget musisz utworzyć jednostkę reklamową, zanim zakończysz ten proces.
Baner
Wybierz BANNER z dostępnych formatów reklam i kliknij przycisk BANNER.
Pełnoekranowa
Spośród dostępnych formatów reklam wybierz REKLAMA PEŁNOEKRANOWA i kliknij przycisk DODAJ JEDNOSTKĘ REKLAMOWĄ.
Otrzymano
Wybierz FILM Z NAGRODĄ spośród dostępnych formatów reklamy i kliknij przycisk DODAJ JEDNOSTKĘ REKLAMOWĄ.
Natywna
Spośród dostępnych formatów reklam wybierz NATIVE, a potem kliknij DODAJ JEDNOSTKĘ REKLAMOWĄ.
Na stronie szczegółów jednostki reklamowej zanotuj identyfikator boksu, który znajdziesz w ustawieniach jednostki reklamowej jako slot_id. Ten identyfikator boksu zostanie użyty w następnej sekcji do skonfigurowania Ad Manager jednostki reklamowej.
Oprócz parametru slot_id potrzebujesz też tokena stałego dostępu myTarget, by skonfigurować identyfikator jednostki reklamowej AdMob. Otwórz kartę Profile (Profil) i wybierz Access Tokens (Tokeny dostępu). Kliknij Create Token (Utwórz token) lub Show Token (Pokaż token), aby wyświetlić Permanent Access Token (token stałego dostępu) myTarget.
Włącz tryb testowy
Wykonaj instrukcje podane w dokumentacji obiektu myTarget, aby dodać i skonfigurować urządzenie testowe w interfejsie użytkownika myTarget.
Krok 2. Skonfiguruj popyt w Ad Manager interfejsie myTarget
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 instrukcji na Android.
iOS
Instrukcje znajdziesz w kroku 2 przewodnika po iOS.
Dodaj Mail.ru 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ć Mail.ru do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w Ad Manager UI.
Krok 3. Zaimportuj pakiet SDK myTarget i adapter
Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla usługi myTarget
klikając link pobierania w
Historia zmian i wyodrębnij plik
GoogleMobileAdsMyTargetMediation.unitypackage
z pliku ZIP.
W edytorze projektów Unity, wybierz Assets (Zasoby) > Importuj pakiet > Niestandardowy zakres dat
Spakuj i znajdź plik GoogleMobileAdsMyTargetMediation.unitypackage
,
pobrano. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Potem kliknij Komponenty > Program do rozpoznawania usług Google Play > Program do rozpoznawania Androida > Wymuś
Zakończ. Biblioteka programu do rozpoznawania usług Unity Play będzie działać w zależności
od zera i skopiować zadeklarowane zależności
Katalog Assets/Plugins/Android
Twojej aplikacji w Unity.
Krok 4. Wdróż ustawienia prywatności w pakiecie SDK myTarget
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 aplikacji myTarget w wersji 2.1.0 zawiera
Metody SetUserConsent()
i SetUserAgeRestricted()
. Następująca próbka
pokazuje, jak przekazywać informacje o zgodzie użytkownika do pakietu SDK myTarget. Jeśli
tę metodę należy wywołać przed wysłaniem żądania
za pomocą pakietu SDK do reklam mobilnych Google.
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetUserConsent(true);
Jeśli wiadomo, że użytkownik jest objęty ograniczeniem wiekowym, możesz też wywołać funkcję
Metoda SetUserAgeRestricted()
.
MyTarget.SetUserAgeRestricted(true);
Zobacz cel myTarget Przewodnik po prywatności i RODO .
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 aplikacji myTarget w wersji 3.13.3 zawiera
Metoda SetCCPAUserConsent(bool)
. Poniższy przykładowy kod pokazuje, jak to zrobić
informacji o zgodzie użytkownika na wykorzystanie danych
do pakietu SDK myTarget. Jeśli wybierzesz tę metodę,
zalecamy zrobić to przed wysłaniem żądania reklam za pośrednictwem Google
Pakiet SDK do reklam mobilnych.
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetCCPAUserConsent(true);
Skontaktuj się z zespołem pomocy myTarget, aby uzyskać informacje o znajdziesz więcej informacji.
Krok 5. Dodaj wymagany kod
Android
Integracja z usługą myTarget nie wymaga dodatkowego kodu.
iOS
Integracja SKAdNetwork
Postępuj zgodnie z dokumentacją funkcji myTarget.
aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu.
Krok 6. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby Ad Manager i włącz tryb testowy w myTarget interfejsie użytkownika.
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynymyTarget, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z myTarget (Waterfall) źródeł reklam.
Kody błędów
Jeśli adapter nie otrzyma reklamy z metody myTarget, 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.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter
iOS
GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded
Oto kody i towarzyszące im komunikaty wysyłane przez adapter myTarget gdy nie można wczytać reklamy:
Android
Kod błędu | Przyczyna |
---|---|
100 | Pakiet myTarget SDK zwrócił komunikat o błędzie. |
101 | Brak parametrów serwera myTarget skonfigurowanych w Ad Manager interfejsie lub są one nieprawidłowe. |
102 | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez myTarget. |
103 | Żądanie reklamy nie jest ujednoliconym żądaniem reklamy natywnej. |
104 | Wczytana reklama natywna z elementu myTarget różni się od żądanej reklamy natywnej. |
105 | W wczytanej reklamie natywnej z elementu myTarget brakuje niektórych wymaganych komponentów (np. obrazu lub ikony). |
iOS
Kod błędu | Przyczyna |
---|---|
100 | Pakiet myTarget SDK nie ma jeszcze dostępnej reklamy. |
101 | Brak parametrów serwera myTarget skonfigurowanych w Ad Manager interfejsie lub są one nieprawidłowe. |
102 | Adapter myTarget nie obsługuje żądanego formatu reklamy. |
103 | Próbowano wyświetlić reklamę myTarget, która nie została wczytana. |
104 | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez myTarget. |
105 | Brak wymaganych komponentów reklamy natywnej. |
Historia zmian wtyczki myTarget Unity Mediation
Wersja 3.18.0
- Nazwa
DummyClient
została zmieniona naPlaceholderClient
. - Obsługuje adapter myTarget na Androida w wersji 5.22.1.0.
- Obsługuje adapter myTarget na iOS w wersji 5.21.6.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.2.0.
Wersja 3.17.1
- Obsługuje adapter myTarget na Androida w wersji 5.21.1.0.
- Obsługuje adapter myTarget na iOS w wersji 5.21.5.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.2.0.
Wersja 3.17.0
- Obsługuje adapter myTarget na Androida w wersji 5.21.0.0.
- Obsługuje adapter myTarget na iOS w wersji 5.21.4.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 3.16.2
- Obsługuje adapter myTarget na Androida w wersji 5.20.1.0.
- Obsługuje adapter myTarget na iOS w wersji 5.21.2.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 3.16.1
- Obsługuje adapter myTarget na Androida w wersji 5.20.1.0.
- Obsługuje adapter myTarget na iOS w wersji 5.21.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.0.0.
Wersja 3.16.0
- Obsługuje adapter myTarget na Androida w wersji 5.20.0.0.
- Obsługuje adapter myTarget na iOS w wersji 5.21.0.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.0.0.
Wersja 3.15.0
- Obsługuje adapter myTarget na Androida w wersji 5.20.0.0.
- Obsługuje adapter myTarget na iOS w wersji 5.20.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.7.0.
Wersja 3.14.0
- Obsługuje adapter myTarget na Androida w wersji 5.18.0.0.
- Obsługuje adapter myTarget na iOS w wersji 5.19.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.5.0.
Wersja 3.13.2
- Obsługuje adapter myTarget na Androida w wersji 5.16.5.0.
- Obsługuje adapter myTarget na iOS w wersji 5.17.5.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.3.0.
Wersja 3.13.1
- Przeniesiono treść adaptera do:
GoogleMobileAds/Mediation/MyTarget/
. - Przestrzeń nazw adaptera została zmieniona na
GoogleMobileAds.Mediation.MyTarget
. - Obsługuje adapter myTarget na Androida w wersji 5.16.4.1.
- Obsługuje adapter myTarget na iOS w wersji 5.17.4.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.1.0.
Wersja 3.13.0
- Obsługuje adapter myTarget na Androida w wersji 5.16.4.0.
- Obsługuje adapter myTarget na iOS w wersji 5.17.4.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.0.0.
Wersja 3.12.0
- Obsługuje adapter myTarget na Androida w wersji 5.15.5.0.
- Obsługuje adapter myTarget na iOS w wersji 5.16.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.3.0.
Wersja 3.11.4
- Obsługuje adapter myTarget na Androida w wersji 5.15.4.0.
- Obsługuje adapter myTarget na iOS w wersji 5.15.2.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.2.0.
Wersja 3.11.3
- Nazwa metody
IsConsent()
została zmieniona z klasyMyTarget
naGetUserConsent()
. - Do klasy
MyTarget
dodano te metody:SetCCPAUserConsent(bool)
GetCCPAUserConsent()
- Obsługuje adapter myTarget na Androida w wersji 5.15.3.0.
- Obsługuje adapter myTarget na iOS w wersji 5.15.2.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.2.0.
Wersja 3.11.2
- Obsługuje adapter myTarget na Androida w wersji 5.15.2.1.
- Obsługuje adapter myTarget na iOS w wersji 5.15.2.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.2.
Wersja 3.11.1
- Obsługuje adapter myTarget na Androida w wersji 5.15.1.0.
- Obsługuje adapter myTarget na iOS w wersji 5.15.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 3.11.0
- Obsługuje adapter myTarget na Androida w wersji 5.15.0.0.
- Obsługuje adapter myTarget na iOS w wersji 5.15.0.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 3.10.2
- Obsługuje adapter myTarget na Androida w wersji 5.14.4.0.
- Obsługuje adapter myTarget na iOS w wersji 5.14.4.0.
Wersja 3.10.1
- Obsługuje adapter myTarget na Androida w wersji 5.14.3.0.
- Obsługuje adapter myTarget na iOS w wersji 5.14.2.0.
Wersja 3.10.0
- Obsługuje adapter myTarget na Androida w wersji 5.14.2.0.
- Obsługuje adapter myTarget na iOS w wersji 5.14.1.0.
Wersja 3.9.0
- Obsługuje adapter myTarget na Androida w wersji 5.13.0.0.
- Obsługuje adapter myTarget na iOS w wersji 5.11.2.0.
Wersja 3.8.2
- Obsługuje adapter myTarget na Androida w wersji 5.11.7.0.
- Obsługuje adapter myTarget na iOS w wersji 5.9.10.0.
Wersja 3.8.1
- Obsługuje adapter myTarget na Androida w wersji 5.11.5.0.
- Obsługuje adapter myTarget na iOS w wersji 5.9.6.0.
Wersja 3.8.0
- Obsługuje adapter myTarget na Androida w wersji 5.11.4.0.
- Obsługuje adapter myTarget na iOS w wersji 5.9.5.0.
Wersja 3.7.0
- Obsługuje adapter myTarget na Androida w wersji 5.10.0.0.
- Obsługuje adapter myTarget na iOS w wersji 5.7.5.0.
Wersja 3.6.1
- Nazwa metody
MyTarget.IsUserConsent()
została zmieniona naMyTarget.IsConsent()
. - Obsługuje adapter myTarget na Androida w wersji 5.9.1.0.
- Obsługuje adapter myTarget na iOS w wersji 5.7.2.0.
Wersja 3.6.0
- Obsługuje adapter myTarget na Androida w wersji 5.9.0.0.
- Obsługuje adapter myTarget na iOS w wersji 5.7.0.0.
Wersja 3.5.2
- Obsługuje adapter myTarget na Androida w wersji 5.8.3.0.
- Obsługuje adapter myTarget na iOS w wersji 5.6.3.0.
Wersja 3.5.1
- Obsługuje adapter myTarget na Androida w wersji 5.8.2.0.
- Obsługuje adapter myTarget na iOS w wersji 5.6.1.0.
Wersja 3.5.0
- Obsługuje adapter myTarget na Androida w wersji 5.8.1.0.
- Obsługuje adapter myTarget na iOS w wersji 5.6.0.0.
Wersja 3.4.0
- Obsługuje adapter myTarget na Androida w wersji 5.8.0.0.
- Obsługuje adapter myTarget na iOS w wersji 5.5.2.0.
Wersja 3.3.0
- Obsługuje adapter myTarget na Androida w wersji 5.7.0.0.
- Obsługuje adapter myTarget na iOS w wersji 5.5.1.0.
Wersja 3.2.0
- Obsługuje adapter myTarget na Androida w wersji 5.6.3.0.
- Obsługuje adapter myTarget na iOS w wersji 5.4.9.0.
Wersja 3.1.0
- Obsługuje adapter myTarget na Androida w wersji 5.4.6.0.
- Obsługuje adapter myTarget na iOS w wersji 5.3.3.0.
Wersja 3.0.0
- Zaktualizowaliśmy wtyczkę, aby obsługiwała nowy interfejs API z nagrodą w otwartej wersji beta.
- Obsługuje adapter myTarget na Androida w wersji 5.3.9.0.
- Obsługuje adapter myTarget iOS w wersji 5.0.4.0.
Wersja 2.3.2
- Obsługuje adapter myTarget na Androida w wersji 5.2.5.0.
- Obsługuje adapter myTarget iOS w wersji 4.8.9.0.
Wersja 2.3.1
- Obsługuje adapter myTarget na Androida w wersji 5.2.5.0.
- Obsługuje adapter myTarget iOS w wersji 4.8.5.0.
Wersja 2.3.0
- Obsługuje adapter myTarget na Androida w wersji 5.2.2.0.
- Obsługuje adapter myTarget iOS w wersji 4.8.0.0.
Wersja 2.2.0
- Obsługuje adapter myTarget na Androida w wersji 5.1.4.0.
- Obsługuje adapter myTarget iOS w wersji 4.8.0.0.
Wersja 2.1.2
- Obsługuje adapter myTarget na Androida w wersji 5.1.3.0.
- Obsługuje adapter myTarget iOS w wersji 4.7.11.0.
Wersja 2.1.1
- Obsługuje adapter myTarget na Androida w wersji 5.1.1.0.
- Obsługuje adapter myTarget iOS w wersji 4.7.10.0.
Wersja 2.1.0
- Obsługuje pakiet myTarget Android SDK w wersji 5.1.0.
- Obsługuje pakiet myTarget iOS SDK w wersji 4.7.9.
- Dodano te metody:
- Metoda
MyTarget.SetUserConsent()
, aby przekazywać stan zgody użytkownika do pakietu SDK MyTarget. MyTarget.SetUserAgeRestricted
, który ustawia flagę, aby wskazać, że użytkownik jest objęty ograniczeniem wiekowym (tj. nie ma ukończonych 16 lat).- Metoda
MyTarget.IsUserConsent()
, która pozwala sprawdzić aktualny stan zgody użytkownika. MyTarget.IsUserAgeRestricted()
, aby otrzymać flagę wskazującą, że użytkownik korzysta z kategorii z ograniczeniem wiekowym (tj. nie ma ukończonych 16 lat).
- Metoda
Wersja 2.0.1
- Obsługuje pakiet myTarget Android SDK w wersji 5.0.2.
- Obsługuje pakiet myTarget iOS SDK w wersji 4.7.8.
Wersja 2.0.0
- Obsługuje pakiet myTarget Android SDK w wersji 5.0.0.
- Obsługuje pakiet myTarget iOS SDK w wersji 4.7.7.
Wersja 1.1.0
- Obsługuje pakiet myTarget Android SDK w wersji 4.7.2.
- Obsługuje pakiet myTarget iOS SDK w wersji 4.7.6.
Wersja 1.0.0
- Pierwsza wersja!
- Obsługuje pakiet myTarget Android SDK w wersji 4.6.27.
- Obsługuje pakiet myTarget iOS SDK w wersji 4.6.24.