Integracja DT Exchange z zapośredniczeniem

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

Z tego przewodnika dowiesz się, jak używać Google Mobile Ads Flutter Plugin do wczytywania i wyświetlania reklam z DT Exchange za pomocą zapośredniczenia, w tym integracji kaskadowych. Dowiesz się, jak dodać DT Exchange do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter DT Exchange z aplikacją Flutter.

Obsługiwane integracje i formaty reklam

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

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

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

  • Najnowsza wersja Google Mobile Ads Flutter Plugin.
  • Platforma Flutter w wersji 3.7.0 lub nowszej.
  • Aby wdrożyć na Androidzie:
    • Android w wersji 23 lub nowszej.
  • Aby wdrożyć na iOS:
    • iOS w wersji 13.0 lub nowszej.
  • Działający projekt Flutter skonfigurowany za pomocą Google Mobile Ads Flutter Plugin. Więcej informacji znajdziesz w artykule Konfigurowanie Google Mobile Ads Flutter Plugin.
  • Skonfiguruj zapośredniczenie.

Krok 1. Skonfiguruj ustawienia w interfejsie DT Exchange

Dodaj nową aplikację i miejsce docelowe reklamy

Zarejestruj się lub zaloguj w konsoli DT Exchange.

Kliknij Dodaj aplikację.

Zarządzaj Aplikacjami

Wybierz platformę i miejsca docelowe, wypełnij resztę formularza, a następnie kliknij Utwórz aplikację.

Android

iOS

Wpisz nazwy i wybierz typy miejsc docelowych. 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 zanotuj identyfikator aplikacji obok swojej aplikacji.

Wybierz aplikację i otwórz 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 Profil użytkownika.

Zanotuj identyfikator wydawcy, klucz klienta i klucz tajny klienta, ponieważ będą Ci potrzebne w następnym kroku.

Profil użytkownika

Zaktualizuj plik app-ads.txt

Authorized Sellers for Apps (czyli plik 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 utracie przychodów z reklam, użyj pliku app-ads.txt. Jeśli jeszcze tego nie zrobisz, utwórz plik app-ads.txt dla Ad Managera.

Aby zaimplementować app-ads.txt w DT Exchange, dodaj DT do pliku app-ads.txt.

Krok 2. Skonfiguruj popyt DT Exchange w interfejsie Ad Managera

Skonfiguruj ustawienia zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 przewodnika dla Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.

Dodaj DT Exchange do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi

Aby dodać DT Exchange (Fyber Monetization) do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w interfejsie Ad Managera, wykonaj czynności opisane w sekcjach Ustawienia wymagane przez rozporządzenia europejskie i Ustawienia wymagane przez przepisy stanowe w USA.

Krok 3. Zaimportuj pakiet SDK i adapter DT Exchange

Integracja przez pub.dev

Dodaj tę zależność z najnowszymi wersjami pakietu SDK i adaptera DT Exchange w pliku pubspec.yaml pakietu:

dependencies:
  gma_mediation_dtexchange: ^1.3.5

Integracja ręczna

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla DT Exchange, rozpakuj pobrany plik i dodaj rozpakowany folder wtyczki (wraz z jego zawartością) do projektu Flutter. Następnie dodaj do pliku pubspec.yaml tę zależność:

dependencies:
  gma_mediation_dtexchange:
    path: path/to/local/package

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

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz udzielać odpowiednich informacji użytkownikom z Europejskiego Obszaru Gospodarczego, Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na korzystanie z plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane prawnie. Musisz też uzyskać zgodę użytkowników na gromadzenie, udostępnianie i wykorzystywanie danych osobowych do personalizacji 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). Twoim obowiązkiem jest sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu zapośredniczenia. Google nie może automatycznie przekazywać wyboru zgody użytkownika do takich sieci.

Wtyczka zapośredniczenia reklam mobilnych Google dla DT Exchange nie obsługuje przekazywania informacji o zgodzie do pakietu SDK DT Exchange.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli prawo do wycofania zgody na „sprzedaż” swoich „danych osobowych” (zgodnie z definicjami tych terminów w przepisach). Wycofanie zgody musi być możliwe za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej „sprzedającego”. Przewodnik po 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. 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 z wytycznymi każdej z tych sieci, aby zapewnić zgodność.

Wtyczka zapośredniczenia reklam mobilnych Google dla DT Exchange nie obsługuje przekazywania informacji o zgodzie do pakietu SDK DT Exchange.

Krok 5. Dodaj wymagany kod

Android

W przypadku integracji z DT Exchange nie jest wymagany żaden dodatkowy kod.

iOS

Integracja SKAdNetwork

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

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe w Ad Managerze.

Sprawdź reklamy testowe

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

Kody błędów

Jeśli adapter nie otrzyma reklamy z DT Exchange, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na reklamę za pomocą ResponseInfo w tej klasie:

Android

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

Oto kody i towarzyszące im komunikaty zwracane przez adapter DT Exchange, 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 SDK DT 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 inicjalizacji.

Dziennik zmian adaptera zapośredniczenia Flutter dla DT Exchange

Wersja 1.3.5

Wersja 1.3.4

  • Zaktualizowano minimalną wersję Fluttera do 3.38.1.
  • Zaktualizowano obsługę wtyczki reklam mobilnych Google do Fluttera w wersji 8.0.0.

Wersja 1.3.3

Wersja 1.3.2

Wersja 1.3.1

Wersja 1.2.0

Wersja 1.1.5

Wersja 1.1.4

Wersja 1.1.3

Wersja 1.1.2

Wersja 1.1.1

Wersja 1.1.0

Wersja 1.0.0