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

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 strategię MyTarget na potrzeby ofert reklamowych w AdMob interfejsie użytkownika

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

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

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