Ta strona została przetłumaczona przez Cloud Translation API.

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 reklamy z myTarget za pomocą Zapośredniczenie AdMob, na temat integracji kaskadowych. Wyjaśniamy, jak dodać element myTarget do konfiguracji zapośredniczenia i integracji pakietu SDK myTarget z adapterem. aplikację Android .

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia dla usługi myTarget ma następujące możliwości:

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

Wymagania

Interfejs API Androida na poziomie 21 lub wyższym

Najnowszy pakiet SDK do reklam mobilnych Google
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Ę.

Następnie podaj adres URL Google Play dla Twojej 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

Musisz dodać myTarget do konfiguracji zapośredniczenia jednostki reklamowej.

Najpierw zaloguj się na swoje konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź od razu do sekcji Dodawanie myTarget jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, wybierz Utwórz grupę zapośredniczenia.

Podaj format reklamy i platformę, a następnie kliknij Dalej.

Nazwij grupę zapośredniczenia i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z co najmniej jedną istniejącą jednostką reklamowąAdMob . Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny się pojawić wybrane przez Ciebie jednostki reklamowe:

Dodaj myTarget jako źródło reklam

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklamy. Następnie kliknij myTarget.

Kliknij myTarget i włącz przełącznik Optymalizuj. Wpisz Permanent Access Tokenuzyskane w poprzedniej sekcji, aby skonfigurować optymalizację źródła reklam dla:myTarget. Następnie wpisz wartość eCPM dlamyTarget i kliknij Dalej.

Jeśli masz już mapowanie myTarget, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz dane Slot IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.

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

Integracja z Android Studio (zalecana)

W pliku build.gradle.kts na poziomie aplikacji dodaj tę implementację zależności i konfiguracji. Użyj najnowszych wersji pakietu SDK myTarget i adapter:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:mytarget:5.21.1.0")
}

Integracja ręczna

Aby dołączyć pakiet myTarget SDK, zapoznaj się z pakietem SDK myTarget Android SDK dokumentacji.
Przejdź do adaptera myTarget. artefakty w repozytorium Google Maven. Wybierz najnowszą wersję, pobierz Plik .aar adaptera myTarget i dodaj go do projektu.

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

Zgoda użytkowników z UE i RODO

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.

W wersji pakietu SDK 5.1.0, Aplikacja myTarget dodała interfejs API zgody użytkownika, aby spełnić wymagania dotyczące prywatności. ten przykładowy kod pokazuje, jak przekazać informacje o zgodzie użytkowników do usługi myTarget. SDK. Jeśli zdecydujesz się wywoływać tę metodę, zalecamy wykonanie jej wcześniej do wysyłania żądań reklam za pomocą pakietu SDK do reklam mobilnych Google.

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserConsent(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserConsent(true)

Ponadto, jeśli wiesz, że użytkownik jest objęty ograniczeniem wiekowym, możesz: użyj podanego niżej kodu, aby przekazać informacje o zgodzie do pakietu SDK myTarget.

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserAgeRestricted(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

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

W wersji pakietu SDK 5.9.0, Aplikacja myTarget dodała interfejs API zgody użytkownika, aby spełnić wymagania dotyczące prywatności. ten przykładowy kod pokazuje, jak przekazać informacje o zgodzie użytkowników do usługi myTarget. SDK. Jeśli zdecydujesz się wywoływać tę metodę, zalecamy wykonanie jej wcześniej do wysyłania żądań reklam za pomocą pakietu SDK do reklam mobilnych Google.

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setCcpaUserConsent(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setCcpaUserConsent(true)

Skontaktuj się z zespołem pomocy myTarget, aby uzyskać informacje o więcej informacji oraz wartości, które można podać w metodzie.

Krok 5. Dodaj wymagany kod

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

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.

Kroki opcjonalne:

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter myTarget zwraca reklamy natywne jako NativeAd obiektów. Zawiera te dane opisy pól reklam natywnych dla NativeAd.

Pole	Wypełnianie przez adapter myTarget
Nagłówek	Zawsze
Obraz	Zawsze
Treść	Zawsze
Ikona aplikacji	Zawsze
Wezwanie do działania	Zawsze
Ocena w gwiazdkach	Niegwarantowane
Sklep	Niegwarantowane
Cena	Niegwarantowane
Logo	Niegwarantowane
Reklamodawca	Zawsze

SDK myTarget zawsze zwraca 0 dla szerokości i wysokości mediaView, więc parametr Adapter myTarget zawsze zwraca wartość 0 dla getAspectRatio(). Pakiet myTarget SDK rozwiąże ten problem w przyszłej wersji.

Śledzenie wyświetleń i kliknięć

Pakiet SDK do reklam mobilnych Google używa wywołań zwrotnych pakietu SDK myTarget śledzenie kliknięć. Dzięki temu raporty z obu źródeł powinny zawierać tylko do braku rozbieżności.

Kody błędów

Jeśli adapter nie odbierze reklamy z obiektu myTarget, możesz sprawdzić bazowego błędu w odpowiedzi na żądanie reklamy za pomocą funkcji ResponseInfo.getAdapterResponses() w następujących klasach:

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

Oto kody i towarzyszące im komunikaty wysyłane przez adapter myTarget gdy nie można wczytać reklamy:

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