Integracja elementu myTarget z zapośredniczeniem

Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania z reklam myTarget za pomocą zapośredniczenia. na temat integracji kaskadowych. Wyjaśniamy, jak dodać element myTarget do konfiguracji zapośredniczenia i integracji pakietu SDK myTarget z adapterem. i aplikacja na Unity.

Obsługiwane integracje i formaty reklam

Integracja
Określanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Z nagrodą
Pełnoekranowa z nagrodą

Wymagania

  • Unity 4 lub nowsza
  • Najnowszy pakiet SDK do reklam mobilnych Google
  • Do wdrożenia na Androidzie
    • Interfejs API Androida na poziomie 21 lub wyższym
  • Do wdrożenia na 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. Zobacz Rozpocznij, aby dowiedzieć się więcej.
  • Dokończ 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 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 klikając link pobierania w Historia zmian i wyodrębnij plik GoogleMobileAdsMyTargetMediation.unitypackage z pliku ZIP.

W edytorze projektów Unity, wybierz Assets (Zasoby) > Importuj pakiet > Niestandardowy zakres dat Spakuj i znajdź plik GoogleMobileAdsMyTargetMediation.unitypackage, pobrano. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.

Potem kliknij Komponenty > Program do rozpoznawania usług Google Play > Program do rozpoznawania Androida > Wymuś Zakończ. Biblioteka programu do rozpoznawania usług Unity Play będzie działać w zależności od zera i skopiować zadeklarowane zależności Katalog Assets/Plugins/Android Twojej aplikacji w Unity.

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

Obowiązujące w Google zgoda użytkownika z UE Google, musisz dopilnować, aby takie oświadczenia zostały ujawnione. zgody uzyskane od użytkowników z Europejskiego Obszaru Gospodarczego dotyczące: wykorzystywania identyfikatorów urządzeń i danych osobowych. Zasady te odzwierciedlają wymagania unijnej dyrektywy o prywatności i łączności elektronicznej oraz Ogólnej ustawy o ochronie danych Rozporządzenie (RODO). Wyświetlając prośbę o zgodę na wykorzystanie danych, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe i dostarczają informacji o korzystaniu z poszczególnych sieci. Google obecnie nie może automatycznego przekazywania do takich sieci wyboru użytkownika dotyczącego zgody.

Wtyczka zapośredniczenia do reklam mobilnych Google dla aplikacji myTarget w wersji 2.1.0 zawiera Metody SetUserConsent() i SetUserAgeRestricted(). Następująca próbka pokazuje, jak przekazywać informacje o zgodzie użytkownika do pakietu SDK myTarget. Jeśli tę metodę należy wywołać przed wysłaniem żądania za pomocą pakietu SDK do reklam mobilnych Google.

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetUserConsent(true);

Jeśli wiadomo, że użytkownik jest objęty ograniczeniem wiekowym, możesz też wywołać funkcję Metoda SetUserAgeRestricted().

MyTarget.SetUserAgeRestricted(true);

Zobacz cel myTarget Przewodnik po prywatności i RODO .

Amerykańskie przepisy stanowe o ochronie prywatności

Stany Zjednoczone przepisy stanowe o ochronie prywatności wymagają dawania użytkownikom zrezygnować z „wyprzedaży”, „danych osobowych” (zgodnie z definicją w ustawie tych haseł) z opcją rezygnacji dostępną za pomocą dobrze widocznego powiadomienia „Nie sprzedawaj Informacje” w wierszu „sprzedaż”, na stronie głównej strony. Stany Zjednoczone stanowa prywatność użytkowników przewodnik dotyczący zgodności z przepisami prawa umożliwia włączenie ograniczone przetwarzanie danych wyświetlania reklam przez Google, ale Google nie może stosować tego ustawienia do poszczególnych reklam w łańcuchu zapośredniczenia. W przypadku każdej sieci reklamowej należy w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży i postępuj zgodnie ze wskazówkami dotyczącymi tych sieci, aby zapewnić zgodność z przepisami.

Wtyczka zapośredniczenia do reklam mobilnych Google dla aplikacji myTarget w wersji 3.13.3 zawiera Metoda SetCCPAUserConsent(bool). Poniższy przykładowy kod pokazuje, jak to zrobić informacji o zgodzie użytkownika na wykorzystanie danych do pakietu SDK myTarget. Jeśli wybierzesz tę metodę, zalecamy zrobić to przed wysłaniem żądania reklam za pośrednictwem Google Pakiet SDK do reklam mobilnych.

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetCCPAUserConsent(true);

Skontaktuj się z zespołem pomocy myTarget, aby uzyskać informacje o znajdziesz więcej informacji.

Krok 5. Dodaj wymagany kod

Android

Integracja z usługą myTarget nie wymaga dodatkowego kodu.

iOS

Integracja SKAdNetwork

Postępuj zgodnie z dokumentacją funkcji 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ć bazowy błąd w odpowiedzi na żądanie reklamy za pomocą funkcji ResponseInfo w następujące klasy:

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 towarzyszące im komunikaty wysyłane przez adapter myTarget gdy nie można 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

Następna wersja

  • Nazwa DummyClient została zmieniona na PlaceholderClient.

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.