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

Integracja 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 myTarget do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera myTarget z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter pośredniczący dla myTarget ma te możliwości:

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

Wymagania

poziom interfejsu API 21 lub nowszy,

Najnowsza wersja pakietu SDK do reklam mobilnych Google
Przeczytaj Przewodnik dla początkujących

Krok 1. Skonfiguruj konfiguracje w interfejsie myTarget

Najpierw zarejestruj się lub zaloguj się na konto myTarget. Otwórz stronę Aplikacje, klikając APLIKACJE w nagłówku. Dodaj aplikację, klikając DODAJ APLIKACJĘ.

Następnie podaj adres URL aplikacji w Google Play.

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 NATYWNY, 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 Ad Managera 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 Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij Wyświetlanie > Grupy zysku, a potem kliknij przycisk Nowa grupa zysku.

Wpisz unikalną nazwę grupy zysku, ustaw stan na Aktywna, wybierz Format reklamy i ustaw Typ zasobów reklamowych na Aplikacja mobilna. W sekcji Targetowanie > Zasoby wybierz jednostkę reklamową w sekcji Zasoby reklamowe i Aplikacja mobilna, do której chcesz dodać zapośredniczenie.

Następnie kliknij przycisk Dodaj partnera zysku.

Jeśli masz już partnera zysku dla myTarget, możesz go wybrać. W przeciwnym razie wybierz Utwórz nowego partnera zysku.

Jako sieć reklamowa wybierz myTarget, wpisz unikalną nazwę i włącz zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpisz trwały token dostępu uzyskany w poprzedniej sekcji.

Po wybraniu partnera zysku wybierz Zapośredniczenie mobilne SDK jako Typ integracji, Android jako Platforma i Aktywny jako Stan. Wpisz identyfikator slotu uzyskany w poprzedniej sekcji. Następnie wpisz wartość Domyślny CPM.

Gdy skończysz, u dołu strony kliknij Zapisz.

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 zgodnych z RODO i przepisami stanowymi USA w interfejsie Ad Managera, wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia dotyczące przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter myTarget

Integracja z Android Studio (zalecana)

W pliku build.gradle.kts na poziomie aplikacji dodaj te implementacje, zależności i konfiguracje. Używaj najnowszych wersji pakietu SDK i adaptera myTarget:

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

Integracja ręczna

Aby uwzględnić pakiet SDK myTarget, zapoznaj się z dokumentacją pakietu SDK myTarget na Androida.
Przejdź do elementów adaptera myTarget w repozytorium Maven Google. 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

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. Obecnie Google nie może automatycznie przekazywać wyboru użytkownika dotyczącego wyrażenia zgody do takich sieci.

W wersji pakietu SDK 5.1.0 firma myTarget dodała interfejs API zgody użytkownika, aby spełnić wymagania dotyczące prywatności. Poniższy przykładowy kod pokazuje, jak przekazywać te informacje o zgodzie do myTarget SDK. 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.

Java

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

MyTargetPrivacy.setUserConsent(true);

Kotlin

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

MyTargetPrivacy.setUserConsent(true)

Jeśli wiesz, że użytkownik należy do kategorii objętej ograniczeniami wiekowymi, możesz użyć tego kodu, aby przekazać te 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)

Więcej informacji o wartościach, które można podać w ramach tej metody, oraz o RODO znajdziesz w przewodniku myTarget.

Amerykańskie przepisy stanowe o ochronie prywatności

Przepisy stanowe w USA wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” swoich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu na stronie głównej podmiotu „sprzedającego” musi być umieszczony dobrze widoczny link „Nie sprzedawaj 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ść.

W wersji pakietu SDK 5.9.0 firma myTarget dodała interfejs API zgody użytkownika, aby spełnić wymagania dotyczące prywatności. Poniższy przykładowy kod pokazuje, jak przekazywać te informacje o zgodzie do myTarget SDK. 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.

Java

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

MyTargetPrivacy.setCcpaUserConsent(true);

Kotlin

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

MyTargetPrivacy.setCcpaUserConsent(true)

Aby uzyskać więcej informacji o wartościach, które można podać w ramach tej metody, skontaktuj się z zespołem pomocy myTarget.

Krok 5. Dodaj wymagany kod

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

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w Ad Managerze 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).

Kroki opcjonalne:

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter myTarget zwraca swoje reklamy natywne jako obiekty NativeAd. Wypełnia ona te pola w przypadku NativeAd.

Pole	Wypełnia je 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

Pakiet SDK myTarget zawsze zwraca wartość 0 dla szerokości i wysokości mediaView, więc adapter myTarget zawsze zwraca wartość 0 dla getAspectRatio(). W przyszłej wersji pakietu SDK myTarget ten problem zostanie rozwiązany.

Śledzenie wyświetleń i kliknięć

Pakiet SDK do reklam mobilnych Google korzysta z wywołań zwrotnych pakietu SDK myTarget do śledzenia wyświetleń i kliknięć, więc raporty z obu źródeł powinny być zgodne lub zawierać niewielkie rozbieżności.

Kody błędów

Jeśli adapter nie otrzyma reklamy z myTarget, możesz sprawdzić błąd podstawowy w odpowiedzi reklamy, korzystając z funkcji ResponseInfo.getAdapterResponses() w ramach tych klas:

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

Oto kody i odpowiednie komunikaty wyrzucane przez adapter myTarget, gdy nie udaje się załadować reklamy:

Kod błędu	Przyczyna
100	Pakiet SDK myTarget zwrócił błąd.
101	Parametry serwera myTarget skonfigurowane w interfejsie Ad Managera 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ą implementacją.
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).