Ta strona została przetłumaczona przez Cloud Translation API.

Integracja DT Exchange z zapośredniczeniem

Ten przewodnik pokazuje, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z DT Exchange przy użyciu mediacji, która obejmuje integrację kaskadową. Przewodnik ten zawiera informacje o dodawaniu pakietu DT Exchange do konfiguracji pośrednictwa w przypadku danej jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera DT Exchange z aplikacją na iOS.

Obsługiwane integracje i formaty reklam

Adapter pośredniczący dla DT Exchange ma te możliwości:

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

Wymagania

docelowa wersja iOS 12.0 lub nowsza,

Najnowsza wersja pakietu SDK do reklam mobilnych Google
Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.

Krok 1. Skonfiguruj konfiguracje w interfejsie DT Exchange

Dodawanie nowej aplikacji i miejsca docelowego reklamy

Zarejestruj się lub zaloguj się 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.

W polu Nazwa miejsca docelowego wpisz nazwę nowego miejsca docelowego, a następnie na liście wybierz odpowiedni Typ miejsca docelowego. Na koniec kliknij Zapisz miejsce docelowe.

Konfiguracja

Identyfikator aplikacji i identyfikator miejsca docelowego

Otwórz pasek nawigacyjny po lewej stronie, najeżdżając na niego kursorem. W menu po lewej stronie kliknij Aplikacje.

Na stronie Zarządzanie aplikacjami zanotuj identyfikator aplikacji obok aplikacji.

Identyfikator aplikacji

Wybierz aplikację, otwórz kartę Miejsca docelowe i kliknij ikonę kopiowania obok Nazwa miejsca docelowego. Zanotuj identyfikator miejsca docelowego.

Identyfikator miejsca docelowego

Identyfikator wydawcy, klucz klienta i hasło klienta

W menu po lewej stronie kliknij swoje imię i nazwisko, a następnie wybierz Profil użytkownika.

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

Krok 2. Skonfiguruj zapotrzebowanie DT Exchange w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij Wyświetlanie > Grupy zysku, a potem kliknij przycisk Nowa grupa zysku.

Wpisz unikalną nazwę grupy zysku, ustaw stan na Aktywna, wybierz format reklamy i ustaw Typ zasobów reklamowych na Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcji Zasoby reklamowe i Aplikacja mobilna, do której chcesz dodać zapośredniczenie.

Następnie kliknij przycisk Dodaj partnera zysku.

Jeśli masz już partnera zysku w DT Exchange, możesz go wybrać. W przeciwnym razie wybierz Utwórz nowego partnera zysku.

Jako sieć reklamowa wybierz DT Exchange, wpisz niepowtarzalną nazwę i włącz zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpisz identyfikator wydawcy, udostępnione hasło i klucz klienta uzyskane w poprzedniej sekcji.

Po wybraniu partnera zysku wybierz Zapośredniczenie mobilne SDK jako Typ integracji, iOS jako Platforma i Aktywny jako Stan. Wpisz identyfikator aplikacji i identyfikator miejsca docelowego uzyskane w poprzedniej sekcji. Następnie wpisz wartość Domyślny CPM.

Gdy skończysz, u dołu strony kliknij Zapisz.

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

Wykonaj czynności opisane w ustawieniach RODO i ustawieniach dotyczących przepisów stanowych w USA, aby dodać DT Exchange (Fyber Monetization) do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA w interfejsie Ad Managera.

Krok 3. Zaimportuj pakiet SDK i adapter DT Exchange

Za pomocą CocoaPods (zalecane)

Dodaj ten wiersz do pliku Podfile projektu:

pod 'GoogleMobileAdsMediationFyber'

W wierszu poleceń uruchom:

pod install --repo-update

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK DT Exchange na iOS i połącz z projektem te platformy:
- IASDKCore.framework
- IASDKMRAID.framework
- IASDKVideo.framework
Pobierz najnowszą wersję adaptera DT Exchange, korzystając z linku do pobrania w Changelog i z linku FyberAdapter.framework w projekcie.
Dodaj do projektu te platformy:
- libxml2.2.tbd

Krok 4. Wprowadź ustawienia prywatności w pakiecie SDK DT Exchange

Zgoda użytkowników z UE i RODO

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz zadbać o to, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali odpowiednie informacje i wyrazili zgodę na wykorzystywanie identyfikatorów urządzeń i danych osobowych. 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). Aby uzyskać zgodę, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub używać danych osobowych, oraz podać informacje o wykorzystywaniu tych danych przez każdą z nich. Obecnie Google nie może automatycznie przekazywać wyboru użytkownika dotyczącego wyrażenia zgody do takich sieci.

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

Swift

import IASDKCore
// ...

IASDKCore.sharedInstance().gdprConsent = IAGDPRConsentType.given
IASDKCore.sharedInstance().gdprConsentString = "myGdprConsentString"

Objective-C

#import <IASDKCore/IASDKCore.h>
// ...

[IASDKCore.sharedInstance setGDPRConsent:YES];
[IASDKCore.sharedInstance setGDPRConsentString:@"myGdprConsentString"];

Więcej informacji oraz wartości, które mogą być podawane w ramach tej metody, znajdziesz na stronie z zasobami dotyczącymi RODO i w przewodniku DT Exchange dotyczącym wdrażania RODO.

Amerykańskie przepisy stanowe o ochronie prywatności

Przepisy stanowe w USA wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” swoich „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 dotyczący zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w przypadku wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia w przypadku każdej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność.

Swift

import IASDKCore
// ...

IASDKCore.sharedInstance().ccpaString = "myCCPAConsentString"

Objective-C

#import <IASDKCore/IASDKCore.h>
// ...

[IASDKCore.sharedInstance setCCPAString:@"myCCPAConsentString"];

Więcej informacji oraz wartości, które mogą być podawane w ramach tej metody, znajdziesz na stronie z zasobami dotyczącymi ustawy CCPA i w przewodniku DT Exchange dotyczącym wdrażania ustawy CCPA.

Krok 5. Dodaj wymagany kod

Integracja z 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 Ad Managerze.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z DT Exchange, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając z kaskadowego źródła reklam DT Exchange.

Kroki opcjonalne:

Parametry związane z siecią

Adapter DT Exchange obsługuje dodatkowe parametry żądania, które można mu przekazać za pomocą parametru 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 włączanie wyciszenia filmu

Oto przykład kodu, który pokazuje, 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 = GAMRequest()
let extras = GADMAdapterFyberExtras()
extras.userData = userData
extras.muteAudio = true
request.register(extras)

Objective-C

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

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

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 podstawowy w odpowiedzi reklamy, używając funkcji GADResponseInfo.adNetworkInfoArray w ramach tej klasy:

GADMediationAdapterFyber

Oto kody i odpowiednie komunikaty z adaptera DT Exchange, które są wyświetlane, gdy nie udaje się załadować reklamy:

Kod błędu	Przyczyna
0-10	Pakiet SDK DT Exchange zwrócił błąd. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją.
101	Parametry serwera DT Exchange skonfigurowane w interfejsie Ad Managera są nieprawidłowe lub ich brakuje.
102	Żądany rozmiar reklamy nie odpowiada obsługiwanemu rozmiarowi banera w 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 Exchange SDK zwrócił błąd inicjowania.