Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania z reklam DT Exchange za pomocą zapośredniczenia, obejmujących integracji kaskadowych. Omawiamy w nim, jak dodać DT Exchange do konfiguracji zapośredniczenia i integracji pakietu SDK DT Exchange oraz adaptera. do aplikacji. Unity
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia Ad Manager do DT Exchange ma te funkcje:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą |
Wymagania
- Najnowszy pakiet SDK do reklam mobilnych Google
- Unity 4 lub nowsza
- Do wdrożenia na Androidzie
- Interfejs API Androida na poziomie 21 lub wyższym
- Do wdrożenia na iOS
- Cel wdrożenia iOS w wersji 12.0 lub nowszej
- Działający Unity projekt skonfigurowany w Google Pakiet SDK do reklam mobilnych. Zobacz Rozpocznij, aby dowiedzieć się więcej.
- Dokończ 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 Przenoszenia danych
Wymiana za pomocą linku pobierania w
Historia zmian i wyodrębnienie
GoogleMobileAdsFyberMediation.unitypackage
z pliku ZIP.
W edytorze projektów Unity, wybierz Assets (Zasoby) > Importuj pakiet > Niestandardowy zakres dat
Spakuj i znajdź plik GoogleMobileAdsFyberMediation.unitypackage
,
pobrano. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Potem kliknij Komponenty > Program do rozpoznawania usług Google Play > Program do rozpoznawania Androida > Wymuś
Zakończ. Biblioteka programu do rozpoznawania usług Unity Play będzie działać w zależności
od zera i skopiować zadeklarowane zależności
Katalog Assets/Plugins/Android
Twojej aplikacji w Unity.
Krok 4. Wdroż ustawienia prywatności w pakiecie SDK DT Exchange
Zgoda użytkowników z UE i RODO
Obowiązujące w Google zgoda użytkownika z UE Google, musisz dopilnować, aby takie oświadczenia zostały ujawnione. zgody uzyskane od użytkowników z Europejskiego Obszaru Gospodarczego dotyczące: wykorzystywania identyfikatorów urządzeń i danych osobowych. Zasady te odzwierciedlają wymagania unijnej dyrektywy o prywatności i łączności elektronicznej oraz Ogólnej ustawy o ochronie danych Rozporządzenie (RODO). Wyświetlając prośbę o zgodę na wykorzystanie danych, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe i dostarczają informacji o korzystaniu z poszczególnych sieci. Google obecnie nie może automatycznego przekazywania do takich sieci 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 makro
klasa Fyber
z metodami SetGDPRRequired()
i SetGDPRConsentString()
,
co umożliwia ręczne
przekazywanie informacji o zgodzie do DT Exchange. Poniżej
przykładowy kod pokazujący, jak przekazywać te parametry do DT Exchange
adapter:
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");
Odwiedź DT Exchange RODO artykule , aby dowiedzieć się więcej oraz jakie wartości można podać w metodzie.
Amerykańskie przepisy stanowe o ochronie prywatności
Stany Zjednoczone przepisy stanowe o ochronie prywatności wymagają dawania użytkownikom zrezygnować z „wyprzedaży”, „danych osobowych” (zgodnie z definicją w ustawie tych haseł) z opcją rezygnacji dostępną za pomocą dobrze widocznego powiadomienia „Nie sprzedawaj Informacje” w wierszu „sprzedaż”, na stronie głównej strony. Stany Zjednoczone stanowa prywatność użytkowników przewodnik dotyczący zgodności z przepisami prawa umożliwia włączenie ograniczone przetwarzanie danych wyświetlania reklam przez Google, ale Google nie może stosować tego ustawienia do poszczególnych reklam w łańcuchu zapośredniczenia. W przypadku każdej sieci reklamowej należy w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży i postępuj zgodnie ze wskazówkami dotyczącymi tych sieci, aby zapewnić zgodność z przepisami.
Wtyczka zapośredniczenia do reklam mobilnych Google dla DT Exchange w wersji 3.1.1 dodała parametr
Klasa Fyber
z metodą SetCCPAString()
, która umożliwia przekazywanie zgody
ręcznie do DT Exchange. Poniższy przykładowy kod pokazuje,
aby 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();
Odwiedź stronę DT Exchange CCPA Open Źródło artykule , aby dowiedzieć się więcej oraz jakie wartości można podać w metodzie.
Krok 5. Dodaj wymagany kod
Android
Integracja z DT Exchange nie wymaga dodatkowego kodu.
iOS
Integracja SKAdNetwork
Postępuj zgodnie z instrukcjami DT Exchange
dokumentacja
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ć
bazowego błędu w odpowiedzi na żądanie reklamy za pomocą funkcji
ResponseInfo
w
klasa:
Android
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
Oto kody i powiązane z nimi wiadomości wysyłane przez adapter DT Exchange gdy nie można 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. Zobacz kod . |
iOS
Kod błędu | Przyczyna |
---|---|
0-10 | Pakiet SDK DT Exchange zwrócił błąd. Zobacz dokumentację . |
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.3.0
- Nazwa
DummyClient
została zmieniona naPlaceholderClient
. - Obsługuje adapter Androida DT Exchange w wersji 8.3.0.0.
- Obsługuje adapter iOS DT Exchange w wersji 8.3.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.2.0.
Wersja 3.2.1
- Obsługuje adapter DT Exchange na Androida w wersji 8.2.7.0.
- Obsługuje adapter iOS DT Exchange w wersji 8.3.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.1.
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
dodano 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.