Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z DT Exchange z wykorzystaniem zapośredniczenia w ramach integracji kaskadowej. Opisano w nim, jak dodać DT Exchange do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter DT Exchange z aplikacją Flutter .
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia AdMob dla DT Exchange ma te możliwości:
| Integracja | |
|---|---|
| Ustalanie stawek | |
| Wodospad | |
| Formaty | |
| Baner | |
| Pełnoekranowa | |
| Otrzymano | |
Wymagania
- Najnowszy pakiet SDK do reklam mobilnych Google
- Flutter w wersji 3.7.0 lub nowszej
- Aby przeprowadzić wdrożenie na Androidzie:
- Interfejs API Androida na poziomie 21 lub wyższym
- Aby wdrożyć w iOS:
- Wartość docelowa wdrożenia iOS w wersji 12.0 lub nowszej
- Działający Flutter projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google Więcej informacji znajdziesz w artykule Pierwsze kroki.
- Skorzystaj z zapośredniczenia Wprowadzenie
Krok 1. Skonfiguruj ustawienia w interfejsie użytkownika przenoszenia danych Exchange
Dodaj nowe miejsce docelowe aplikacji i reklamy
Zarejestruj się lub zaloguj w konsoli DT Exchange.
Kliknij przycisk Dodaj aplikację, aby dodać aplikację.
Wybierz platformę, wypełnij resztę 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
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.
Wybierz aplikację, otwórz kartę Miejsca docelowe i kliknij ikonę kopiowania obok opcji Nazwa miejsca docelowego. Zapisz 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 z giełdy 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.
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 AdMob UI.
Krok 3. Zaimportuj pakiet SDK i adapter DT Exchange
Integracja za pomocą pub.dev
Dodaj tę zależność do najnowszych wersji pakietuDT Exchange SDK i adaptera w pliku pubspec.yaml pakietu:
dependencies:
gma_mediation_dtexchange: ^1.0.0
Integracja ręczna
Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla DT Exchange, wyodrębnij pobrany plik i dodaj do projektu Flutter wyodrębniony folder wtyczki (wraz z jego zawartością). Następnie odwołaj się do wtyczki w pliku pubspec.yaml, dodając tę zależność:
dependencies:
gma_mediation_dtexchange:
path: path/to/local/package
Krok 4. Zaimplementuj 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 dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) udzielili określonych informacji na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz uzyskali od nich odpowiednie zgody. 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). Żeby uzyskać zgodę na wykorzystanie danych, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub wykorzystywać dane osobowe, a także dostarczać informacje o korzystaniu z nich przez poszczególne sieci. Obecnie Google nie może automatycznie przekazać zgody użytkownika na wykorzystanie danych do takich sieci.
Wtyczka zapośredniczenia do reklam mobilnych Google na potrzeby DT Exchange nie obsługuje przekazywania informacji o zgodzie do pakietu SDK DT Exchange.
Amerykańskie przepisy stanowe o ochronie prywatności
Amerykańskie przepisy stanowe o ochronie prywatności wymagają przyznania użytkownikom prawa do wycofania zgody na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie), przy czym opcja ta jest dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej sprzedającego. Przewodnik dotyczący zgodności z amerykańskimi przepisami stanowymi o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych na potrzeby wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia do żadnej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność z zasadami.
Wtyczka zapośredniczenia do reklam mobilnych Google na potrzeby DT Exchange nie obsługuje przekazywania informacji o zgodzie do pakietu SDK DT Exchange.
Krok 5. Dodaj wymagany kod
Android
Integracja z usługą DT Exchange nie wymaga dodatkowego kodu.
iOS
Integracja SKAdNetwork
Postępuj zgodnie z dokumentacją DT Exchange, aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu.
Krok 6. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby AdMob.
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.
Kody błędów
Jeśli adapter nie otrzyma reklamy z DT Exchange, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, używając klasy ResponseInfo w tej klasie:
Android
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
Oto kody i powiązane z nimi komunikaty wysyłane przez adapter DT Exchange, gdy nie można wczytać reklamy:
Android
| Kod błędu | Przyczyna |
|---|---|
| 101 | Brakuje parametrów serwera DT Exchange skonfigurowane w AdMob interfejsie użytkownika lub są one 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świetlania. |
| 200-399 | Pakiet SDK DT Exchange zwrócił błąd. Więcej informacji znajdziesz w kodzie. |
iOS
| Kod błędu | Przyczyna |
|---|---|
| 0-10 | Pakiet SDK DT Exchange zwrócił błąd. Więcej informacji znajdziesz w dokumentacji. |
| 101 | Brakuje parametrów serwera DT Exchange skonfigurowane w AdMob interfejsie użytkownika lub są one 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 z giełdy przenoszenia danych, ponieważ reklama nie jest gotowa. |
| 105 | Pakiet SDK DT Exchange zwrócił błąd inicjowania. |
1.0.0
- Pierwsza wersja.
- Zweryfikowana zgodność z adapterem Androida DT Exchange w wersji 8.2.6.1
- Zweryfikowana zgodność z adapterem DT Exchange na iOS w wersji 8.2.7.0