Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z usługi myTarget za pomocą zapośredniczenia obejmującego integrację kaskadową. Omawiamy sposób dodawania elementu myTarget do konfiguracji zapośredniczenia jednostki reklamowej oraz integrowania pakietu SDK i adaptera myTarget z aplikacją w Unity.
Obsługiwane integracje i formaty reklam
Integracja | |
---|---|
Ustalanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Otrzymano | |
Pełnoekranowa z nagrodą |
Wymagania
- Unity 4 lub nowsza
- Najnowszy pakiet SDK do reklam mobilnych Google
- Aby wdrożyć to na Androidzie:
- Interfejs API Androida na poziomie 21 lub wyższym
- Aby wdrożyć w iOS:
- Cel wdrożenia iOS w wersji 12.0 lub nowszej
- Działający projekt Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w pierwszych krokach.
- Wykonaj 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, korzystając z linku pobierania w dzienniku zmian i wyodrębnij GoogleMobileAdsMyTargetMediation.unitypackage
z pliku ZIP.
W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsMyTargetMediation.unitypackage
. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Następnie wybierz Zasoby > Program do rozpoznawania usług Google Play > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka programu do rozpoznawania nazw usług Unity Play przeprowadzi rozpoznawanie zależności od zera i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
aplikacji w Unity.
Krok 4. Wdróż ustawienia prywatności w pakiecie SDK myTarget
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.
Wtyczka zapośredniczenia do reklam mobilnych Google do aplikacji myTarget w wersji 2.1.0 zawiera metody SetUserConsent()
i SetUserAgeRestricted()
. Poniższy przykładowy kod pokazuje, jak przekazywać do pakietu SDK myTarget informacje o zgodzie użytkownika. Jeśli chcesz wywoływać tę metodę, zalecamy zrobienie tego przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetUserConsent(true);
Jeśli wiesz, że użytkownik jest objęty ograniczeniem wiekowym, możesz też wywołać metodę SetUserAgeRestricted()
.
MyTarget.SetUserAgeRestricted(true);
Więcej informacji znajdziesz w przewodniku myTarget dotyczącym prywatności i 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.
Wtyczka zapośredniczenia do reklam mobilnych Google do aplikacji myTarget w wersji 3.13.3 zawiera metodę SetCCPAUserConsent(bool)
. Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie użytkownika do pakietu SDK myTarget. Jeśli chcesz wywoływać tę metodę, zalecamy zrobienie tego przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetCCPAUserConsent(true);
Aby uzyskać więcej informacji, skontaktuj się z zespołem pomocy myTarget.
Krok 5. Dodaj wymagany kod
Android
Integracja z usługą myTarget nie wymaga dodatkowego kodu.
iOS
Integracja SKAdNetwork
Wykonaj instrukcje z dokumentacji 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ć podstawowy błąd w odpowiedzi na reklamę, używając polecenia ResponseInfo
z tych klas:
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 powiązane z nimi komunikaty wysyłane przez adapter myTarget, gdy nie uda się 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 obsługiwanego rozmiaru banera 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 obsługiwanego rozmiaru banera myTarget. |
105 | Brak wymaganych komponentów reklamy natywnej. |
Historia zmian wtyczki myTarget Unity Mediation
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
dodaliśmy 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 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.