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

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

  • Unity 4 lub nowsza
  • Najnowszy pakiet SDK do reklam mobilnych Google
  • Aby przeprowadzić wdrożenie na Androidzie:
    • Interfejs API Androida na poziomie 19 lub wyższym
  • Aby wdrożyć w iOS:
    • Wartość docelowa wdrożenia iOS w wersji 12.0 lub nowszej
  • Działający projekt na Unity 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ę.

Zarządzaj Aplikacjami

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.

Konfiguracja

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.

Menu

Na stronie Zarządzanie aplikacjami zanotuj Identyfikator aplikacji obok swojej aplikacji.

Identyfikator aplikacji

Wybierz aplikację, otwórz kartę Miejsca docelowe i kliknij ikonę kopiowania obok opcji Nazwa miejsca docelowego. Zapisz Identyfikator miejsca docelowego.

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

Menu profilu użytkownika

Zapisz Identyfikator wydawcy, Klucz klienta i Tajny klucz klienta – będą one potrzebne w następnym kroku.

Profil użytkownika

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

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla DT Exchange, korzystając z linku pobierania w historii zmian, i wyodrębnij GoogleMobileAdsFyberMediation.unitypackage z pliku ZIP.

W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsFyberMediation.unitypackage. Zaznacz wszystkie pliki i kliknij Importuj.

Następnie wybierz Zasoby > Program do rozpoznawania Usług Google Play > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka programu do rozpoznawania zależności usług Unity Play zajmie się rozpoznawaniem zależności od zera i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android aplikacji Unity.

Krok 4. Zaimplementuj ustawienia prywatności w pakiecie SDK DT Exchange

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.

Ta sekcja dotyczy włączania i wyłączania reklam spersonalizowanych na potrzeby giełdy DT Exchange.

Wtyczka zapośredniczenia do 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 giełdy DT Exchange. Ten przykładowy kod pokazuje, jak przesłać te parametry do adaptera DT Exchange:

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

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

Więcej informacji i wartości, które mogą być podane w tej metodzie, znajdziesz w artykule o RODO dotyczącym giełdy przenoszenia danych.

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 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 przeniesienia danych do DT Exchange. Ten 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 oraz wartości, jakie można podać w tej metodzie, znajdziesz w artykule CCPA OpenSource na platformie 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.

Historia zmian wtyczki Unity Mediation DT Exchange

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