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ą Unity .
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia Ad Manager 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
- Unity 4 lub nowsza
- 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 Unity 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 Ad Manager interfejsie użytkownika
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 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 Ad Manager 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
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.
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 Ad Manager.
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 Ad Manager 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 Ad Manager 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.11
- Obsługuje adapter Androida DT Exchange w wersji 8.2.7.0.
- Obsługuje adaptera DT Exchange na iOS w wersji 8.2.7.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 3.1.10
- Obsługuje adaptera DT Exchange Android w wersji 8.2.6.1.
- Obsługuje adaptera DT Exchange na iOS w wersji 8.2.7.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 9.0.0.
Wersja 3.1.8
- Obsługuje adapter Androida DT Exchange w wersji 8.2.5.0.
- Obsługuje adaptera DT Exchange na iOS w wersji 8.2.6.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.6.0.
Wersja 3.1.7
- Obsługuje adapter Androida DT Exchange w wersji 8.2.4.0.
- Obsługuje adaptera DT Exchange na iOS w wersji 8.2.4.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.5.2.
Wersja 3.1.6
- Obsługuje adapter Androida DT Exchange w wersji 8.2.3.0.
- Obsługuje adaptera DT Exchange na iOS w wersji 8.2.3.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.4.1.
Wersja 3.1.5
- Treści adaptera zostały przeniesione do:
GoogleMobileAds/Mediation/DTExchange/
. - Zrefaktoryzowano przestrzeń nazw adaptera na
GoogleMobileAds.Mediation.DTExchange
. - Obsługuje adapter Androida DT Exchange w wersji 8.2.3.0.
- Obsługuje adaptera DT Exchange na iOS w wersji 8.2.1.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.1.0.
Wersja 3.1.4
- Obsługuje adapter Androida DT Exchange w wersji 8.2.2.0.
- Obsługuje adapter systemu iOS DT Exchange w wersji 8.1.9.1.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.4.1.
Wersja 3.1.3
- Obsługuje adapter Android DT Exchange w wersji 8.2.1.0.
- Obsługuje adaptera DT Exchange na iOS w wersji 8.1.9.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.4.0.
Wersja 3.1.2
- Zmieniliśmy nazwę wtyczki zapośredniczenia Unity na „DT Exchange”.
- Nazwa klasy
GoogleMobileAds.Api.Mediation.Fyber.Fyber
została zmieniona naGoogleMobileAds.Api.Mediation.DTExchange.DTExchange
. - Obsługuje adapter Android DT Exchange w wersji 8.2.1.0.
- Obsługuje adaptera DT Exchange na iOS w wersji 8.1.7.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.3.1.
Wersja 3.1.1
- Dodano do klasy
Fyber
te metody:SetCCPAString(string)
ClearCCPAString()
- Obsługuje adapter Fyber Android w wersji 8.2.0.0.
- Obsługuje adapter firmy Fyber iOS w wersji 8.1.6.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.3.0.
Wersja 3.1.0
- Obsługuje adapter Fyber Android w wersji 8.2.0.0.
- Obsługuje adapter firmy Fyber iOS w wersji 8.1.5.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.2.0.
Wersja 3.0.2
- Obsługuje adapter Fyber Android w wersji 8.1.3.1.
- Obsługuje adapter firmy Fyber iOS w wersji 8.1.5.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.0.2.
Wersja 3.0.1
- Obsługuje adapter Fyber Android w wersji 8.1.3.0.
- Obsługuje adapter firmy Fyber iOS w wersji 8.1.4.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 3.0.0
- Obsługuje adapter Fyber Android w wersji 8.1.2.0.
- Obsługuje adapter firmy Fyber iOS w wersji 8.1.2.0.
Wersja 2.0.0
- Obsługuje adapter Fyber Android w wersji 7.8.4.1.
- Obsługuje adapter firmy Fyber iOS w wersji 8.0.0.0.
Wersja 1.6.1
- Obsługuje adapter Fyber Android w wersji 7.8.3.0.
- Obsługuje adapter firmy Fyber iOS w wersji 7.8.6.0.
Wersja 1.6.0
- Obsługuje adapter Fyber Android w wersji 7.8.2.0.
- Obsługuje adapter firmy Fyber iOS w wersji 7.8.5.0.
Wersja 1.5.2
- Obsługuje adapter Fyber Android w wersji 7.7.4.0.
- Obsługuje adapter firmy Fyber iOS w wersji 7.7.3.0.
Wersja 1.5.1
- Obsługuje adapter Fyber Android w wersji 7.7.2.0.
- Obsługuje adapter firmy Fyber iOS w wersji 7.7.2.0.
Wersja 1.5.0
- Obsługuje adapter Fyber Android w wersji 7.7.1.0.
- Obsługuje adapter firmy Fyber iOS w wersji 7.7.1.0.
Wersja 1.4.0
- Obsługuje adapter Fyber Android w wersji 7.7.0.0.
- Obsługuje adapter firmy Fyber iOS w wersji 7.6.4.0.
Wersja 1.3.0
- Obsługuje adapter firmy Fyber Android w wersji 7.6.0.0.
- Obsługuje adapter firmy Fyber iOS w wersji 7.6.0.0.
Wersja 1.2.3
- Obsługuje adapter Fyber Android w wersji 7.5.4.0.
- Obsługuje adapter firmy Fyber iOS w wersji 7.5.6.0.
Wersja 1.2.2
- Obsługuje adapter Fyber Android w wersji 7.5.3.0.
- Obsługuje adapter firmy Fyber iOS w wersji 7.5.4.0.
Wersja 1.2.1
- Obsługuje adapter Fyber Android w wersji 7.5.2.0.
- Obsługuje adapter firmy Fyber iOS w wersji 7.5.3.0.
Wersja 1.2.0
- Obsługuje adapter Fyber Android w wersji 7.5.0.0.
- Obsługuje adapter firmy Fyber iOS w wersji 7.5.1.0.
Wersja 1.1.0
- Do klasy
Fyber
dodaliśmy te metody, aby zapewnić obsługę RODO:SetGDPRConsent()
SetGDPRConsentString()
ClearGDPRConsentData()
- Obsługuje adapter Fyber Android w wersji 7.3.4.0.
- Obsługuje adapter firmy Fyber iOS w wersji 7.5.0.0.
Wersja 1.0.0
- Pierwsza wersja!
- Obsługuje adapter Fyber Android w wersji 7.3.4.0.
- Obsługuje adapter firmy Fyber iOS w wersji 7.4.0.0.