Integracja elementu myTarget z zapośredniczeniem

Wybierz platformę: Android (beta) Android iOS Unity Flutter

Z tego przewodnika dowiesz się, jak za pomocą GMA Next-Gen SDK wczytywać i wyświetlać reklamy z myTarget za pomocą zapośredniczenia, w tym integracje kaskadowe. Dowiesz się, jak dodać myTarget do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter myTarget z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia dla myTarget ma te możliwości:

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

Wymagania

• Android API na poziomie 24 lub wyższym

• Najnowszy GMA Next-Gen SDK.

• Wykonaj czynności opisane w przewodniku dla początkujących dotyczącym zapośredniczenia .

Krok 1. Skonfiguruj ustawienia w interfejsie myTarget

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 w Google Play swojej aplikacji.

Podczas dodawania aplikacji myTarget wymaga utworzenia jednostki reklamowej, zanim będzie można zakończyć ten proces.

Uwaga: aby dodać jednostkę reklamową do istniejącej aplikacji, otwórz stronę z informacjami o aplikacji, klikając jej nazwę, a następnie kliknij UTWÓRZ JEDNOSTKĘ REKLAMOWĄ.

Baner

Wybierz BANER spośród dostępnych formatów reklam, a następnie kliknij przycisk DODAJ JEDNOSTKĘ REKLAMOWĄ.

Pełnoekranowa

Wybierz PEŁNOEKRANOWA spośród dostępnych formatów reklam, a następnie kliknij przycisk DODAJ JEDNOSTKĘ REKLAMOWĄ.

Z nagrodą

Wybierz FILM Z NAGRODĄ spośród dostępnych formatów reklam, a następnie kliknij przycisk DODAJ JEDNOSTKĘ REKLAMOWĄ.

Natywna

Wybierz NATYWNA spośród dostępnych formatów reklam, a następnie kliknij DODAJ JEDNOSTKĘ REKLAMOWĄ.

Na stronie z informacjami o jednostce reklamowej zanotuj identyfikator boksu, który znajdziesz w ustawieniach jednostki reklamowej jako slot_id. Ten identyfikator boksu będzie używany do konfigurowania jednostki reklamowej Ad Managera w następnej sekcji.

Oprócz slot_id do skonfigurowania identyfikatora jednostki reklamowej AdMob potrzebny będzie też stały token dostępu myTarget. Otwórz kartę Profil i wybierz Tokeny dostępu. Aby wyświetlić stały token dostępu myTarget, kliknij Utwórz token lub Pokaż token.

Zaktualizuj plik app-ads.txt

Authorized Sellers for Apps (czyli plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec utracie przychodów z reklam, użyj pliku app-ads.txt. Jeśli jeszcze tego nie zrobisz, utwórz plik app-ads.txt dla Ad Managera.

Aby zaimplementować app-ads.txt w myTarget, przeczytaj artykuł Jak utworzyć i opublikować plik.

Włącz tryb testowy

Aby dodać i skonfigurować urządzenie testowe w interfejsie myTarget, postępuj zgodnie z instrukcjami w dokumentacji myTarget.

Krok 2. Skonfiguruj popyt myTarget w interfejsie Ad Managera

Skonfiguruj ustawienia zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij kolejno Wyświetlanie > Grupy zysku i przycisk Nowa grupa zysku.

Wpisz unikalną nazwę grupy zysku, ustaw stan na Aktywny, wybierz format reklamy i ustaw typ zasobów reklamowych na Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe 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ć reklamową wybierz myTarget, wpisz unikalną nazwę i włącz Zapośredniczenie.

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

Gdy partner zysku jest wybrany, jako typ integracji wybierz Zapośredniczenie mobilne SDK, jako platformę – Android, a jako stan – Aktywny. Wpisz identyfikator boksu uzyskany w poprzedniej sekcji. Następnie wpisz domyślną wartość CPM.

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

Uwaga: automatyczne zbieranie danych potrzebuje kilku dni na zebranie danych, zanim będzie mogło dokładnie obliczyć wartość dynamicznego CPM dla sieci zapośredniczenia. Po obliczeniu wartości eCPM zostanie ona automatycznie zaktualizowana.

Dodaj Mail.ru do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi

Ważne:aby skonfigurować zgodę użytkownika z UE i RODO, amerykańskie przepisy stanowe oraz platformę do wyświetlania wiadomości dla użytkowników, musisz mieć uprawnienie Zarządzanie kontem. Więcej informacji znajdziesz w artykule Zarządzanie dostępem użytkowników do konta.

Aby dodać Mail.ru do listy partnerów reklamowych zgodnych z rozporządzeniami europejskimi i przepisami stanowymi w USA w interfejsie Ad Managera, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter myTarget

Uwaga: brak integracji zgodnych wersji pakietu myTarget i GMA Next-Gen SDK może spowodować problemy z kompilacją.

Integracja z Androidem Studio (zalecane)

W pliku Gradle na poziomie aplikacji dodaj te zależności i konfiguracje implementacji:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:mytarget:5.45.3.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:mytarget:5.45.3.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integracja ręczna

• Aby uwzględnić pakiet SDK myTarget, zapoznaj się z dokumentacją pakietu myTarget Android SDK.

• Otwórz artefakty 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 myTarget SDK

Zgoda użytkownika z UE i RODO

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz udzielać odpowiednich informacji swoim użytkownikom z Europejskiego Obszaru Gospodarczego, Wielkiej Brytanii i Szwajcarii oraz uzyskiwać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane prawnie. Musisz też uzyskiwać ich zgodę na zbieranie, udostępnianie i wykorzystywanie danych osobowych do personalizowania reklam. 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). Twoim obowiązkiem jest sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu zapośredniczenia. Google nie może automatycznie przekazywać wyboru zgody użytkownika do takich sieci.

W wersji 5.1.0 pakietu SDK myTarget dodano interfejs API do zarządzania zgodą użytkowników, aby spełnić wymagania dotyczące ochrony prywatności. Poniższy przykładowy kod pokazuje, jak przekazać te informacje o zgodzie do pakietu SDK myTarget. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą GMA Next-Gen SDK.

Java

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

MyTargetPrivacy.setUserConsent(true);

Kotlin

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

MyTargetPrivacy.setUserConsent(true)

Jeśli użytkownik należy do kategorii wiekowej, w której obowiązują ograniczenia, 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 i wartości, które można podać w metodzie, 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 wymagają, aby użytkownicy mieli prawo do wycofania zgody na „sprzedaż” swoich „danych osobowych” (definicje poszczególnych terminów zostały określone w ustawie). Wycofanie zgody musi być możliwe za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Proszę nie sprzedawać 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 jest w stanie zastosować to ustawienie do każdej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz zidentyfikować każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie z instrukcjami każdej z tych sieci, aby zapewnić zgodność.

W wersji pakietu SDK 5.9.0 myTarget dodano interfejs API do zarządzania zgodą użytkowników, aby spełnić wymagania dotyczące ochrony prywatności. Poniższy przykładowy kod pokazuje, jak przekazać te informacje o zgodzie do pakietu SDK myTarget. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą GMA Next-Gen SDK.

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 i wartości, które można podać w metodzie, skontaktuj się z zespołem pomocy myTarget.

Krok 5. Dodaj wymagany kod

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

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe w Ad Managerze i włącz tryb testowy w interfejsie myTarget.

**Ważne:** przed opublikowaniem aplikacji wyłącz tryb testowy w Ad Managerze i myTarget.

Sprawdź reklamy testowe

Aby sprawdzić, czy otrzymujesz reklamy testowe z myTarget, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, używając źródła reklam myTarget (wodospad).

Kroki opcjonalne:

Korzystanie z reklam natywnych

Renderowanie reklam

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

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

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

Śledzenie wyświetleń i kliknięć

GMA Next-Gen SDK używa wywołań zwrotnych pakietu SDK myTarget do śledzenia wyświetleń i kliknięć, więc raporty z obu źródeł powinny się zgadzać z niewielkimi lub żadnymi rozbieżnościami.

Kody błędów

Jeśli adapter nie otrzyma reklamy z myTarget, możesz sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy za pomocą ResponseInfo.getAdSourceResponses() w tych 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 zwracane przez adapter myTarget, gdy nie uda się wczytać 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	Żądany rozmiar reklamy nie odpowiada rozmiarowi banera obsługiwanemu przez myTarget.
103	Żądanie reklamy nie jest ujednoliconym żądaniem reklamy natywnej.
104	Wczytana reklama natywna z myTarget różni się od żądanej reklamy natywnej.
105	Wczytana reklama natywna z myTarget nie ma niektórych wymaganych komponentów (np. obrazu lub ikony).