Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Integracja DT Exchange z zapośredniczeniem

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

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads SDK do wczytywania i wyświetlania reklam z DT Exchange za pomocą Zapośredniczenia AdMob. Przewodnik obejmuje integracje kaskadowe. Dowiesz się z niego, jak dodać DT Exchange do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter DT z aplikacją na iOS.

Obsługiwane integracje i formaty reklam

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

Integracja
Określanie stawek
Kaskada
Formaty
Baner
Pełnoekranowa
Z nagrodą
Rodzimy użytkownik

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

iOS w wersji 15.0 lub nowszej.
[W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w określaniu stawek, użyj adaptera DT Exchange w wersji 8.4.2.1 lub nowszej (zalecamy najnowszą wersję).

Najnowsza wersja Google Mobile Ads SDK.
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 DT Exchange Console.

Kliknij Dodaj aplikację.

Zarządzaj Aplikacjami

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

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

Zanotuj Publisher ID (Identyfikator wydawcy), Consumer Key (Klucz klienta) i Consumer Secret (Klucz tajny klienta), ponieważ będą Ci potrzebne w następnym kroku.

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

Musisz dodać DT Exchange do konfiguracji zapośredniczenia jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie DT Exchange jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.

Wpisz format reklamy i platformę, a potem kliknij Dalej.

Nadaj nazwę grupie zapośredniczenia i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z co najmniej jedną z istniejących jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Powinna się teraz wyświetlić karta jednostek reklamowych z wybranymi przez Ciebie jednostkami:

Dodawanie DT Exchange jako źródła reklam

Określanie stawek

W sekcji Źródła reklam znajdź kartę Ustalanie stawek i kliknij Dodaj źródło reklam. Następnie wybierz DT Exchange.

Kliknij Jak podpisać umowę partnerską i skonfiguruj partnerstwo z określaniem stawek z DT Exchange.

Kliknij Potwierdź i zaakceptuj, a następnie Dalej.

Jeśli masz już mapowanie dla DT Exchange, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz identyfikator aplikacji i identyfikator miejsca docelowego uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Kaskada

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklam.

Wybierz DT Exchange i włącz przełącznik Optymalizuj. Aby skonfigurować optymalizację źródła reklam DT Exchange, wpisz identyfikator wydawcy, klucz tajny klienta i klucz klienta uzyskane w poprzedniej sekcji. Następnie wpisz wartość eCPM dla DT Exchange i kliknij Dalej.

Jeśli masz już mapowanie dla DT Exchange, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz identyfikator aplikacji i identyfikator miejsca docelowego uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Uwaga: optymalizacja źródła reklam wymaga kilku dni na zebranie wystarczającej ilości danych, aby dokładnie obliczyć eCPM dla sieci zapośredniczenia. W tym czasie stan optymalizacji źródła reklam to PENDING, więc musisz ręcznie ustawić wartość eCPM dla sieci. Gdy będzie można obliczyć eCPM, źródło reklam automatycznie zacznie aktualizować eCPM w Twoim imieniu.

Dodawanie DT Exchange (Fyber Monetization) 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

Używanie Swift Package Managera

Zanim przejdziesz dalej, musisz mieć minimalną obsługiwaną wersję adaptera 8.3.8.0.

Aby dodać do projektu zależność pakietu, wykonaj te czynności:

W Xcode kliknij File (Plik) > Add Package Dependencies… (Dodaj zależności pakietów…).

W wyświetlonym oknie wyszukaj ten adres URL pakietu:

https://github.com/googleads/googleads-mobile-ios-mediation-dtexchange.git

W sekcji Reguła zależności wybierz Gałąź.
W polu tekstowym wpisz main.

Używanie CocoaPods

Dodaj do pliku Podfile projektu ten wiersz:

pod 'GoogleMobileAdsMediationFyber'

W wierszu poleceń uruchom:

pod install --repo-update

Integracja ręczna

Pobierz najnowszą wersję pakietu DT SDK na iOS i połącz IASDKCore.xcframework.
Pobierz najnowszą wersję adaptera DT Exchange, korzystając z linku do pobrania w liście zmian, i połącz DTExchangeAdapter.xcframework w projekcie.

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

Zgoda użytkowników z UE i RODO

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 na iOS w wersji 8.3.1.0 lub nowszej 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 Zasadami IAB dotyczącymi przejrzystości i uzyskiwania zgody na przetwarzanie danych, do pakietu SDK DT Exchange. Więcej informacji znajdziesz w artykule RODO.

amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). Opcja ta musi być dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej podmiotu „sprzedającego”. Przewodnik po amerykańskich przepisach stanowych 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.

DT Exchange zawiera interfejs API, który umożliwia przekazywanie zgody użytkownika do pakietu SDK. Poniższy przykładowy kod pokazuje, jak ręcznie przekazać informacje o zgodzie do pakietu DT SDK. Jeśli zdecydujesz się ręcznie przekazywać informacje o zgodzie do pakietu SDK DT, zalecamy wywołanie tego kodu przed wysłaniem żądania reklam za pomocą Google Mobile Ads SDK.

Swift

IASDKCore.sharedInstance().ccpaString = usPrivacyStringDTExchangeMediationSwiftSnippets.swift

Zastąp usPrivacyString ciągiem tekstowym dotyczącym prywatności w Stanach Zjednoczonych.

Objective-C

[[IASDKCore sharedInstance] setCCPAString:kUSPrivacyString];DTExchangeMediationObjectiveCSnippets.m

Zastąp kUSPrivacyString ciągiem tekstowym dotyczącym prywatności w Stanach Zjednoczonych.

Więcej informacji oraz wartości, które można podać w metodzie, znajdziesz w przewodniku po implementacji CCPA DT Exchange.

Krok 5. Dodaj wymagany kod

Wdrażanie 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).

Kroki opcjonalne:

Parametry dotyczące sieci

Adapter DT Exchange obsługuje dodatkowe parametry żądania, które można przekazywać do adaptera za pomocą klasy GADMAdapterFyberExtras(). Adapter szuka w pakiecie tych kluczy:

Parametry i wartości żądania
`setUserData` Wiek, płeć i kod pocztowy użytkownika.	`IAUserData`
`setMuteAudio`	Wartość logiczna. Wyciszanie i wyłączanie wyciszenia filmu

Oto przykładowy kod pokazujący, jak ustawić te parametry żądania reklamy:

Swift

let userData = IAUserData.build { builder in
  builder.age = 23
  builder.gender = IAUserGenderType.male
  builder.zipCode = "1234"
}

let request = Request()
let extras = GADMAdapterFyberExtras()
extras.userData = userData
extras.muteAudio = true
request.register(extras)DTExchangeMediationSwiftSnippets.swift

Objective-C

IAUserData *userData = [IAUserData build:^(id<IAUserDataBuilder> _Nonnull builder) {
  builder.age = 23;
  builder.gender = IAUserGenderTypeMale;
  builder.zipCode = @"1234";
}];

GADRequest *request = [GADRequest request];
GADMAdapterFyberExtras *extras = [[GADMAdapterFyberExtras alloc] init];
extras.userData = userData;
extras.muteAudio = YES;
[request registerAdNetworkExtras:extras];DTExchangeMediationObjectiveCSnippets.m

Więcej informacji znajdziesz w przewodniku po integracji z DT Exchange.

Kody błędów

Jeśli adapter nie otrzyma reklamy z DT Exchange, możesz sprawdzić błąd w odpowiedzi na reklamę, używając metody GADResponseInfo.adNetworkInfoArray w tej klasie:

GADMediationAdapterFyber

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

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 DT SDK zwrócił błąd inicjowania.