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

Integracja DT Exchange z zapośredniczeniem

Ten przewodnik pokazuje, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z DT Exchange przy użyciu mediacji, która obejmuje integrację kaskadową. Pokazuje on, jak dodać DT Exchange do konfiguracji zapośredniczenia w jednostce reklamowej oraz jak zintegrować pakiet SDK i adapter DT Exchange z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter pośredniczący dla DT Exchange 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 DT Exchange

Dodawanie nowej aplikacji i miejsca docelowego reklamy

Zarejestruj się lub zaloguj się w konsoli DT Exchange.

Kliknij przycisk Dodaj aplikację, aby dodać aplikację.

Zarządzaj Aplikacjami

Wybierz Platformę, wypełnij resztę formularza i kliknij Dodaj miejsca docelowe.

W polu Nazwa miejsca docelowego wpisz nazwę nowego miejsca docelowego, a następnie na liście wybierz odpowiedni Typ miejsca docelowego. Na koniec kliknij Zapisz miejsce docelowe.

Konfiguracja

Identyfikator aplikacji i identyfikator miejsca docelowego

Otwórz pasek nawigacyjny po lewej stronie, najeżdżając na niego kursorem. W menu po lewej stronie kliknij Aplikacje.

Na stronie Zarządzanie aplikacjami zanotuj identyfikator aplikacji obok aplikacji.

Identyfikator aplikacji

Wybierz aplikację, otwórz kartę Miejsca docelowe i kliknij ikonę kopiowania obok Nazwa miejsca docelowego. Zanotuj identyfikator miejsca docelowego.

Identyfikator miejsca docelowego

Identyfikator wydawcy, klucz klienta i hasło klienta

W menu po lewej stronie kliknij swoje imię i nazwisko, a następnie wybierz Profil użytkownika.

Zanotuj identyfikator wydawcy, klucz klienta i klucz tajny klienta, ponieważ będą Ci potrzebne w następnym kroku.

Krok 2. Skonfiguruj zapotrzebowanie DT Exchange 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 w DT Exchange, możesz go wybrać. W przeciwnym razie wybierz Utwórz nowego partnera zysku.

Jako sieć reklamowa wybierz DT Exchange, wpisz niepowtarzalną nazwę i włącz zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpisz identyfikator wydawcy, udostępnione hasło i klucz klienta uzyskane w poprzedniej sekcji.

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

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

Dodawanie DT Exchange (Fyber Monetization) do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA

Wykonaj czynności opisane w ustawieniach RODO i ustawieniach dotyczących przepisów stanowych w USA, aby dodać DT Exchange (Fyber Monetization) do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA w interfejsie Ad Managera.

Krok 3. Zaimportuj pakiet SDK i adapter DT Exchange

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 DT Exchange SDK i adaptera:

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

Integracja ręczna

Pobierz najnowszą wersję pakietu DT Exchange SDK na Androida i dodaj do projektu te pliki:
- ia-mraid-kit-release-x.y.z.aar
- ia-sdk-core-release-x.y.z.aar
- ia-video-kit-release-x.y.z.aar
Przejdź do artefaktów adaptera DT Exchange w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik .aar adaptera DT Exchange i dodaj go do projektu.

Krok 4. Wprowadź ustawienia prywatności w pakiecie DT Exchange SDK

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.

DT Exchange zawiera interfejs API, który umożliwia przekazanie zgody użytkownika do pakietu SDK. Poniższy przykładowy kod pokazuje, jak ręcznie przekazywać informacje o zgodzie do interfejsu DT Exchange SDK. Jeśli zdecydujesz się ręcznie przekazywać informacje o zgodzie do pakietu SDK DT Exchange, zalecamy wywołanie tego kodu przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

Java

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");

Kotlin

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setGdprConsent(true)
InneractiveAdManager.setGdprConsentString("myGdprConsentString")

Więcej informacji oraz wartości, które mogą być podawane w ramach tej metody, znajdziesz na stronie z materiałami dotyczącymi RODO i w przewodniku DT Exchange dotyczącym wdrażania RODO.

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ść.

Java

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

Kotlin

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")

Więcej informacji oraz wartości, które mogą być podawane w ramach tej metody, znajdziesz na stronie z zasobami dotyczącymi ustawy CCPA i w przewodniku DT Exchange dotyczącym wdrażania ustawy CCPA.

Krok 5. Dodaj wymagany kod

Integracja z DT Exchange nie wymaga dodatkowego kodu.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że urządzenie testowe jest zarejestrowane w Ad Managerze.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z DT Exchange, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając z kaskadowego źródła reklam DT Exchange.

Kroki opcjonalne:

Parametry związane z siecią

Adapter DT Exchange obsługuje dodatkowe parametry żądania, które można przekazać do adaptera jako pakiet Androida. Adapter szuka w pakiecie tych kluczy:

Parametry i wartości żądania
`InneractiveMediationDefs.KEY_AGE`	Liczba całkowita. Wiek użytkownika
`FyberMediationAdapter.KEY_MUTE_VIDEO`	Wartość logiczna. Wyciszanie i włączanie wyciszenia filmu

Oto przykład kodu, który pokazuje, jak ustawić te parametry żądania reklamy:

Java

Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(FyberMediationAdapter.class, extras)
   .build();

Kotlin

var extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
   .build()

Kody błędów

Jeśli adapter nie otrzyma reklamy z DT Exchange, możesz sprawdzić błąd podstawowy w odpowiedzi reklamy, używając: ResponseInfo.getAdapterResponses() w ramach tej klasy:

com.google.ads.mediation.fyber.FyberMediationAdapter

Oto kody i odpowiednie komunikaty z adaptera DT Exchange, które są wyświetlane, gdy nie udaje się załadować reklamy:

Kod błędu	Przyczyna
101	Parametry serwera DT Exchange skonfigurowane w interfejsie Ad Managera są nieprawidłowe lub ich brakuje.
103	Żądany rozmiar reklamy nie odpowiada obsługiwanemu rozmiarowi banera w DT Exchange.
105	Pakiet DT Exchange SDK załadował reklamę, ale zwrócił nieoczekiwaną kontrolkę.
106	Reklama nie jest gotowa do wyświetlenia.
200-399	Pakiet SDK DT Exchange zwrócił błąd. Więcej informacji znajdziesz w kodu.