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
Ad Manager 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ę.
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.
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.
Wybierz aplikację, otwórz kartę Miejsca docelowe i kliknij ikonę kopiowania obok Nazwa miejsca docelowego. Zanotuj 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 na wymianę danych w Ad Manager 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 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 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
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.
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.
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 Ad Manager 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 Ad Manager 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.