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. Dowiesz się z niego, jak dodać DT Exchange do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK DT Exchange i adapter z aplikacją Unity .
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia Ad Manager do 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 wdrożyć to na Androidzie:
- Interfejs API Androida na poziomie 21 lub wyższym
- Aby wdrożyć w iOS:
- Cel 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 pierwszych krokach.
- Wykonaj zapośredniczenie Przewodnik dla początkujących
Krok 1. Skonfiguruj konfiguracje w interfejsie DT 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 w usłudze 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 DT Exchange i adapter
Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla DT Exchange, korzystając z linku pobierania w dzienniku 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
. Upewnij się, że wszystkie pliki są zaznaczone, 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 nazw usług Unity Play przeprowadzi rozpoznawanie zależności od zera i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
aplikacji w Unity.
Krok 4. Wdroż 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) otrzymali określone informacje na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz aby uzyskać od nich zgodę. 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). Podczas uzyskiwania zgody musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe, a także podać informacje o sposobie ich wykorzystania. Obecnie Google nie może automatycznie przekazać tym sieciom wyboru użytkownika dotyczącego zgody.
W tej sekcji dowiesz się, jak włączać i wyłączać reklamy spersonalizowane w 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 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 oraz wartości, które można podać w tej metodzie, znajdziesz w artykule RODO na platformie DT Exchange.
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 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. Musisz więc wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i zastosować się do zaleceń każdej z nich, by 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 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
Postępuj zgodnie z dokumentacją DT Exchange, by 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 reklamę, używając parametru 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 uda się wczytać reklamy:
Android
Kod błędu | Przyczyna |
---|---|
101 | Brak parametrów serwera DT Exchange skonfigurowanych w Ad Manager interfejsie lub są 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ś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 | Brak parametrów serwera DT Exchange skonfigurowanych w Ad Manager interfejsie lub są 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 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.2.0
- Obsługuje adapter DT Exchange na Androida w wersji 8.2.7.0.
- Obsługuje adapter iOS DT Exchange w wersji 8.3.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 3.1.12
- Obsługuje adapter DT Exchange na Androida w wersji 8.2.7.0.
- Obsługuje adapter iOS DT Exchange w wersji 8.2.8.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 3.1.11
- Obsługuje adapter DT Exchange na Androida w wersji 8.2.7.0.
- Obsługuje adapter iOS DT Exchange w wersji 8.2.7.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 3.1.10
- Obsługuje adapter Androida DT Exchange w wersji 8.2.6.1.
- Obsługuje adapter iOS DT Exchange w wersji 8.2.7.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki 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 adapter iOS DT Exchange w wersji 8.2.6.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki 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 adapter iOS DT Exchange w wersji 8.2.4.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.5.2.
Wersja 3.1.6
- Obsługuje adapter DT Exchange na Androida w wersji 8.2.3.0.
- Obsługuje adapter iOS DT Exchange w wersji 8.2.3.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.4.1.
Wersja 3.1.5
- Przeniesiono treść adaptera do:
GoogleMobileAds/Mediation/DTExchange/
. - Przestrzeń nazw adaptera została zmieniona na
GoogleMobileAds.Mediation.DTExchange
. - Obsługuje adapter DT Exchange na Androida w wersji 8.2.3.0.
- Obsługuje adapter iOS DT Exchange w wersji 8.2.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.1.0.
Wersja 3.1.4
- Obsługuje adapter DT Exchange na Androida w wersji 8.2.2.0.
- Obsługuje adapter iOS DT Exchange w wersji 8.1.9.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.4.1.
Wersja 3.1.3
- Obsługuje adapter Androida DT Exchange w wersji 8.2.1.0.
- Obsługuje adapter iOS DT Exchange w wersji 8.1.9.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.4.0.
Wersja 3.1.2
- Zmieniono nazwę wtyczki zapośredniczenia Unity na „DT Exchange”.
- Zmieniono nazwę klasy
GoogleMobileAds.Api.Mediation.Fyber.Fyber
naGoogleMobileAds.Api.Mediation.DTExchange.DTExchange
. - Obsługuje adapter Androida DT Exchange w wersji 8.2.1.0.
- Obsługuje adapter iOS DT Exchange w wersji 8.1.7.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.3.1.
Wersja 3.1.1
- Do klasy
Fyber
dodaliśmy te metody:SetCCPAString(string)
ClearCCPAString()
- Obsługuje adapter Faber Android w wersji 8.2.0.0.
- Obsługuje adapter Fyber na iOS w wersji 8.1.6.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.3.0.
Wersja 3.1.0
- Obsługuje adapter Faber Android w wersji 8.2.0.0.
- Obsługuje adapter Fyber na iOS w wersji 8.1.5.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.2.0.
Wersja 3.0.2
- Obsługuje adapter Faber Android w wersji 8.1.3.1.
- Obsługuje adapter Fyber na iOS w wersji 8.1.5.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.2.
Wersja 3.0.1
- Obsługuje adapter Faber Android w wersji 8.1.3.0.
- Obsługuje adapter Fyber na iOS w wersji 8.1.4.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 3.0.0
- Obsługuje adapter Faber Android w wersji 8.1.2.0.
- Obsługuje adapter Fyber na iOS w wersji 8.1.2.0.
Wersja 2.0.0
- Obsługuje adapter Faber Android w wersji 7.8.4.1.
- Obsługuje adapter Fyber na iOS w wersji 8.0.0.0.
Wersja 1.6.1
- Obsługuje adapter Faber Android w wersji 7.8.3.0.
- Obsługuje adapter Fyber na iOS w wersji 7.8.6.0.
Wersja 1.6.0
- Obsługuje adapter Faber Android w wersji 7.8.2.0.
- Obsługuje adapter Fyber na iOS w wersji 7.8.5.0.
Wersja 1.5.2
- Obsługuje adapter Faber Android w wersji 7.7.4.0.
- Obsługuje adapter Fyber na iOS w wersji 7.7.3.0.
Wersja 1.5.1
- Obsługuje adapter Faber Android w wersji 7.7.2.0.
- Obsługuje adapter Fyber na iOS w wersji 7.7.2.0.
Wersja 1.5.0
- Obsługuje adapter Faber Android w wersji 7.7.1.0.
- Obsługuje adapter Fyber na iOS w wersji 7.7.1.0.
Wersja 1.4.0
- Obsługuje adapter Faber Android w wersji 7.7.0.0.
- Obsługuje adapter Fyber na iOS w wersji 7.6.4.0.
Wersja 1.3.0
- Obsługuje adapter Faber Android w wersji 7.6.0.0.
- Obsługuje adapter Fyber na iOS w wersji 7.6.0.0.
Wersja 1.2.3
- Obsługuje adapter Faber Android w wersji 7.5.4.0.
- Obsługuje adapter Fyber na iOS w wersji 7.5.6.0.
Wersja 1.2.2
- Obsługuje adapter Faber Android w wersji 7.5.3.0.
- Obsługuje adapter Fyber na iOS w wersji 7.5.4.0.
Wersja 1.2.1
- Obsługuje adapter Faber Android w wersji 7.5.2.0.
- Obsługuje adapter Fyber na iOS w wersji 7.5.3.0.
Wersja 1.2.0
- Obsługuje adapter Faber Android w wersji 7.5.0.0.
- Obsługuje adapter Fyber na iOS w wersji 7.5.1.0.
Wersja 1.1.0
- Do klasy
Fyber
dodaliśmy te metody, aby spełnić wymagania RODO:SetGDPRConsent()
SetGDPRConsentString()
ClearGDPRConsentData()
- Obsługuje adapter Faber Android w wersji 7.3.4.0.
- Obsługuje adapter Fyber na iOS w wersji 7.5.0.0.
Wersja 1.0.0
- Pierwsza wersja!
- Obsługuje adapter Faber Android w wersji 7.3.4.0.
- Obsługuje adapter Fyber na iOS w wersji 7.4.0.0.