Integracja elementu myTarget z zapośredniczeniem

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.

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 AdMob 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 AdMob interfejsie myTarget

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 instrukcji na Androida.

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 AdMob 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

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 AdMob 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 AdMob 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 AdMob 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

Wersja 3.16.2

Wersja 3.16.1

Wersja 3.16.0

Wersja 3.15.0

Wersja 3.14.0

Wersja 3.13.2

Wersja 3.13.1

Wersja 3.13.0

Wersja 3.12.0

Wersja 3.11.4

Wersja 3.11.3

Wersja 3.11.2

Wersja 3.11.1

Wersja 3.11.0

Wersja 3.10.2

Wersja 3.10.1

Wersja 3.10.0

Wersja 3.9.0

Wersja 3.8.2

Wersja 3.8.1

Wersja 3.8.0

Wersja 3.7.0

Wersja 3.6.1

Wersja 3.6.0

Wersja 3.5.2

Wersja 3.5.1

Wersja 3.5.0

Wersja 3.4.0

Wersja 3.3.0

Wersja 3.2.0

Wersja 3.1.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).

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.