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ą .
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ą | |
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 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 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
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 swojej 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 interfejsie
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 instrukcji na Android.
iOS
Instrukcje znajdziesz w kroku 2 przewodnika po iOS.
Dodaj do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi
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
OpenUPM-CLI
Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować w swoim projekcie wtyczkę zapośredniczenia DT Exchange dla reklam mobilnych Google dla Unity, uruchamiając to polecenie z katalogu głównego projektu:
openupm add com.google.ads.mobile.mediation.dtexchange
OpenUPM
W edytorze projektu Unity wybierz Edytuj > Ustawienia projektu > Menedżer pakietów, aby otworzyć ustawienia menedżera pakietów Unity.
Na karcie Rejestry o zakresie dodaj OpenUPM jako rejestr z ograniczonym dostępem z tymi informacjami:
- Nazwa:
OpenUPM - Adres URL:
https://package.openupm.com - Zakres:
com.google
Następnie kliknij Okno > Menedżer pakietów, aby otworzyć Menedżera pakietów Unity, a potem w menu kliknij Moje rejestry.
Wybierz pakiet Zapośredniczenie Google Mobile Ads DT Exchange i kliknij Zainstaluj.
Pakiet Unity
Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla DT Exchange, korzystając z linku do pobrania w Changelog, a potem wyodrębnij plikGoogleMobileAdsDTExchangeMediation.unitypackage z pliku ZIP.
W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsDTExchangeMediation.unitypackage. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Następnie wybierz Zasoby > Zewnętrzny menedżer zależności > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka menedżera zależności zewnętrznej wykona rozwiązanie zależności od podstaw i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android Twojej aplikacji Unity.
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 wymagają umożliwienia użytkownikom wycofania zgody na sprzedaż danych osobowych (w znaczeniu określonym w ustawie), za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej sprzedawcy. 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ć 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 są nieobecne lub nieprawidłowe. |
| 103 | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez 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 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 SDK DT Exchange 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.