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

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

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 AdMob. Przewodnik obejmuje integracje kaskadowe. 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 z interfejsem API na poziomie 24 lub wyższym.
[Określanie 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 AdMob.

Krok 1. Skonfiguruj ustawienia w interfejsie DT Exchange

Dodawanie nowej aplikacji i miejsca docelowego reklamy

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

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 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) 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 User Profile (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, skonfiguruj go pod kątem swojej aplikacji.

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 AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać DT Exchange do konfiguracji zapośredniczenia jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie DT Exchange jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.

Wpisz format reklamy i platformę, a potem kliknij Dalej.

Nadaj nazwę grupie zapośredniczenia i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z co najmniej jedną z istniejących jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Powinna się teraz wyświetlić karta jednostek reklamowych z wybranymi przez Ciebie jednostkami:

Dodawanie DT Exchange jako źródła reklam

Określanie stawek

W sekcji Źródła reklam znajdź kartę Ustalanie stawek i kliknij Dodaj źródło reklam. Następnie wybierz DT Exchange.

Kliknij Jak podpisać umowę partnerską i skonfiguruj partnerstwo z określaniem stawek z DT Exchange.

Kliknij Potwierdź i zaakceptuj, a następnie Dalej.

Jeśli masz już mapowanie dla DT Exchange, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz identyfikator aplikacji i identyfikator miejsca docelowego uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Kaskada

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklam.

Wybierz DT Exchange i włącz przełącznik Optymalizuj. Aby skonfigurować optymalizację źródła reklam DT Exchange, wpisz identyfikator wydawcy, klucz tajny klienta i klucz klienta uzyskane w poprzedniej sekcji. Następnie wpisz wartość eCPM dla DT Exchange i kliknij Dalej.

Jeśli masz już mapowanie dla DT Exchange, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz identyfikator aplikacji i identyfikator miejsca docelowego uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Uwaga: optymalizacja źródła reklam wymaga kilku dni na zebranie wystarczającej ilości danych, aby dokładnie obliczyć eCPM dla sieci zapośredniczenia. W tym czasie stan optymalizacji źródła reklam to PENDING, więc musisz ręcznie ustawić wartość eCPM dla sieci. Gdy będzie można obliczyć eCPM, źródło reklam automatycznie zacznie aktualizować eCPM w Twoim imieniu.

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

Wykonaj czynności opisane w sekcjach Ustawienia zgodne z rozporządzeniami europejskimi i Ustawienia zgodne z przepisami stanowymi w USA, aby dodać DT Exchange (Fyber Monetization) do listy partnerów reklamowych zgodnych z rozporządzeniami europejskimi i przepisami stanowymi w USA w interfejsie AdMob.

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

Zakręcony

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

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 udzielać odpowiednich informacji użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane prawnie. Musisz też uzyskać 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). 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 (zasadami TCF), do pakietu SDK DT Exchange. 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 możliwość wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). Opcja ta musi być dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej podmiotu „sprzedającego”. Przewodnik po amerykańskich przepisach stanowych 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 CCPA DT Exchange.

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 AdMob.

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 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 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();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ć błąd w odpowiedzi na reklamę, używając metody 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 AdMob 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.

Lista zmian adaptera zapośredniczenia DT Exchange na Androida