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 mediacji, w tym integracji kaskadowych. Przewodnik zawiera informacje o dodawaniu pakietu DT Exchange do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu DT Exchange SDK i adaptera z aplikacją Flutter .

Obsługiwane integracje i formaty reklam

AdMob Adapter pośredniczący DT Exchange ma te funkcje:

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

Wymagania

  • Najnowsza wersja pakietu SDK do reklam mobilnych Google
  • Flutter 3.7.0 lub nowszy
  • Aby wdrożyć na Androidzie:
    • Poziom interfejsu API 21 lub nowszy
  • Aby wdrożyć aplikację na iOS:
    • docelowa wersja iOS 12.0 lub nowsza,
  • działający Flutter projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.

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.

Android

iOS

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.

Menu

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

Menu profilu użytkownika

Zanotuj identyfikator wydawcy, klucz klienta i klucz tajny klienta, ponieważ będą Ci potrzebne w następnym kroku.

Profil użytkownika

Krok 2. Skonfiguruj zapotrzebowanie na wymianę danych w  AdMob interfejsie

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym Android.

iOS

Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym iOS.

Dodawanie Fyber do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA

Wykonaj czynności opisane w ustawieniach dotyczących RODOamerykańskich przepisów stanowych, aby dodać DT Exchange (Fyber Monetization) do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w interfejsie AdMob.

Krok 3. Zaimportuj pakiet SDK i adapter DT Exchange

Integracja przez pub.dev

Dodaj te zależności z najnowszymi wersjami pakietuDT Exchange SDK i adaptera w pliku pubspec.yaml pakietu:

dependencies:
  gma_mediation_dtexchange: ^1.0.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki do zapośredniczenia reklam mobilnych Google dla DT Exchange, wyodrębnij pobrany plik i dodaj wyodrębniony folder wtyczki (oraz jego zawartość) do projektu Flutter. Następnie odwołuj się do wtyczki w pliku pubspec.yaml, dodając tę zależność:

dependencies:
  gma_mediation_dtexchange:
    path: path/to/local/package

Krok 4. Wprowadź ustawienia prywatności w pakiecie SDK DT Exchange

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.

Wtyczka zapośredniczenia reklam mobilnych Google dla DT Exchange nie obsługuje przekazywania informacji o zgodzie do pakietu DT Exchange SDK.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności nakładają na Ciebie obowiązek zapewnienia użytkownikom możliwości wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu musisz umieścić na stronie głównej podmiotu sprzedającego dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”). Przewodnik po przepisach stanowych USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w przypadku 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 zapewnić zgodność.

Wtyczka zapośredniczenia reklam mobilnych Google dla DT Exchange nie obsługuje przekazywania informacji o zgodzie do pakietu DT Exchange SDK.

Krok 5. Dodaj wymagany kod

Android

Integracja z DT Exchange nie wymaga dodatkowego kodu.

iOS

Integracja z SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, skorzystaj z dokumentacji DT Exchange.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

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

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

Kody błędów

Jeśli adapter nie otrzyma reklamy z DT Exchange, wydawcy mogą sprawdzić błąd podstawowy w odpowiedzi reklamy, używając ResponseInfo w ramach tej klasy:

Android

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

Oto kody i odpowiednie komunikaty z adaptera DT Exchange, które są wyświetlane, gdy nie udaje się załadować reklamy:

Android

Kod błędu Przyczyna
101 Parametry serwera DT Exchange skonfigurowane w interfejsie użytkownika AdMob są nieobecne lub nieprawidłowe.
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.

iOS

Kod błędu Przyczyna
0-10 Pakiet SDK DT Exchange zwrócił błąd. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją.
101 Parametry serwera DT Exchange skonfigurowane w interfejsie użytkownika AdMob są nieobecne lub nieprawidłowe.
102 Żądany rozmiar reklamy nie odpowiada obsługiwanemu rozmiarowi banera w 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 DT Exchange SDK zwrócił błąd inicjowania.

Historia zmian adaptera DT Exchange do zapośredniczenia reklam w Flutterze

Następna wersja

  • Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.2.0.

1.1.0

  • Weryfikowana zgodność z adapterem DT Exchange na Androida w wersji 8.3.0.0.
  • Weryfikowana zgodność z adapterem DT Exchange na iOS w wersji 8.3.1.0.
  • Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.

1.0.0

  • Pierwsza wersja.
  • Weryfikowana zgodność z adapterem DT Exchange na Androida w wersji 8.2.7.0.
  • Weryfikowana zgodność z adapterem DT Exchange na iOS w wersji 8.2.8.0.
  • Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.