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 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 AdMob 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ę.

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 w usłudze 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 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

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 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 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 AdMob 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 AdMob 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

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