Integracja DT Exchange z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu 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
Kaskada
Formaty
Otwarcie aplikacji
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Rodzimy użytkownik

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

  • Najnowsza wersja Google Mobile Ads Flutter Plugin.
  • Flutter w wersji 3.7.0 lub nowszej.
  • To deploy on Android
    • Android API na poziomie 24 lub wyższym.
  • Wdrażanie na iOS
    • Docelowa wersja iOS: 15.0 lub nowsza.
  • Działający projekt Flutter skonfigurowany za pomocą Google Mobile Ads Flutter Plugin. Szczegółowe informacje znajdziesz w artykule Konfigurowanie Google Mobile Ads Flutter Plugin.
  • Skonfiguruj zapośredniczenie AdMob.

    • Krok 1. Skonfiguruj ustawienia w interfejsie DT Exchange

    Dodawanie nowej aplikacji i miejsca docelowego reklamy

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

    Kliknij Add App (Dodaj aplikację).

    Zarządzaj Aplikacjami

    Wybierz platformę i miejsca docelowe, wypełnij pozostałą część formularza, a następnie kliknij 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 App Management (Zarządzanie aplikacjami) zapisz App ID (Identyfikator aplikacji) widoczny 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 Profil użytkownika.

    Zanotuj Publisher ID (Identyfikator wydawcy), Consumer Key (Klucz klienta) i Consumer Secret (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 znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze nie masz pliku app-ads.txt, skonfiguruj go pod kątem swojej aplikacji.

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

    Krok 2. Skonfiguruj żądania DT Exchange w interfejsie AdMob

    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 iOS.

    Dodawanie DT Exchange do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA

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

    Krok 3. Zaimportuj pakiet SDK i adapter DT Exchange

    Integracja przez pub.dev

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

    dependencies:
  gma_mediation_dtexchange: ^1.4.0

    Integracja ręczna

    Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla DT Exchange, rozpakuj pobrany plik i dodaj wyodrębniony folder wtyczki (wraz z zawartością) do projektu Flutter. Następnie dodaj odwołanie do wtyczki w pliku pubspec.yaml, dodając 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 przekazać określone informacje użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na wykorzystywanie plików cookie lub innych lokalnych metod przechowywania danych, jeśli jest to wymagane przez prawo, a także 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). Odpowiadasz za sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu zapośredniczenia.

    Adapter DT Exchange Flutter w wersji 1.1.0 i nowszych obsługuje przekazywanie do pakietu SDK DT Exchange sygnałów zgody na wykorzystanie danych zgodnie z RODO z platform do zarządzania zgodą użytkowników, które są zintegrowane z Zasadami IAB dotyczącymi przejrzystości i uzyskiwania zgody na przetwarzanie danych. 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 do rezygnacji ze „sprzedaży” ich „danych osobowych” (w znaczeniu określonym w ustawie). Opcja ta musi być dostępna za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej podmiotu „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 ze wskazówkami każdej z tych sieci, aby zapewnić zgodność z przepisami.

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

    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

    Pamiętaj, aby zarejestrować urządzenie testowe w AdMob.

    Sprawdzanie reklam testowych

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

    Kody błędów

    Jeśli adapter nie otrzyma reklamy z DT Exchange, wydawcy mogą sprawdzić błąd w odpowiedzi na reklamę, 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 AdMob 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 AdMob 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 adaptera zapośredniczenia DT Exchange Flutter

    Wersja 1.4.1 (w toku)

    Wersja 1.4.0

    Wersja 1.3.7

    Wersja 1.3.6

    Wersja 1.3.5

    Wersja 1.3.4

    • Zaktualizowano minimalną wersję Fluttera do 3.38.1.
    • Zaktualizowano, aby obsługiwać wtyczkę 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