Pakiet SDK do reklam mobilnych Google jest w trybie konserwacji. Aby korzystać z najnowszych aktualizacji i funkcji, migrate na pakiet SDK nowej generacji do reklam mobilnych Google i go skonfiguruj.

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

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads SDK (Legacy) do wczytywania i wyświetlania reklam z DT Exchange za pomocą zapośredniczenia, w tym integracji kaskadowych. Dowiesz się z niego, 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 zapośredniczenia DT Exchange ma te możliwości:

Integracja
Określanie stawek
Kaskada
Formaty
Baner
Pełnoekranowa
Z nagrodą
Rodzimy użytkownik

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

Android API na poziomie 24 lub wyższym.
[W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w określaniu stawek, użyj adaptera DT Exchange w wersji 8.4.2.0 lub nowszej (zalecamy najnowszą wersję).

Najnowsza wersja Google Mobile Ads SDK (Legacy).
Skonfiguruj zapośredniczenie.

Krok 1. Skonfiguruj ustawienia w interfejsie DT Exchange

Dodawanie nowej aplikacji i miejsca docelowego reklamy

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

Kliknij Add App (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 Twoich miejsc. 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 App Management (Zarządzanie aplikacjami) zapisz App ID (Identyfikator aplikacji) widoczny obok aplikacji.

Wybierz aplikację i przejdź na 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.

Zanotuj Publisher ID (Identyfikator wydawcy), Consumer Key (Klucz klienta) i Consumer Secret (Klucz tajny klienta), ponieważ będą Ci potrzebne w następnym kroku.

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 znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze nie masz pliku app-ads.txt, utwórz go na potrzeby Ad Managera.

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

Krok 2. Skonfiguruj żądania 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 następnie na karcie Wszystkie firmy kliknij przycisk Nowa firma. Kliknij Sieć reklamowa.

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

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

Włącz udostępnianie bezpiecznych sygnałów

Określanie stawek

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

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Udostępnianie bezpiecznego sygnału 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ę aplikacyjną.

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 Wyświetlanie > Ustawienia na potrzeby kanałów popytu. Na karcie Ustawienia domyślne włącz opcję Zezwalaj na udostępnianie bezpiecznych sygnałów w przypadku określania stawek przez pakiet SDK.

Kliknij Zapisz.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie ustalania stawek na giełdzie DT

Określanie stawek

Kliknij kolejno Wyświetlanie > Licytujący i wybierz 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 wybierz Otwórz Określanie stawek przez pakiet SDK.

Wybierz firmę 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 wybierz Nowa grupa zysku. Wybierz Zasoby reklamowe i Aplikacja.

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

Wybierz firmę utworzoną dla DT Exchange w poprzedniej sekcji. 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ślny CPM. Kliknij Zapisz.

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

Aby dodać DT Exchange (Fyber Monetization) do listy partnerów reklamowych zgodnych z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie Ad Managera, wykonaj czynności opisane w artykułach: Ustawienia zgodne z rozporządzeniami europejskimi i Ustawienia zgodne z amerykańskimi przepisami stanowymi.

Krok 3. Zaimportuj pakiet SDK i adapter DT

Integracja z Android Studio (zalecana)

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

Kotlin

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

Zakręcony

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:fyber:8.5.1.0'
}

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK DT 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. Skonfiguruj 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 przekazać określone informacje użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na wykorzystywanie plików cookie lub innych lokalnych metod przechowywania danych, jeśli jest to wymagane przez prawo, a także na gromadzenie, udostępnianie i wykorzystywanie danych osobowych do 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 lub nowszej obsługuje przekazywanie do pakietu SDK DT Exchange 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. Więcej informacji znajdziesz w artykule RODO.

amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli prawo do rezygnacji ze „sprzedaży” ich „danych osobowych” (w znaczeniu określonym w ustawie). Opcja ta musi być dostępna za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej podmiotu „sprzedającego”. Przewodnik po 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 nie może zastosować tego ustawienia 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 ze wskazówkami 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 do pakietu DT SDK. Jeśli zdecydujesz się ręcznie przekazywać informacje o zgodzie do pakietu SDK DT, zalecamy wywołanie tego kodu przed wysłaniem żądania reklam za pomocą Google Mobile Ads SDK (Legacy).

Java

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING);DTExchangeMediationSnippets.java

Kotlin

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING)DTExchangeMediationSnippets.kt

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

Więcej informacji oraz wartości, które można podać w metodzie, znajdziesz w przewodniku po implementacji DT Exchange zgodnej z ustawą CCPA.

Krok 5. Dodaj wymagany kod

Wczytywanie reklamy z kontekstem aktywności

Podczas wczytywania formatów reklam pełnoekranowych przekazuj kontekst Activity. Bez kontekstu aktywności wczytywanie reklamy się nie powiedzie.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w usłudze Ad Manager.

Sprawdzanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z DT Exchange, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając ze źródeł reklam DT Exchange (określanie stawek) i DT Exchange (kaskada).

Kroki opcjonalne:

Parametry dotyczące sieci

Adapter DT Exchange obsługuje dodatkowe parametry żądania, które można przekazać 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ładowy kod 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();

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()

Kody błędów

Jeśli adapter nie otrzyma reklamy z DT Exchange, możesz sprawdzić błąd w odpowiedzi na reklamę, korzystając z funkcji ResponseInfo.getAdapterResponses() w tej klasie:

com.google.ads.mediation.fyber.FyberMediationAdapter

Oto kody i powiązane z nimi komunikaty, które adapter DT Exchange wyświetla, 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świetlenia.
107	Kontekst nie jest instancją aktywności.
108	Nie udało się wyświetlić reklamy.
200-399	Pakiet SDK DT zwrócił błąd. Więcej informacji znajdziesz w kodzie.