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

Integracja wymiany danych z zapośredniczeniem

Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z DT Exchange za pomocą mediacji, na temat integracji kaskadowych. Wyjaśniamy, jak dodać do reklamy DT Exchange. konfiguracji zapośredniczenia jednostki oraz integracji pakietu SDK DT Exchange. i adaptera Android do aplikacji.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia do DT Exchange ma te możliwości:

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

Wymagania

Interfejs API Androida na poziomie 21 lub wyższym

Najnowszy pakiet SDK do reklam mobilnych Google
Dokończ zapośredniczenie Przewodnik dla początkujących

Krok 1. Skonfiguruj konfiguracje w interfejsie DT Exchange

Dodaj nowe miejsce docelowe aplikacji i reklamy

Zarejestruj się lub zaloguj 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.

Wpisz nazwę nowego miejsca docelowego w polu Nazwij miejsce docelowe i wybierz z listy odpowiedni Typ miejsca docelowego. Na koniec kliknij Zapisz miejsce docelowe.

Konfiguracja

Identyfikator aplikacji i identyfikator miejsca docelowego

Otwórz lewy pasek nawigacyjny, najeżdżając na niego kursorem myszy. Następnie w menu po lewej stronie kliknij Aplikacje.

Na stronie Zarządzanie aplikacjami zanotuj Identyfikator aplikacji obok swojej aplikacji.

Identyfikator aplikacji

Wybierz aplikację, otwórz kartę Miejsca docelowe i kliknij ikonę kopiowania obok opcji Nazwa miejsca docelowego. Zapisz Identyfikator miejsca docelowego.

Identyfikator miejsca docelowego

Identyfikator wydawcy, klucz klienta i tajny klucz klienta

Kliknij swoją nazwę użytkownika w menu po lewej stronie i wybierz User Profile (Profil użytkownika).

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

Krok 2. Skonfiguruj popyt w usłudze DT Exchange w Ad Manager interfejsie użytkownika

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku.

Wpisz niepowtarzalną nazwę grupy zysku, ustaw Stan na Aktywna, wybierz Format reklamy, a jako Typ zasobów reklamowych wybierz Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcjach 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 przypadku usługiDT Exchange, możesz go wybrać. W przeciwnym razie kliknij 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 wpiszPublisher ID, Consumer Secret and Consumer Key uzyskane w poprzedniej sekcji.

Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako typ integracji, Android jako platformę i Aktywne jako stan. WpiszApplication ID and Placement ID uzyskane w poprzedniej sekcji. Następnie wpisz domyślną wartość CPM.

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

Dodaj Fyber do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi

Wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia amerykańskich przepisów stanowych , aby dodać Fyber do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w Ad Manager UI.

Krok 3. Zaimportuj pakiet SDK DT Exchange i adapter

Integracja z Android Studio (zalecana)

W pliku build.gradle.kts na poziomie aplikacji dodaj tę implementację zależności i konfiguracji. Użyj najnowszych wersji pakietu SDK DT Exchange i adapter:

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

Integracja ręczna

Pobierz najnowszą wersję DT Exchange SDK for Android i dodaj te pliki do projektu:
- 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 Artefakty adaptera DT Exchange w repozytorium Google Maven. Wybierz najnowszą wersję i pobierz plik przenoszenia danych Wymień plik .aar adaptera i dodaj go do projektu.

Krok 4. Wdroż ustawienia prywatności w pakiecie SDK DT Exchange

Zgoda użytkowników z UE i RODO

Obowiązujące w Google zgoda użytkownika z UE Google, musisz dopilnować, aby takie oświadczenia zostały ujawnione. zgody uzyskane od użytkowników z Europejskiego Obszaru Gospodarczego dotyczące: wykorzystywania identyfikatorów urządzeń i danych osobowych. Zasady te odzwierciedlają wymagania unijnej dyrektywy o prywatności i łączności elektronicznej oraz Ogólnej ustawy o ochronie danych Rozporządzenie (RODO). Wyświetlając prośbę o zgodę na wykorzystanie danych, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe i dostarczają informacji o korzystaniu z poszczególnych sieci. Google obecnie nie może automatycznego przekazywania do takich sieci wyboru użytkownika dotyczącego zgody.

DT Exchange zawiera interfejs API, który umożliwia przekazywanie zgody użytkownika do jego pakietu SDK. ten przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do DT Exchange ręcznie. Jeśli zdecydujesz się przekazywać informacje o zgodzie do giełdy DT: SDK ręcznie. Zaleca się, aby ten kod był wywoływany 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")

Otwórz stronę zasobów dotyczących RODO w DT Exchange i jej Przewodnik po implementacji RODO .

Amerykańskie przepisy stanowe o ochronie prywatności

Stany Zjednoczone przepisy stanowe o ochronie prywatności wymagają dawania użytkownikom zrezygnować z „wyprzedaży”, „danych osobowych” (zgodnie z definicją w ustawie tych haseł) z opcją rezygnacji dostępną za pomocą dobrze widocznego powiadomienia „Nie sprzedawaj Informacje” w wierszu „sprzedaż”, na stronie głównej strony. Stany Zjednoczone stanowa prywatność użytkowników przewodnik dotyczący zgodności z przepisami prawa umożliwia włączenie ograniczone przetwarzanie danych wyświetlania reklam przez Google, ale Google nie może stosować tego ustawienia do poszczególnych reklam w łańcuchu zapośredniczenia. W przypadku każdej sieci reklamowej należy w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży i postępuj zgodnie ze wskazówkami dotyczącymi tych sieci, aby zapewnić zgodność z przepisami.

DT Exchange zawiera interfejs API, który umożliwia przekazywanie zgody użytkownika do jego pakietu SDK. ten przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do usługi DT Exchange ręcznie. Jeśli zdecydujesz się przekazywać informacje o zgodzie do giełdy DT: SDK ręcznie. Zaleca się, aby ten kod był wywoływany przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

Java

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

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

Kotlin

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

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")

Odwiedź stronę zasobów CCPA DT Exchange i Przewodnik po implementacji ustawy CCPA .

Krok 5. Dodaj wymagany kod

Integracja z DT Exchange nie wymaga dodatkowego kodu.

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby Ad Manager.

Weryfikacja reklam testowych

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

Kroki opcjonalne:

Parametry charakterystyczne dla sieci

Adapter DT Exchange obsługuje dodatkowe parametry żądania, które można są przekazywane do adaptera w formie pakietu Android. Przejściówka sprawdza, czy: klucze w pakiecie:

Parametry i wartości żądania
`InneractiveMediationDefs.KEY_AGE`	Liczba całkowita. wiek użytkownika;
`FyberMediationAdapter.KEY_MUTE_VIDEO`	Wartość logiczna. Włączanie 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

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 odbierze reklamy z DT Exchange, możesz sprawdzić bazowy błąd w odpowiedzi na żądanie reklamy za pomocą funkcji ResponseInfo.getAdapterResponses() w ramach następujących zajęć:

com.google.ads.mediation.fyber.FyberMediationAdapter

Oto kody i powiązane z nimi wiadomości wysyłane przez adapter DT Exchange gdy nie można wczytać reklamy:

Kod błędu	Przyczyna
101	Brak parametrów serwera DT Exchange skonfigurowanych w Ad Manager interfejsie lub są nieprawidłowe.
103	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez DT Exchange.
105	Pakiet SDK DT Exchange wczytał reklamę, ale zwrócił nieoczekiwany kontroler.
106	Reklama nie jest gotowa do wyświetlenia.
200-399	Pakiet SDK DT Exchange zwrócił błąd. Zobacz kod .
0-10	Pakiet SDK DT Exchange zwrócił błąd. Zobacz dokumentację .
101	Brak parametrów serwera DT Exchange skonfigurowanych w Ad Manager interfejsie lub są nieprawidłowe.
102	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez DT Exchange.
103	Nie udało się wyświetlić reklamy, ponieważ obiekt reklamy został już użyty.
104	Nie udało się wyświetlić reklam DT Exchange, ponieważ reklama nie jest gotowa.
105	Pakiet SDK DT Exchange zwrócił błąd inicjowania.

DT Exchange – historia zmian adaptera zapośredniczenia Androida