Integracja elementu myTarget z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z myTarget przy użyciu mediacji, która obejmuje integrację kaskadową. Przewodnik zawiera informacje o dodawaniu pakietu myTarget do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera myTarget z aplikacją 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 w wersji 4 lub nowszej
  • Najnowsza wersja pakietu SDK do reklam mobilnych Google
  • Aby wdrożyć na Androidzie:
    • poziom interfejsu API 21 lub nowszy,
  • Aby wdrożyć aplikację na iOS:
    • docelowa wersja iOS 12.0 lub nowsza
  • działający projekt Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.

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. Dodaj aplikację, klikając DODAJ APLIKACJĘ.

Jeśli Twoja aplikacja obsługuje platformy Android i iOS, musisz skonfigurować je osobno.

Android

Następnie podaj adres URL aplikacji w Google Play.

iOS

Następnie podaj adres URL aplikacji w iTunes**.

Podczas dodawania aplikacji myTarget wymaga utworzenia jednostki reklamowej, zanim uda Ci się dokończyć proces.

Spośród dostępnych formatów reklam wybierz BANER, a potem kliknij przycisk DODAJ JEDNOSTKĘ REKLAMOWĄ.

Pełnoekranowa

Spośród dostępnych formatów reklam wybierz INTERSTITIAL, a potem kliknij przycisk DODAJ JEDNOSTKĘ REKLAMOWĄ.

Z nagrodą

Spośród dostępnych formatów reklam wybierz WIDEO Z NAGRODĄ, a potem kliknij przycisk DODAJ JEDNOSTKĘ REKLAMOWĄ.

Natywna

Spośród dostępnych formatów reklam wybierz Natywna, a potem kliknij DODAJ JEDNOSTKĘ REKLAMOWĄ.

Na stronie szczegółów jednostki reklamowej zanotuj identyfikator boksu reklamowego, który znajdziesz w ustawieniach jednostki reklamowej jako slot_id. Ten identyfikator miejsca na reklamę posłuży Ci do skonfigurowania jednostki reklamowej AdMob w następnej sekcji.

Aby skonfigurować identyfikator jednostki reklamowej AdMob, oprócz slot_id musisz też podać trwały token dostępu myTarget. Otwórz kartę Profil i wybierz Tokeny dostępu. Kliknij Utwórz token lub Pokaż token, aby wyświetlić trwały token dostępu myTarget.

Włączanie trybu testowego

Aby dodać i skonfigurować urządzenie testowe w interfejsie myTarget, wykonaj instrukcje podane w dokumentacji myTarget.

Krok 2. Skonfiguruj zapotrzebowanie myTarget w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym Android.

iOS

Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym iOS.

Dodawanie Mail.ru do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA

Aby dodać Mail.ru do listy partnerów reklamowych w interfejsie AdMob, wykonaj czynności opisane w ustawieniach RODO i ustawieniach dotyczących przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter myTarget

OpenUPM-CLI

Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę myTarget Mediation dla Google Mobile Ads na platformie Unity, uruchamiając to polecenie w katalogu głównym projektu:

openupm add com.google.ads.mobile.mediation.mytarget

OpenUPM

W edytorze projektu Unity wybierz Edytuj > Ustawienia projektu > Menedżer pakietów, aby otworzyć ustawienia menedżera pakietów Unity.

Na karcie Scoped Registries (Rejestry ograniczone) dodaj OpenUPM jako rejestr ograniczony z tymi informacjami:

  • Nazwa: OpenUPM
  • Adres URL: https://package.openupm.com
  • Zakres: com.google

Szczegóły UPM

Następnie kliknij Okno > Menedżer pakietów, aby otworzyć Menedżera pakietów Unity, a potem w menu kliknij Moje rejestry.

Rejestry Unity

Wybierz pakiet Google Mobile Ads myTarget Mediation i kliknij Zainstaluj.

Instalowanie z OpenUPM

Pakiet Unity

Pobierz najnowszą wersję wtyczki Google Mobile Ads do pośredniczenia w przypadku myTarget z linku do pobrania w Changelog i rozpakuj plik zipGoogleMobileAdsMyTargetMediation.unitypackage.

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.

Importowanie z Unity

Następnie kliknij Zasoby > Menedżer zewnętrznych zależności > Rozwiązanie Androida > Wymuś rozwiązanie. Biblioteka menedżera zależności zewnętrznej wykona rozwiązanie zależności od podstaw i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android aplikacji Unity.

Wymuś rozwiązanie

Krok 4. Wdróż ustawienia prywatności w pakiecie SDK myTarget

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz zadbać o to, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali odpowiednie informacje i wyrazili zgodę na wykorzystywanie identyfikatorów urządzeń i danych osobowych. 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). Aby uzyskać zgodę, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub używać danych osobowych, oraz podać informacje o wykorzystywaniu tych danych przez każdą z nich. Obecnie Google nie może automatycznie przekazywać wyboru użytkownika dotyczącego wyrażenia zgody do takich sieci.

Wtyczka do zapośredniczenia reklam mobilnych Google dla 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 zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklamy 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 objętej 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 nakładają na Ciebie obowiązek zapewnienia użytkownikom możliwości wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu musisz umieścić na stronie głównej „sprzedającego” dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”). Przewodnik dotyczący zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w przypadku wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia w przypadku każdej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność.

Wtyczka do zapośredniczenia reklam mobilnych Google dla 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łać tę metodę, zalecamy, aby zrobić to 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

Do integracji z myTarget nie jest potrzebny żaden dodatkowy kod.

iOS

Integracja z SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją myTarget.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob i włączyć tryb testowy w interfejsie myTarget.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z myTarget, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając z źródeł reklam myTarget (kaskada).

Kody błędów

Jeśli adapter nie otrzyma reklamy z myTarget, wydawcy mogą sprawdzić błąd podstawowy w odpowiedzi 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 odpowiednie komunikaty z adaptera myTarget, które pojawiają się, gdy nie udaje się załadować reklamy:

Android

Kod błędu Przyczyna
100 Pakiet SDK myTarget zwrócił błąd.
101 Parametry serwera myTarget skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje.
102 Żądaną wielkość reklamy nie odpowiada obsługiwanemu rozmiarowi banera w usłudze myTarget.
103 Żądanie reklamy nie jest żądaniem reklamy natywnej z ujednoliconą obsługą.
104 Załadowana reklama natywną z myTarget różni się od żądanej reklamy natywnej.
105 W wczytanej reklamie natywnej z myTarget brakuje niektórych wymaganych komponentów (np. obrazu lub ikony).

iOS

Kod błędu Przyczyna
100 Pakiet SDK myTarget nie zawiera jeszcze reklamy.
101 Parametry serwera myTarget skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje.
102 Adapter myTarget nie obsługuje żądanego formatu reklamy.
103 Próbowano wyświetlić reklamę myTarget, która nie została załadowana.
104 Żądaną wielkość reklamy nie odpowiada obsługiwanemu rozmiarowi banera w usłudze myTarget.
105 Brak wymaganych komponentów reklam natywnych.

Historia zmian wtyczki myTarget do pośredniczenia w zakupach w Unity

Wersja 3.20.0

Wersja 3.19.0

Wersja 3.18.2

Wersja 3.18.1

Wersja 3.18.0

Wersja 3.17.1

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

  • Zaktualizowano wtyczkę, aby obsługiwała nowy interfejs API do reklam z nagrodą w ramach otwartych testów 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 SDK myTarget na Androida w wersji 5.1.0.
  • Obsługuje pakiet SDK myTarget na iOS w wersji 4.7.9.
  • Dodaliśmy te metody:
    • MyTarget.SetUserConsent(), aby przekazać stan zgody użytkownika do pakietu SDK MyTarget.
    • MyTarget.SetUserAgeRestricted metoda, która ustawia flagę, aby wskazać, czy użytkownik należy do kategorii objętej ograniczeniem wiekowym (czyli ma mniej niż 16 lat).
    • MyTarget.IsUserConsent(), aby uzyskać bieżący stan zgody użytkownika.
    • MyTarget.IsUserAgeRestricted(), aby uzyskać flagę wskazującą, że użytkownik należy do kategorii wiekowej objętej ograniczeniami (czyli ma mniej niż 16 lat).

Wersja 2.0.1

  • Obsługuje pakiet SDK myTarget na Androida w wersji 5.0.2.
  • Obsługuje pakiet SDK myTarget na iOS w wersji 4.7.8.

Wersja 2.0.0

  • Obsługuje pakiet SDK myTarget na Androida w wersji 5.0.0.
  • Obsługuje pakiet SDK myTarget na iOS w wersji 4.7.7.

Wersja 1.1.0

  • Obsługuje pakiet SDK myTarget na Androida w wersji 4.7.2.
  • Obsługuje pakiet SDK myTarget na iOS w wersji 4.7.6.

Wersja 1.0.0

  • Pierwsza wersja
  • Obsługuje pakiet SDK myTarget na Androida w wersji 4.6.27.
  • Obsługuje pakiet SDK myTarget na iOS w wersji 4.6.24.