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

Krok 1. Skonfiguruj konfiguracje w interfejsie DT Exchange

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.google.ads.mediation:fyber:8.3.1.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

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). 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ć sieciom takich informacji.

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.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 według wskazówek każdej z tych sieci, zgodność z przepisami.

DT Exchange zawiera interfejs API, który umożliwia przekazywanie zgody użytkownika do jego pakietu SDK. Poniższy przykładowy kod pokazuje, jak ręcznie przekazywać informacje o zgodzie do interfejsu DT Exchange SDK. 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ład kodu, 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 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 odpowiada obsługiwanemu rozmiarowi banera w 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 .

Historia zmian adaptera zapośredniczenia DT Exchange na Androida

Wersja 8.3.1.0

  • Zweryfikowano zgodność z pakietem SDK DT Exchange 8.3.1.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 23.3.0.
  • Pakiet SDK DT Exchange w wersji 8.3.1.

Wersja 8.3.0.0

  • Dodaliśmy obsługę przekazywania wersji pakietu SDK do reklam mobilnych Google do pakietu SDK DT Exchange.
  • Weryfikowana zgodność z pakietem SDK DT Exchange w wersji 8.3.0.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 23.2.0.
  • Wersja pakietu SDK DT Exchange 8.3.0.

Wersja 8.2.7.0

  • Zweryfikowana zgodność z pakietem DT Exchange SDK 8.2.7.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 23.0.0.
  • Wersja pakietu SDK DT Exchange: 8.2.7.

Wersja 8.2.6.1

  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 23.0.0.
  • Zweryfikowano zgodność z pakietem SDK DT Exchange 8.2.6.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 23.0.0.
  • Pakiet SDK DT Exchange w wersji 8.2.6.

Wersja 8.2.6.0

  • Zweryfikowano zgodność z pakietem SDK DT Exchange 8.2.6.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.6.0.
  • Wersja pakietu SDK DT Exchange 8.2.6.

Wersja 8.2.5.0

  • Zweryfikowano zgodność z pakietem SDK DT Exchange 8.2.5.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.5.0.
  • Pakiet SDK DT Exchange w wersji 8.2.5.

Wersja 8.2.4.0

  • Zweryfikowano zgodność z pakietem SDK DT Exchange 8.2.4.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.3.0.
  • Pakiet SDK DT Exchange w wersji 8.2.4.

Wersja 8.2.3.0

  • Zaktualizowano adapter, aby używał nowej klasy VersionInfo.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 22.0.0.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
  • Pakiet SDK DT Exchange w wersji 8.2.3.

Wersja 8.2.2.1

  • Dodaliśmy obsługę przekazywania klucza muteVideo w ramach dodatku do zapośredniczenia, aby wyciszyć reklamy pełnoekranowe.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
  • Pakiet SDK DT Exchange w wersji 8.2.2.

Wersja 8.2.2.0

  • Zweryfikowano zgodność z pakietem SDK DT Exchange 8.2.2.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.5.0.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
  • Wersja pakietu SDK DT Exchange: 8.2.2.

Wersja 8.2.1.0

  • Zmieniono nazwę adaptera na „DT Exchange”.
  • Zweryfikowano zgodność z pakietem SDK DT Exchange 8.2.1.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.3.0.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.3.0.
  • Pakiet SDK DT Exchange w wersji 8.2.1.

Wersja 8.2.0.0

  • Potwierdzono zgodność z pakietem SDK Fyber 8.2.0.
  • Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google to 21.1.0.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.1.0.
  • Fyber SDK w wersji 8.2.0.

Wersja 8.1.5.0

  • Potwierdzono zgodność z pakietem SDK Fyber 8.1.5.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.0.0.
  • Fyber SDK w wersji 8.1.5.

Wersja 8.1.4.0

  • Potwierdzono zgodność z pakietem SDK Fyber 8.1.4.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.0.0.
  • Fyber SDK w wersji 8.1.4.

Wersja 8.1.3.1

  • Zaktualizowano compileSdkVersion i targetSdkVersion do interfejsu API 31.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.0.0.
  • Zaktualizowano minimalny wymagany poziom interfejsu API Androida na 19.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.0.0.
  • Fyber SDK w wersji 8.1.3.

Wersja 8.1.3.0

  • Potwierdzono zgodność z pakietem SDK Fyber 8.1.3.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.6.0.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.6.0.
  • Fyber SDK w wersji 8.1.3.

Wersja 8.1.2.0

  • Potwierdzono zgodność z pakietem SDK Fyber 8.1.2.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.5.0.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.5.0.
  • Fyber SDK w wersji 8.1.2.

Wersja 8.1.0.0

  • Zweryfikowano zgodność z pakietem SDK Fyber 8.1.0.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.4.0.
  • Fyber SDK w wersji 8.1.0.

Wersja 7.8.4.1

  • Rozwiązaliśmy problem, który powodował, że adapter nie inicjował się, jeśli w konfiguracji zapośredniczenia występuje duplikat lub więcej niż 1 niepowtarzalny identyfikator aplikacji.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.4.0.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.4.0.
  • Fyber SDK w wersji 7.8.4.

Wersja 7.8.4.0

  • Weryfikowana zgodność z pakietem Fyber SDK w wersji 7.8.4.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.3.0.
  • Rozwiązaliśmy problem z reklamami displayowymi z nagrodą, który powodował, że usługa onVideoComplete() nie była wywoływana.
  • Aby wyświetlać reklamy, Fyber wymaga teraz kontekstu aktywności.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.3.0.
  • Fyber SDK w wersji 7.8.4.

Wersja 7.8.3.0

  • Weryfikowana zgodność z Fyber SDK w wersji 7.8.3.
  • Dodaliśmy ujednolicone kody błędów i komunikaty o błędach adaptera.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.1.0.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.1.0.
  • Fyber SDK w wersji 7.8.3.

Wersja 7.8.2.0

  • Potwierdzono zgodność z pakietem SDK Fyber 7.8.2.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.0.0.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.0.0.
  • Fyber SDK w wersji 7.8.2.

Wersja 7.8.1.0

  • Zweryfikowana zgodność z Fyber SDK 7.8.1.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.7.0.
  • Wersja pakietu SDK Fyber: 7.8.1.

Wersja 7.8.0.0

  • Potwierdzono zgodność z pakietem SDK Fyber 7.8.0.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.7.0.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.7.0.
  • Fyber SDK w wersji 7.8.0.

Wersja 7.7.4.0

  • Potwierdzono zgodność z pakietem SDK Fyber 7.7.4.
  • Rozwiązaliśmy problem polegający na tym, że w przypadku reklam z nagrodą onUserEarnedReward() jest przekazywany 2 razy.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.5.0.
  • Fyber SDK w wersji 7.7.4.

Wersja 7.7.3.0

  • Potwierdzono zgodność z pakietem SDK Fyber 7.7.3.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.5.0.
  • Fyber SDK w wersji 7.7.3.

Wersja 7.7.2.0

  • Potwierdzono zgodność z pakietem SDK Fyber 7.7.2.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.5.0.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.5.0.
  • Fyber SDK w wersji 7.7.2.

Wersja 7.7.1.0

  • Potwierdzono zgodność z pakietem SDK Fyber 7.7.1.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 19.4.0.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.4.0.
  • Fyber SDK w wersji 7.7.1.

Wersja 7.7.0.0

  • Potwierdzono zgodność z pakietem SDK Fyber 7.7.0.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.3.0.
  • Fyber SDK w wersji 7.7.0.

Wersja 7.6.1.0

  • Potwierdzono zgodność z pakietem SDK Fyber 7.6.1.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.3.0.
  • Fyber SDK w wersji 7.6.1.

Wersja 7.6.0.0

  • Potwierdzono zgodność z pakietem SDK Fyber 7.6.0.
  • Zaktualizowano adapter, aby obsługiwał żądania wbudowanych banerów adaptacyjnych.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.3.0.
  • Usunęliśmy błąd, który powodował, że dla banerów reklamowych nie były wywoływane metody onAdOpened()/onAdClosed().

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.3.0.
  • Fyber SDK w wersji 7.6.0.

Wersja 7.5.4.0

  • Potwierdzono zgodność z pakietem SDK Fyber 7.5.4.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.1.0.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
  • Fyber SDK w wersji 7.5.4.

Wersja 7.5.3.0

  • Weryfikowana zgodność z pakietem Fyber SDK w wersji 7.5.3.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.0.1.
  • Fyber SDK w wersji 7.5.3.

Wersja 7.5.2.0

  • Weryfikowana zgodność z Fyber SDK 7.5.2.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.0.1.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.0.1.
  • Wersja pakietu SDK Fyber: 7.5.2.

Wersja 7.5.0.0

  • Weryfikowana zgodność z pakietem SDK Fyber w wersji 7.5.0.
  • Usunięto błąd NullPointerException podczas wczytywania reklamy Fyber.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 18.3.0.
  • Fyber SDK w wersji 7.5.0.

Wersja 7.4.1.0

  • Potwierdzono zgodność z pakietem SDK Fyber 7.4.1.
  • Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 18.3.0.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 18.3.0.
  • Fyber SDK w wersji 7.4.1.

Wersja 7.3.4.0

  • Pierwsza wersja!
  • Obsługuje reklamy banerowe, pełnoekranowe i z nagrodą.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 18.2.0.
  • Fyber SDK w wersji 7.3.4.