Integracja DT Exchange z zapośredniczeniem

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ą Unity .

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
  • Unity 4 lub nowsza
  • 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 Unity projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • Przeczytaj Przewodnik 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ę.

Zarządzaj Aplikacjami

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.

Konfiguracja

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.

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 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 RODO i ustawieniach dotyczących przepisów stanowych w USA, aby dodać DT Exchange (Fyber Monetization) do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA w interfejsie Ad Managera.

Krok 3. Zaimportuj pakiet SDK i adapter DT Exchange

OpenUPM-CLI

Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę Google Mobile Ads DT Exchange Mediation Plugin for Unity, 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 Scoped Registries (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 Google Mobile Ads DT Exchange Mediation i kliknij Zainstaluj.

Instalowanie 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.

Importowanie 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 DT Exchange SDK

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. 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 w wersji 1.1.0 dla DT Exchange zawiera klasę Fyber z metodami SetGDPRRequired() i SetGDPRConsentString(), dzięki którym możesz ręcznie przekazywać informacje o zgodzie do DT Exchange. Poniższy przykładowy kod pokazuje, jak przekazywać 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

Przepisy stanowe w USA wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” swoich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu na stronie głównej podmiotu „sprzedającego” musi być umieszczony dobrze widoczny link „Nie sprzedawaj moich danych osobowych”. Przewodnik dotyczący zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w przypadku 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 do zapośredniczenia reklam mobilnych Google do 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 przekazywać 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 o wartościach, które można podać w ramach tej metody, znajdziesz w artykule CCPA OpenSource w DT Exchange.

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

Upewnij się, że urządzenie testowe jest zarejestrowane w Ad Managerze.

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 Ad Manager są nieprawidłowe lub ich brakuje.
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 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 Ad Manager są nieprawidłowe lub ich brakuje.
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 wtyczki DT Exchange Unity Mediation

Wersja 3.3.4

Wersja 3.3.3

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