Integracja DT Exchange z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads Unity Plugin wczytywać i wyświetlać reklamy z DT Exchange przy użyciu mediacji, w tym integracji kaskadowych. Wyjaśniamy w nim, jak dodać DT Exchange do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter DT Exchange z aplikacją Unity.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia Unity dla DT Exchange ma te możliwości:

Integracja
Określanie stawek
Kaskada
Formaty
Baner
Pełnoekranowa
Z nagrodą
Natywna

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

  • Najnowsza wersja Google Mobile Ads Unity Plugin.
  • Unity Editor w wersji 4 lub nowszej.
  • [W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam z określaniem stawek, użyj wtyczki zapośredniczenia reklam mobilnych Google dla DT Exchange w wersji 3.3.12 lub nowszej (zalecana jest najnowsza wersja).
  • Wdrażanie na Androidzie
    • Android API na poziomie 24 lub wyższym.
  • Aby wdrożyć na iOS:
    • iOS w wersji 15.0 lub nowszej.
  • Działający projekt Unity skonfigurowany za pomocą Google Mobile Ads Unity Plugin. Szczegółowe informacje znajdziesz w artykule Konfigurowanie Google Mobile Ads Unity Plugin.
  • Skonfiguruj zapośredniczenie.

    • Krok 1. Skonfiguruj ustawienia w interfejsie DT Exchange

    Dodawanie nowej aplikacji i nowego miejsca docelowego reklamy

    Zarejestruj się lub zaloguj się w DT Exchange Console.

    Kliknij Dodaj aplikację.

    Zarządzaj Aplikacjami

    Wybierz platformę i miejsca docelowe, wypełnij pozostałą część formularza, a następnie kliknij Create App (Utwórz aplikację).

    Android

    iOS

    Wpisz nazwy i wybierz typy Twoich miejsc. Następnie kliknij Zapisz miejsce docelowe.

    Konfiguracja

    Identyfikator aplikacji i identyfikator miejsca docelowego

    Najedź kursorem na pasek nawigacyjny po lewej stronie, aby go otworzyć, a następnie kliknij Zarządzanie aplikacjami.

    Na stronie Zarządzanie aplikacjami zapisz Identyfikator aplikacji obok aplikacji.

    Wybierz aplikację i przejdź na kartę Miejsca docelowe. Zanotuj identyfikator miejsca docelowego.

    Identyfikator miejsca docelowego

    Identyfikator wydawcy, klucz klienta i klucz tajny klienta

    W menu po lewej stronie kliknij swoją nazwę użytkownika i wybierz User Profile (Profil użytkownika).

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

    Profil użytkownika

    Zaktualizuj plik app-ads.txt

    Plik Authorized Sellers for Apps app-ads.txt to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze tego nie zrobiono, utwórz plik app-ads.txt na potrzeby Ad Managera.

    Aby wdrożyć app-ads.txt w przypadku DT Exchange, dodaj DT do pliku app-ads.txt.

    Krok 2. Skonfiguruj popyt DT Exchange w interfejsie Ad Managera

    Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

    Android

    Instrukcje znajdziesz w kroku 2 w przewodniku dla Android.

    iOS

    Instrukcje znajdziesz w kroku 2 w przewodniku dla systemu iOS.

    Dodawanie DT Exchange do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi dotyczącymi prywatności

    Wykonaj czynności opisane w sekcjach Ustawienia zgodne z rozporządzeniami europejskimi i Ustawienia zgodne z przepisami stanowymi w USA, aby dodać DT Exchange (Fyber Monetization) do listy partnerów reklamowych zgodnych z rozporządzeniami europejskimi i przepisami stanowymi w USA w interfejsie Ad Managera.

    Krok 3. Zaimportuj pakiet SDK i adapter DT Exchange

    OpenUPM-CLI

    Jeśli masz zainstalowane narzędzie OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę DT Exchange zapośredniczenia Google Mobile Ads do Unity, uruchamiając to polecenie w katalogu głównym projektu:

    openupm add com.google.ads.mobile.mediation.dtexchange

    OpenUPM

    W edytorze projektu Unity wybierz Edit (Edytuj) > Project Settings (Ustawienia projektu) > Package Manager (Menedżer pakietów), aby otworzyć Unity Package Manager Settings (Ustawienia menedżera pakietów Unity).

    Na karcie Scoped Registries (Rejestry ograniczone) dodaj OpenUPM jako rejestr ograniczony z tymi informacjami:

    • Nazwa: OpenUPM
    • URL: https://package.openupm.com
    • Zakresy: com.google

    Szczegóły OpenUPM

    Następnie kliknij Window (Okno) > Package Manager (Menedżer pakietów), aby otworzyć Unity Package Manager (Menedżer pakietów Unity), i wybierz My Registries (Moje rejestry) z menu.

    Rejestry Unity

    Wybierz pakiet Google Mobile Ads DTExchange Mediation i kliknij Zainstaluj.

    Instalowanie z OpenUPM

    Pakiet Unity

    Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla DT Exchange, korzystając z linku do pobierania w dzienniku zmian, a następnie wyodrębnij plik GoogleMobileAdsDTExchangeMediation.unitypackage z pliku ZIP.

    W edytorze projektu Unity kliknij Assets (Zasoby) > Import Package (Importuj pakiet) > Custom Package (Pakiet niestandardowy) i znajdź pobrany plik GoogleMobileAdsDTExchangeMediation.unitypackage. Sprawdź, czy wszystkie pliki są zaznaczone, i kliknij Importuj.

    Importowanie z Unity

    Następnie kliknij Assets (Zasoby) > External Dependency Manager (Menedżer zależności zewnętrznych) > Android Resolver (Narzędzie do rozwiązywania problemów z Androidem) > Force Resolve (Wymuś rozwiązanie). Biblioteka External Dependency Manager przeprowadzi od podstaw proces rozwiązywania zależności i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android aplikacji Unity.

    Wymuś rozwiązanie

    Krok 4. Wdróż ustawienia prywatności w pakiecie DT Exchange SDK

    Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz udzielać odpowiednich informacji użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane prawnie. Musisz też uzyskać ich zgodę na zbieranie, udostępnianie i wykorzystywanie danych osobowych do personalizowania reklam. 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). Odpowiadasz za sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu zapośredniczenia.

    Adapter DT Exchange Unity w wersji 3.3.0 i nowszych obsługuje przekazywanie sygnałów zgody na wykorzystanie danych zgodnie z RODO z platform do zarządzania zgodą użytkowników, które są zintegrowane z opracowanymi przez IAB zasadami dotyczącymi przejrzystości i uzyskiwania zgody na przetwarzanie danych (TCF), do pakietu DT Exchange SDK. Więcej informacji znajdziesz w dokumentacji dotyczącej RODO na Android i iOS.

    Amerykańskie przepisy stanowe o ochronie prywatności

    Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli prawo wycofać zgodę na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu na stronie głównej podmiotu „sprzedającego” musi być umieszczony dobrze widoczny link „Nie sprzedawaj moich danych osobowych”. Przewodnik po zgodności z przepisami stanowymi USA dotyczącymi ochrony 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 Twoim łańcuchu zapośredniczenia. Dlatego musisz zidentyfikować każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie ze wskazówkami każdej z tych sieci, aby zapewnić zgodność z przepisami.

    Wtyczka zapośredniczenia reklam mobilnych Google dla DT Exchange w wersji 3.1.1 zawiera Fyber z metodą SetCCPAString(), która umożliwia ręczne przekazywanie informacji o uzyskanej 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 metodzie, znajdziesz w artykule DT Exchange na temat CCPA Open Source.

    Krok 5. Dodaj wymagany kod

    Android

    Integracja z DT Exchange nie wymaga dodatkowego kodu.

    iOS

    Integracja SKAdNetwork

    Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją DT Exchange.

    Krok 6. Przetestuj implementację

    Włączanie reklam testowych

    Upewnij się, że urządzenie testowe jest zarejestrowane w usłudze Ad Manager.

    Sprawdzanie reklam testowych

    Aby sprawdzić, czy otrzymujesz reklamy testowe z DT Exchange, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródeł reklam DT Exchange (określanie stawek) i DT Exchange (kaskadowe).

    Kody błędów

    Jeśli adapter nie otrzyma reklamy z DT Exchange, wydawcy mogą sprawdzić błąd w odpowiedzi na żądanie reklamy, korzystając z metody ResponseInfo w tej klasie:

    Android

    com.google.ads.mediation.fyber.FyberMediationAdapter

    iOS

    GADMediationAdapterFyber

    Oto kody i powiązane z nimi komunikaty, które adapter DT Exchange wyświetla, gdy nie uda się wczytać reklamy:

    Android

    Kod błędu Przyczyna
    101 Parametry serwera DT Exchange skonfigurowane w interfejsie Ad Managera są nieprawidłowe lub ich brakuje.
    103 Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez DT Exchange.
    105 Pakiet DT SDK wczytał reklamę, ale zwrócił nieoczekiwany kontroler.
    106 Reklama nie jest gotowa do wyświetlenia.
    107 Kontekst nie jest instancją aktywności.
    108 Nie udało się wyświetlić reklamy.
    200-399 Pakiet SDK DT zwrócił błąd. Więcej informacji znajdziesz w kodzie.

    iOS

    Kod błędu Przyczyna
    0-10 Pakiet SDK DT zwrócił błąd. Więcej informacji znajdziesz w dokumentacji.
    101 Parametry serwera DT Exchange skonfigurowane w interfejsie Ad Managera są nieprawidłowe lub ich brakuje.
    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 zwrócił błąd inicjowania.

    Historia zmian wtyczki DT Exchange do zapośredniczenia w Unity

    Wersja 3.6.0 (w toku)

    Wersja 3.5.13

    Wersja 3.5.12

    Wersja 3.5.11

    Wersja 3.5.10

    Wersja 3.5.9

    Wersja 3.5.8

    Wersja 3.5.7

    Wersja 3.5.6

    Wersja 3.5.5

    Wersja 3.5.4

    Wersja 3.5.3

    Wersja 3.5.2

    Wersja 3.5.1

    Wersja 3.5.0

    Wersja 3.4.0

    Wersja 3.3.12

    Wersja 3.3.11

    Wersja 3.3.10

    Wersja 3.3.9

    Wersja 3.3.8

    Wersja 3.3.7

    Wersja 3.3.6

    Wersja 3.3.5

    Wersja 3.3.4

    Wersja 3.3.3

    Wersja 3.3.2

    Wersja 3.3.1

    Wersja 3.3.0

    Wersja 3.2.1

    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