Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Integracja DT Exchange z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Z tego przewodnika dowiesz się, jak za pomocą GMA Next-Gen SDK wczytywać i wyświetlać reklamy z DT Exchange przy użyciu mediacji, w tym integracji kaskadowych. Wyjaśniamy w nim, jak dodać DT Exchange do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter DT z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter mediacji DT Exchange ma te funkcje:

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

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź, czy:

Android w wersji API 24 lub nowszej.

Najnowsza wersja GMA Next-Gen SDK.
Skonfiguruj mediację.

Krok 1. Skonfiguruj ustawienia w interfejsie DT Exchange

Dodawanie nowej aplikacji i nowego miejsca docelowego reklamy

Zarejestruj się lub zaloguj w konsoli DT Exchange.

Kliknij Dodaj aplikację.

Zarządzaj Aplikacjami

Wybierz platformę i miejsca docelowe, wypełnij pozostałą część formularza, a następnie kliknij Utwórz aplikację.

Wpisz nazwy i wybierz typy miejsc docelowych. Następnie kliknij Zapisz miejsce docelowe.

Konfiguracja

Identyfikator aplikacji i identyfikator miejsca docelowego

Najedź kursorem na pasek nawigacyjny po lewej stronie, aby go otworzyć, a następnie kliknij Zarządzanie aplikacjami.

Na stronie Zarządzanie aplikacjami zapisz Identyfikator aplikacji obok aplikacji.

Wybierz aplikację i otwórz kartę Miejsca docelowe. Zanotuj identyfikator miejsca docelowego.

Identyfikator miejsca docelowego

Identyfikator wydawcy, klucz klienta i klucz tajny klienta

W menu po lewej stronie kliknij swoją nazwę użytkownika i wybierz Profil użytkownika.

Zapisz Identyfikator wydawcy, Klucz klienta i Tajny klucz klienta, ponieważ będą potrzebne w następnym kroku.

Aktualizowanie pliku app-ads.txt

Plik Authorized Sellers for Apps 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 znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze tego nie zrobiono, utwórz plik app-ads.txt na potrzeby Ad Managera.

Aby wdrożyć app-ads.txt w przypadku DT Exchange, dodaj DT do pliku app-ads.txt.

Krok 2. Skonfiguruj popyt DT Exchange w interfejsie Ad Managera

Zaloguj się na konto Ad Managera.

Dodawanie DT Exchange w sekcji Firmy

Określanie stawek

Ten krok nie jest wymagany w przypadku integracji z określaniem stawek.

Kaskada

Kliknij kolejno Administracja > Firmy, a potem na karcie Wszystkie firmy kliknij przycisk Nowa firma. Kliknij Sieć reklamowa.

Wybierz DT SDK jako sieć reklamową, wpisz unikalną nazwę i włącz zapośredniczanie. Włącz Automatyczne zbieranie danych i wpisz Identyfikator wydawcy, Klucz tajny konsumenta i Klucz konsumenta uzyskane w poprzedniej sekcji.

Nie musisz wpisywać nazwy użytkownika ani hasła. Gdy skończysz, kliknij Zapisz.

Włączanie udostępniania bezpiecznych sygnałów

Określanie stawek

Kliknij kolejno Administracja i Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange, przejrzyj i włącz Udostępnianie bezpiecznych sygnałów. Kliknij Zapisz.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Udostępnianie bezpiecznych sygnałów w pytaniach o stawkę

Określanie stawek

Kliknij kolejno Zasoby reklamowe i Bezpieczne sygnały. W sekcji Bezpieczne sygnały wyszukaj DT Exchange (Fyber Monetization) i włącz opcję Włącz integrację aplikacji.

Kliknij Zapisz.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Zezwalanie na udostępnianie bezpiecznych sygnałów na potrzeby określania stawek przez pakiet SDK

Określanie stawek

Kliknij kolejno Wyświetlanie i Ustawienia na potrzeby kanałów popytu. Na karcie Ustawienia domyślne włącz opcję Zezwalaj na udostępnianie bezpiecznych sygnałów w przypadku licytowania w SDK.

Kliknij Zapisz.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie określania stawek w DT Exchange

Określanie stawek

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Kliknij Nowy licytujący.

Jako licytującego wybierz DT Exchange.

Kliknij Dalej, aby włączyć określanie stawek przez pakiet SDK w przypadku tego licytującego.

Kliknij Gotowe.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie mapowania jednostki reklamowej

Określanie stawek

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Wybierz firmę, która ma korzystać z DT Exchange.

Otwórz kartę Mapowanie jednostek reklamowych i kliknij Nowe mapowanie jednostek reklamowych.

Wybierz Konkretna jednostka reklamowa. Wybierz jednostkę reklamową i format, Aplikacja mobilna jako Typ zasobów reklamowych oraz Aplikacja mobilna. Następnie wpisz Identyfikator aplikacji i Identyfikator miejsca docelowego uzyskane w poprzedniej sekcji.

Na koniec kliknij Zapisz.

Kaskada

Kliknij kolejno Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku. Wybierz zasoby reklamowe i aplikację.

Przewiń do sekcji Partnerzy zysku i kliknij Dodaj partnera zapośredniczenia.

Wybierz firmę utworzoną w poprzedniej sekcji na potrzeby DT Exchange. Wybierz Zapośredniczenie mobilne SDK jako Typ integracji, Android jako Platformę i Aktywny jako Stan.

Wpisz identyfikator aplikacji i identyfikator miejsca docelowego uzyskane w poprzedniej sekcji oraz wartość domyślnego CPM. Kliknij Zapisz.

Dodawanie DT Exchange (Fyber Monetization) do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi

Aby dodać DT Exchange (Fyber Monetization) do listy partnerów reklamowych w zakresie rozporządzeń europejskich i przepisów stanowych 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 DT i adapter

Integracja z Androidem Studio (zalecana)

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

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:fyber:8.4.7.1")
}

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

Zakręcony

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:fyber:8.4.7.1'
}

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

Pobierz najnowszą wersję pakietu DT SDK na Androida i dodaj fyber-marketplace-x.y.z.aar do projektu.
Otwórz artefakty adaptera DT Exchange w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik .aar adaptera DT Exchange i dodaj go do projektu.

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

Zgoda użytkowników z UE i RODO

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz przekazywać użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Szwajcarii i Wielkiej Brytanii określone informacje oraz uzyskiwać ich zgodę na używanie plików cookie lub innych form lokalnego przechowywania danych, jeśli jest to wymagane przez prawo, a także na zbieranie, udostępnianie i wykorzystywanie danych osobowych na potrzeby personalizacji 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). Odpowiadasz za sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu zapośredniczenia.

Adapter DT Exchange na Androida w wersji 8.3.0.0 i nowszych obsługuje przekazywanie sygnałów zgody na wykorzystanie danych zgodnie z RODO z platform do zarządzania zgodą użytkowników, które są zintegrowane z zasadami IAB dotyczącymi przejrzystości i uzyskiwania zgody na przetwarzanie danych, do pakietu DT Exchange SDK. Więcej informacji znajdziesz w sekcji RODO.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli prawo wycofać zgodę na „sprzedaż” „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 po zgodności z przepisami stanowymi USA dotyczącymi ochrony prywatności umożliwia włączenie ograniczonego przetwarzania danych na potrzeby wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia do każdej sieci reklamowej w Twoim łańcuchu zapośredniczenia. Dlatego musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie z wytycznymi każdej z tych sieci, aby zapewnić zgodność z przepisami.

DT Exchange zawiera interfejs API, który umożliwia przekazywanie zgody użytkownika do pakietu SDK. Poniższy przykładowy kod pokazuje, jak ręcznie przekazać informacje o zgodzie użytkownika do pakietu DT SDK. Jeśli zdecydujesz się ręcznie przekazywać do pakietu SDK DT informacje o uzyskanej zgodzie, zalecamy wywoływanie tego kodu przed wysyłaniem żądań reklam za pomocą funkcji GMA Next-Gen SDK.

Java

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING);DTExchangeMediationSnippets.java

Kotlin

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING)DTExchangeMediationSnippets.kt

Zastąp US_PRIVACY_STRING ciągiem znaków dotyczącym prywatności w Stanach Zjednoczonych.

Więcej informacji i wartości, które mogą być podane w tej metodzie, znajdziesz w przewodniku po wdrażaniu CCPA DT Exchange.

Krok 5. Dodaj wymagany kod

Wczytywanie reklamy z kontekstem aktywności

Podczas ładowania formatów reklam pełnoekranowych przekazuj kontekst Activity. Bez kontekstu aktywności nie uda się wczytać reklamy.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe 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 ze źródeł reklam DT Exchange (określanie stawek) i DT Exchange (kaskadowe).

Kroki opcjonalne:

Parametry dotyczące sieci

Adapter DT Exchange obsługuje dodatkowe parametry żądania, które można przekazywać do adaptera jako pakiet Androida. Adapter wyszukuje w pakiecie te klucze:

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

Oto przykład kodu pokazujący, jak ustawić te parametry żądania reklamy:

Java

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

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(FyberMediationAdapter.class, extras).build();DTExchangeMediationSnippets.java

Kotlin

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

val request =
  AdRequest.Builder().addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras).build()DTExchangeMediationSnippets.kt

Kody błędów

Jeśli adapter nie otrzyma reklamy z DT Exchange, możesz sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z tego kodu:ResponseInfo.getAdSourceResponses() w tej klasie:

com.google.ads.mediation.fyber.FyberMediationAdapter

Oto kody i komunikaty wyświetlane przez adapter DT Exchange, gdy nie uda się wczytać 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 pasuje do rozmiaru banera obsługiwanego przez DT Exchange.
105	Pakiet DT SDK wczytał reklamę, ale zwrócił nieoczekiwany kontroler.
106	Reklama nie jest gotowa do wyświetlania.
107	Kontekst nie jest instancją aktywności.
108	Nie udało się wyświetlić reklamy.
200-399	Pakiet DT SDK zwrócił błąd. Więcej informacji znajdziesz w kodzie.

Historia zmian adaptera zapośredniczeń DT Exchange na Androida