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 pośrednictwa AdMob, uwzględniając integracje kaskadowe. Przewodnik ten zawiera informacje o dodawaniu pakietu DT Exchange do konfiguracji zapośredniczenia w jednostce reklamowej oraz o integrowaniu pakietu SDK i adaptera 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

Android API na poziomie 21 lub wyższym

Najnowsza wersja pakietu SDK do reklam mobilnych Google
Przeczytaj Przewodnik dla początkujących na temat zapośredniczenia.

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

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

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

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediation (Mediacja). Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, a potem 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 grupie zapośredniczenia nazwę i wybierz lokalizacje docelowe. Następnie ustaw stan grupy mediów na Włączona, a potem kliknij Dodaj jednostki reklamowe.

Połącz tę grupę zapośredniczenia z co najmniej jedną z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Karta Jednostki reklamowe powinna być teraz wypełniona wybranymi przez Ciebie jednostkami reklamowymi:

Dodawanie DT Exchange jako źródła reklam

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie wybierz DT Exchange.

Kliknij DT Exchange i włącz przełącznik Optymalizuj. Aby skonfigurować optymalizację źródeł reklam dla DT Exchange, wpisz identyfikator wydawcy, tajny klucz klienta i klucz klienta uzyskane w poprzedniej sekcji. Następnie wpisz wartość eCPM dla Google Display & Video 360 i kliknij Dalej.

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

Następnie wpisz Application ID (identyfikator aplikacji) i Placement ID (identyfikator miejsca docelowego), które zostały podane w poprzedniej sekcji. Następnie kliknij Gotowe.

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

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

Aby dodać DT Exchange (Fyber Monetization) do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA w interfejsie AdMob, wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia zgodne z przepisami stanowymi w USA.

Krok 3. Zaimportuj pakiet SDK i adapter DT Exchange

Integracja z Android Studio (zalecana)

W pliku build.gradle.kts na poziomie aplikacji dodaj te zależności i konfiguracje implementacji. 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.5.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 elementów interfejsu wymiany DT 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 przez każdą z nich. 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 pakietu SDK DT Exchange. 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

Amerykańskie przepisy stanowe o ochronie prywatności nakładają na sprzedawcę obowiązek zapewnienia użytkownikom możliwości rezygnacji ze „sprzedaży” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu na stronie głównej „sprzedawcy” należy umieścić dobrze widoczny link „Nie sprzedawaj moich danych osobowych”. Przewodnik po przepisach stanowych USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w celu 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 zachować 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

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob.

Weryfikacja 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ładowy kod, 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);

AdRequest request = new AdRequest.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 = 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 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ą generowane, gdy nie udaje się załadować 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 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 kodowaniu.