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 DT Exchange do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera DT Exchange 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 w konsoli DT Exchange.
Kliknij przycisk Dodaj aplikację, aby dodać aplikację.
Wybierz platformę, wypełnij pozostałe pola formularza i kliknij Dodaj miejsca docelowe.
Android
iOS
Wpisz nazwę nowego miejsca docelowego w polu Nazwij miejsce docelowe i wybierz z listy odpowiedni Typ miejsca docelowego. Na koniec kliknij Zapisz miejsce docelowe.
Identyfikator aplikacji i identyfikator miejsca docelowego
Aby otworzyć lewy pasek nawigacyjny, najedź na niego kursorem myszy. W menu po lewej stronie kliknij Aplikacje.
Na stronie Zarządzanie aplikacjami zanotuj identyfikator aplikacji obok aplikacji.
Wybierz aplikację, otwórz kartę Miejsca docelowe i kliknij ikonę kopiowania obok Nazwa miejsca docelowego. Zanotuj identyfikator miejsca docelowego.
Identyfikator wydawcy, klucz klienta i tajny klucz 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 popyt w usłudze DT Exchange w AdMob interfejsie użytkownika
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 instrukcji na Androida.
iOS
Instrukcje znajdziesz w kroku 2 przewodnika po iOS.
Dodawanie partnerów reklamowych do listy zgodnej z RODO i przepisami stanowymi w USA
Wykonaj czynności opisane w ustawieniach dotyczących RODO i amerykań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 tę zależność z najnowszymi wersjami funkcji
DT Exchange Pakiet SDK i adapter w pakiecie
Plik pubspec.yaml:
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 sprawdź informacje o wtyczce w
pubspec.yaml przez dodanie tej zależności:
dependencies:
gma_mediation_dtexchange:
path: path/to/local/package
Krok 4. Wprowadź ustawienia prywatności w pakiecie SDK DT Exchange
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). Podczas uzyskiwania zgody musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe, a także podać informacje o sposobie ich wykorzystania. 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 „sprzedającego” dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”). Przewodnik dotyczący zgodności z przepisami stanowymi 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 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.
Zweryfikuj reklamy testowe
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ć podstawowy błąd w odpowiedzi na reklamę, używając parametru ResponseInfo w tej klasie:
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 | Brak parametrów serwera DT Exchange skonfigurowanych w AdMob interfejsie lub są 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świetlania. |
| 200-399 | Pakiet SDK DT Exchange zwrócił błąd. Więcej informacji znajdziesz w kodu. |
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.
- Zweryfikowano 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.