Integracja elementu myTarget z zapośredniczeniem

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

Integracja z Androidem Studio (zalecane)

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

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")
}

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.

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

MyTargetPrivacy.setUserConsent(true);

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.

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

MyTargetPrivacy.setUserAgeRestricted(true);

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.

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

MyTargetPrivacy.setCcpaUserConsent(true);

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.

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.

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: