Integracja DT Exchange z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z DT Exchange za pomocą zapośredniczenia obejmującego integracje kaskadowe. Przewodnik zawiera informacje o dodawaniu DT Exchange do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera DT Exchange z aplikacją Unity .

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
  • Unity 4 lub nowsza
  • Aby wdrożyć na Androidzie:
    • Interfejs API Androida na poziomie 21 lub wyższym
  • Aby wdrożyć aplikację na iOS:
    • docelowa wersja iOS 12.0 lub nowsza
  • działający Unity projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w pierwszych krokach.
  • Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.

Krok 1. Skonfiguruj konfiguracje w interfejsie DT Exchange

Dodaj nowe miejsce docelowe reklamy i aplikacji

Zarejestruj się lub zaloguj się w konsoli DT Exchange.

Kliknij przycisk Dodaj aplikację, aby dodać aplikację.

Zarządzaj Aplikacjami

Wybierz platformę, wypełnij pozostałe pola 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

Aby otworzyć lewy pasek nawigacyjny, najedź na niego kursorem myszy. 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 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.

Dodaj Fyber do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi

Wykonaj czynności opisane w sekcji Ustawienia dotyczące RODO i Ustawienia przepisów stanowych USA, 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 DT Exchange i adapter

OpenUPM-CLI

Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować wtyczkę Google Mobile Ads DT Exchange Mediation dla Unity w projekcie, uruchamiając to polecenie w katalogu głównym 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 ograniczone dodaj OpenUPM jako rejestr ograniczony z tymi informacjami:

  • Nazwa: OpenUPM
  • Adres URL: https://package.openupm.com
  • Zakres: com.google

Szczegóły UPM

Następnie kliknij Okno > Menedżer pakietów, aby otworzyć Menedżera pakietów Unity, a potem w menu kliknij Moje rejestry.

Rejestry Unity

Wybierz pakiet Zapośredniczenie przenoszenia danych z reklam mobilnych Google i kliknij Zainstaluj.

Zainstaluj z OpenUPM

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.

Importuj z Unity

Następnie kliknij Zasoby > Menedżer zależności zewnętrznych > Rozwiązanie 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.

Wymuś rozwiązanie

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.

Z tej sekcji dowiesz się, jak włączać i wyłączać reklamy spersonalizowane w DT Exchange.

Wtyczka do zapośredniczenia reklam mobilnych Google dla DT Exchange w wersji 1.1.0 dodała klasę Fyber z metodami SetGDPRRequired() i SetGDPRConsentString(), co umożliwia ręczne przekazywanie informacji o zgodzie do DT Exchange. Ten przykładowy kod pokazuje, jak przekazać te parametry do adaptera DT Exchange:

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");

Więcej informacji o metodach, w których można podać wartości, znajdziesz w artykule GDPR na temat DT Exchange.

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 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 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 do reklam mobilnych Google dla DT Exchange w wersji 3.1.1 dodała klasę Fyber z metodą SetCCPAString(), co umożliwia ręczne przekazywanie informacji o zgodzie do DT Exchange. Poniższy przykładowy kod pokazuje, jak przekazać te parametry do adaptera DT Exchange:

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetCCPAString("myCCPAConsentString");

// You can also clear CCPA consent information using the following method:
Fyber.ClearCCPAString();

Więcej informacji oraz wartości, które można podać w tej metodzie, znajdziesz w artykule CCPA Open Source opublikowanego przez DT Exchange.

Krok 5. Dodaj wymagany kod

Android

Integracja z DT Exchange nie wymaga dodatkowego kodu.

iOS

Integracja SKAdNetwork

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

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Pamiętaj, by 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 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 opisie kodu.

iOS

Kod błędu Przyczyna
0-10 Pakiet SDK DT Exchange zwrócił błąd. Więcej informacji znajdziesz w dokumentacji.
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 SDK DT Exchange zwrócił błąd inicjowania.

Historia zmian wtyczki DT Exchange Unity Mediation

Wersja 3.3.2

Wersja 3.3.1

Wersja 3.3.0

Wersja 3.2.1

Wersja 3.2.0

Wersja 3.1.12

Wersja 3.1.11

Wersja 3.1.10

Wersja 3.1.8

Wersja 3.1.7

Wersja 3.1.6

Wersja 3.1.5

Wersja 3.1.4

Wersja 3.1.3

Wersja 3.1.2

Wersja 3.1.1

Wersja 3.1.0

Wersja 3.0.2

Wersja 3.0.1

Wersja 3.0.0

Wersja 2.0.0

Wersja 1.6.1

Wersja 1.6.0

Wersja 1.5.2

Wersja 1.5.1

Wersja 1.5.0

Wersja 1.4.0

Wersja 1.3.0

Wersja 1.2.3

Wersja 1.2.2

Wersja 1.2.1

Wersja 1.2.0

Wersja 1.1.0

Wersja 1.0.0