Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z elementu myTarget za pomocą zapośredniczenia w zakresie integracji kaskady. Opisano w nim, jak dodać element myTarget do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK myTarget i adapter z aplikacją na 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 przeprowadzić wdrożenie na Androidzie:
- Interfejs API Androida na poziomie 19 lub wyższym
- Aby wdrożyć w iOS:
- Wartość docelowa wdrożenia iOS w wersji 12.0 lub nowszej
- Działający projekt na Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
- Skorzystaj z zapośredniczenia Wprowadzenie
Krok 1. Skonfiguruj konfiguracje w interfejsie 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 strategię MyTarget na potrzeby ofert reklamowych w Ad Manager interfejsie użytkownika
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 reklam mobilnych Google na potrzeby elementu myTarget, korzystając z linku do pobierania w Historii 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 zależności usług Unity Play zajmie się rozpoznawaniem zależności od zera i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
aplikacji Unity.
Krok 4. Zastosuj 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) udzielili określonych informacji na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz uzyskali od nich odpowiednie zgody. 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). Żeby uzyskać zgodę na wykorzystanie danych, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub wykorzystywać dane osobowe, a także dostarczać informacje o korzystaniu z nich przez poszczególne sieci. Obecnie Google nie może automatycznie przekazać zgody użytkownika na wykorzystanie danych do takich sieci.
Wtyczka zapośredniczenia reklam mobilnych Google dla platformy myTarget w wersji 2.1.0 zawiera metody SetUserConsent()
i SetUserAgeRestricted()
. Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie użytkownika do pakietu SDK myTarget. Jeśli chcesz wywoływać tę metodę, rób to przed wysłaniem żądań reklam za pomocą pakietu SDK do reklam mobilnych Google.
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetUserConsent(true);
Jeśli wiadomo, że użytkownik należy do kategorii z ograniczeniami wiekowymi, możesz też wywołać metodę SetUserAgeRestricted()
.
MyTarget.SetUserAgeRestricted(true);
Więcej informacji znajdziesz w przewodniku myTarget na temat prywatności i RODO.
Amerykańskie przepisy stanowe o ochronie prywatności
Amerykańskie przepisy stanowe o ochronie prywatności wymagają przyznania użytkownikom prawa do wycofania zgody na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie), przy czym opcja ta jest dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej sprzedającego. 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 żadnej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność z zasadami.
Wtyczka zapośredniczenia reklam mobilnych Google dla platformy 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 zdecydujesz się wywoływać tę metodę, warto zrobić to przed wysłaniem żądań 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 myTarget nie wymaga dodatkowego kodu.
iOS
Integracja SKAdNetwork
Wykonaj dokumentację 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 obiektu myTarget, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z ResponseInfo
w tych klasach:
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 można wczytać reklamy:
Android
Kod błędu | Przyczyna |
---|---|
100 | Pakiet myTarget SDK zwrócił błąd. |
101 | Brakuje parametrów serwera myTarget skonfigurowane w interfejsie Ad Manager 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 załadowanej 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 | Brakuje parametrów serwera myTarget skonfigurowane w interfejsie Ad Manager lub są one nieprawidłowe. |
102 | Adapter myTarget nie obsługuje żądanego formatu reklamy. |
103 | Próbowałem/próbowałam wyświetlić niewczytaną reklamę myTarget. |
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.15.0
- Obsługuje adapter aplikacji myTarget na Androida w wersji 5.20.0.0.
- Obsługuje adapter systemu iOS w wersji 5.20.1.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.7.0.
Wersja 3.14.0
- Obsługuje adapter Androida myTarget w wersji 5.18.0.0.
- Obsługuje adapter systemu iOS w wersji 5.19.0.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.5.0.
Wersja 3.13.2
- Obsługuje adapter Androida myTarget w wersji 5.16.5.0.
- Obsługuje adapter systemu iOS w wersji 5.17.5.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.3.0.
Wersja 3.13.1
- Treści adaptera zostały przeniesione do:
GoogleMobileAds/Mediation/MyTarget/
. - Zrefaktoryzowano przestrzeń nazw adaptera na
GoogleMobileAds.Mediation.MyTarget
. - Obsługuje adapter systemu Android myTarget w wersji 5.16.4.1.
- Obsługuje adapter systemu iOS w wersji 5.17.4.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.1.0.
Wersja 3.13.0
- Obsługuje adapter systemu Android myTarget w wersji 5.16.4.0.
- Obsługuje adapter systemu iOS w wersji 5.17.4.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.0.0.
Wersja 3.12.0
- Obsługuje adapter systemu Android myTarget w wersji 5.15.5.0.
- Obsługuje adapter systemu iOS w wersji 5.16.0.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.3.0.
Wersja 3.11.4
- Obsługuje adapter systemu Android myTarget w wersji 5.15.4.0.
- Obsługuje adapter systemu iOS w wersji 5.15.2.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.2.0.
Wersja 3.11.3
- Nazwa metody
IsConsent()
została zmieniona z klasyMyTarget
naGetUserConsent()
. - Dodano do klasy
MyTarget
te metody:SetCCPAUserConsent(bool)
GetCCPAUserConsent()
- Obsługuje adapter Androida myTarget w wersji 5.15.3.0.
- Obsługuje adapter systemu iOS w wersji 5.15.2.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.2.0.
Wersja 3.11.2
- Obsługuje adapter Androida myTarget w wersji 5.15.2.1.
- Obsługuje adapter systemu iOS w wersji 5.15.2.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.0.2.
Wersja 3.11.1
- Obsługuje adapter Androida myTarget w wersji 5.15.1.0.
- Obsługuje adapter systemu iOS w wersji 5.15.1.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 3.11.0
- Obsługuje adapter Androida myTarget w wersji 5.15.0.0.
- Obsługuje adapter systemu iOS w wersji 5.15.0.1.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 3.10.2
- Obsługuje adapter systemu Android myTarget w wersji 5.14.4.0.
- Obsługuje adapter systemu iOS w wersji 5.14.4.0.
Wersja 3.10.1
- Obsługuje adapter Androida myTarget w wersji 5.14.3.0.
- Obsługuje adapter systemu iOS w wersji 5.14.2.0.
Wersja 3.10.0
- Obsługuje adapter aplikacji myTarget na Androida w wersji 5.14.2.0.
- Obsługuje adapter systemu iOS w wersji 5.14.1.0.
Wersja 3.9.0
- Obsługuje adapter Androida myTarget w wersji 5.13.0.0.
- Obsługuje adapter systemu iOS w wersji 5.11.2.0.
Wersja 3.8.2
- Obsługuje adapter systemu Android myTarget w wersji 5.11.7.0.
- Obsługuje adapter systemu iOS w wersji 5.9.10.0.
Wersja 3.8.1
- Obsługuje adapter systemu Android myTarget w wersji 5.11.5.0.
- Obsługuje adapter systemu iOS w wersji 5.9.6.0.
Wersja 3.8.0
- Obsługuje adapter Androida myTarget w wersji 5.11.4.0.
- Obsługuje adapter systemu iOS w wersji 5.9.5.0.
Wersja 3.7.0
- Obsługuje adapter Androida myTarget w wersji 5.10.0.0.
- Obsługuje adapter systemu iOS w wersji 5.7.5.0.
Wersja 3.6.1
- Zmieniono nazwę metody
MyTarget.IsUserConsent()
naMyTarget.IsConsent()
. - Obsługuje adapter Androida myTarget w wersji 5.9.1.0.
- Obsługuje adapter systemu iOS w wersji 5.7.2.0.
Wersja 3.6.0
- Obsługuje adapter Androida myTarget w wersji 5.9.0.0.
- Obsługuje adapter systemu iOS w wersji 5.7.0.0.
Wersja 3.5.2
- Obsługuje adapter systemu Android myTarget w wersji 5.8.3.0.
- Obsługuje adapter systemu iOS w wersji 5.6.3.0.
Wersja 3.5.1
- Obsługuje adapter Androida myTarget w wersji 5.8.2.0.
- Obsługuje adapter systemu iOS w wersji 5.6.1.0.
Wersja 3.5.0
- Obsługuje adapter systemu Android myTarget w wersji 5.8.1.0.
- Obsługuje adapter systemu iOS w wersji 5.6.0.0.
Wersja 3.4.0
- Obsługuje adapter Androida myTarget w wersji 5.8.0.0.
- Obsługuje adapter systemu iOS w wersji 5.5.2.0.
Wersja 3.3.0
- Obsługuje adapter Androida myTarget w wersji 5.7.0.0.
- Obsługuje adapter systemu iOS w wersji 5.5.1.0.
Wersja 3.2.0
- Obsługuje adapter Androida myTarget w wersji 5.6.3.0.
- Obsługuje adapter systemu iOS w wersji 5.4.9.0.
Wersja 3.1.0
- Obsługuje adapter Androida myTarget w wersji 5.4.6.0.
- Obsługuje adapter systemu 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 na 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 na 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 na 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 na 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 na 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 na 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 na iOS w wersji 4.7.10.0.
Wersja 2.1.0
- Obsługuje pakiet myTarget na Androida SDK w wersji 5.1.0.
- Obsługuje pakiet myTarget na iOS SDK w wersji 4.7.9.
- Dodaliśmy te metody:
MyTarget.SetUserConsent()
, aby przekazać stan zgody użytkownika do pakietu SDK MyTarget.MyTarget.SetUserAgeRestricted
, która ustawia flagę wskazującą, że użytkownik należy do kategorii z ograniczeniami wiekowymi (tzn. nie ma 16 lat).MyTarget.IsUserConsent()
, aby sprawdzić aktualny stan zgody użytkownika.MyTarget.IsUserAgeRestricted()
, aby pobrać flagę informującą o tym, że użytkownik należy do kategorii z ograniczeniami wiekowymi (tzn. nie ukończył 16 lat).
Wersja 2.0.1
- Obsługuje pakiet myTarget na Androida w wersji 5.0.2.
- Obsługuje pakiet myTarget na iOS SDK w wersji 4.7.8.
Wersja 2.0.0
- Obsługuje pakiet myTarget na Androida w wersji 5.0.0.
- Obsługuje pakiet myTarget na iOS SDK w wersji 4.7.7.
Wersja 1.1.0
- Obsługuje pakiet myTarget na Androida SDK w wersji 4.7.2.
- Obsługuje pakiet myTarget na iOS SDK w wersji 4.7.6.
Wersja 1.0.0
- Pierwsza wersja!
- Obsługuje pakiet myTarget na Androida SDK w wersji 4.6.27.
- Obsługuje pakiet myTarget na iOS SDK w wersji 4.6.24.