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

Integracja Unity Ads z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Unity Ads przy użyciu mediacji, która obejmuje integrację kaskadową. Znajdziesz w nim informacje o tym, jak dodać Unity Ads do konfiguracji pośrednictwa jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Unity Ads z aplikacją na iOS.

Obsługiwane integracje i formaty reklam

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

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

¹ Integracja ustalania stawek jest w zamkniętej fazie testów beta. Aby uzyskać dostęp, skontaktuj się z menedżerem konta.

Wymagania

docelowa wersja iOS 12.0 lub nowsza
[W przypadku ustalania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam z ustalaniem stawek, użyj adaptera Unity w wersji 4.11.3.1 lub nowszej (zalecana najnowsza wersja).

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

Krok 1. Skonfiguruj ustawienia w interfejsie Unity Ads

Zarejestruj się lub zaloguj w Unity Ads.

Utwórz projekt

W panelu Unity Ads kliknij Projekty, a potem Utwórz projekt.

Wypełnij formularz i kliknij Utwórz projekt, aby dodać projekt.

Kliknij Zarabianie > Rozpocznij, a następnie Rozpocznij.

W oknie Konfiguracja projektu kliknij Zamierzam korzystać z pośrednictwa i Google AdMob w sekcji Partner do pośrednictwa, a potem kliknij Dalej.

Wybierz ustawienia reklamy i kliknij Dalej.

Wypełnij formularz i kliknij Dodaj projekt.

Zanotuj identyfikator gry.

Tworzenie jednostki reklamowej

Kliknij kolejno Generowanie przychodu > Jednostki reklamowe i Dodaj jednostkę reklamową.

Wpisz Nazwa jednostki reklamowej, a następnie wybierz Platformę i Format reklamy.

Na koniec kliknij Utwórz, aby zapisać jednostkę reklamową.

Dodawanie miejsca docelowego

Po utworzeniu projektu kliknij Zarabianie > Miejsca docelowe. Aby utworzyć nowe miejsce docelowe, kliknij Dodaj miejsce docelowe dla swojej jednostki reklamowej.

Podaj niezbędne informacje i kliknij Dodaj miejsce.

Zanotuj identyfikator miejsca docelowego.

Znajdowanie klucza interfejsu API do raportowania Unity Ads

Określanie stawek

Ten krok nie jest wymagany w przypadku integracji określania stawek.

Wodospad

Oprócz identyfikatora gry i identyfikatora miejsca docelowego do skonfigurowania identyfikatora jednostki reklamowej w usłudze Ad Manager potrzebny będzie też klucz API i główny identyfikator organizacji Unity Ads.

Kliknij Zarabianie > Konfiguracja > Zarządzanie interfejsem API i zapisz klucz dostępu do interfejsu API Statystyki zarabiania.

Następnie otwórz Zarabianie > Ustawienia organizacji i zapisz identyfikator główny organizacji.

Włączanie trybu testowego

Tryb testowy można włączyć w panelu Unity Ads. W ustawieniach projektu kliknij kartę Testowanie.

Tryb testowy możesz włączyć, klikając przycisk edycji obok Apple App Store, zaznaczając Zastąp tryb testowy klienta i wybierając Włącz tryb testowy (np. używaj reklam testowych) na wszystkich urządzeniach.

Możesz też włączyć tryb testowy na określonych urządzeniach, klikając przycisk Dodaj urządzenie testowe.

Wypełnij formularz i kliknij Zapisz.

Krok 2. Skonfiguruj zapotrzebowanie Unity Ads 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 Targetowanie > Zasoby 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 Unity Ads, możesz go wybrać. W przeciwnym razie wybierz Utwórz nowego partnera zysku.

Jako sieci reklamowej wybierz Unity Ads, wpisz niepowtarzalną nazwę i włącz zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpisz klucz API oraz identyfikator organizacji 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 gry 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 Unity Ads do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA

Aby dodać Unity Ads do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w interfejsie Ad Managera, wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia dotyczące amerykańskich przepisów stanowych.

Krok 3. Zaimportuj pakiet SDK i adapter Unity Ads

Za pomocą CocoaPods (zalecane)

Dodaj ten wiersz do pliku Podfile projektu:
```
pod 'GoogleMobileAdsMediationUnity'
```
W wierszu poleceń uruchom:
```
pod install --repo-update
```

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK do reklam Unity Ads i połącz w projekcie UnityAds.framework.
Pobierz najnowszą wersję adaptera Unity Ads, korzystając z linku do pobrania w Changelog, i połącz UnityAdapter.framework z projektem.

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

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. Obecnie Google nie może automatycznie przekazywać wyboru użytkownika dotyczącego wyrażenia zgody do takich sieci.

W pakiecie SDK w wersji 2.0.0 Unity Ads dodano interfejs API obsługujący ustawienia prywatności. Poniższy przykładowy kod pokazuje, jak przekazywać te informacje o zgodzie do pakietu SDK Unity Ads. Jeśli zdecydujesz się ręcznie przekazywać pakietowi SDK Unity Ads informacje o zgodzie, zalecamy wywołanie tego kodu przed wysłaniem żądania reklamy za pomocą pakietu SDK do reklam mobilnych Google.

Swift

import UnityAds
// ...

let gdprMetaData = UADSMetaData()
gdprMetaData.set("gdpr.consent", value: true)
gdprMetaData.commit()

Objective-C

#import <UnityAds/UnityAds.h>
// ...

UADSMetaData *gdprMetaData = [[UADSMetaData alloc] init];
[gdprMetaData set:@"gdpr.consent" value:@YES];
[gdprMetaData commit];

Więcej informacji oraz wartości, które można podać w ramach poszczególnych metod, znajdziesz w interfejsach API dotyczącej zgody na wykorzystanie danych i prywatności i w przewodniku po zgodności z RODO Unity Ads.

Amerykańskie przepisy stanowe o ochronie prywatności

Przepisy stanowe w USA dotyczące prywatności 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 UnityAds
// ...

let ccpaMetaData = UADSMetaData()
ccpaMetaData.set("privacy.consent", value: true)
ccpaMetaData.commit()

Objective-C

#import <UnityAds/UnityAds.h>
// ...

UADSMetaData *ccpaMetaData = [[UADSMetaData alloc] init];
[ccpaMetaData set:@"privacy.consent" value:@YES];
[ccpaMetaData commit];

Więcej informacji oraz wartości, które można podać w ramach poszczególnych metod, znajdziesz w interfejsach API do uzyskiwania zgody na przetwarzanie danych i interfejsach API do pobierania danych i wytycznych dotyczących zgodności z wymaganiami ustawy CCPA firmy Unity Ads.

Krok 5. Dodaj wymagany kod

Integracja z SKAdNetwork

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

Błędy kompilacji

Swift

Integracja z Swift nie wymaga dodatkowego kodu.

Objective-C

W przypadku adaptera Unity Ads w wersji 4.4.0.0 lub nowszej musisz wykonać czynności integracyjne opisane w dokumentacji Unity.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrujesz urządzenie testowe w Ad Managerze i włączysz tryb testowy w interfejsie Unity Ads.

Weryfikowanie reklam testowych

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

Kody błędów

Jeśli adapter nie otrzyma reklamy z Unity Ads, wydawcy mogą sprawdzić błąd w odpowiedzi reklamy, korzystając z interfejsu GADResponseInfo.adNetworkInfoArray w ramach tych klas:

GADMAdapterUnity
GADMediationAdapterUnity

Oto kody i odpowiednie komunikaty zgłaszane przez adapter UnityAds, gdy nie udaje się załadować reklamy:

Kod błędu	Przyczyna
0-9	Pakiet SDK UnityAds zwrócił błąd. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją Unity.
101	Parametry serwera UnityAds skonfigurowane w interfejsie Ad Managera są nieprawidłowe lub ich brakuje.
102	Urządzenie nie jest obsługiwane przez UnityAds.
103	UnityAds zakończyło wyświetlanie z błędem o stanie kUnityAdsFinishStateError.
104	Po wywołaniu inicjalizatora obiekt reklamy w Unity jest pusty.
105	Nie udało się wyświetlić reklamy Unity Ads, ponieważ reklama nie jest gotowa.
106	UnityAds wywołało wywołanie zwrotne zmiany miejsca docelowego z wartością stanu kUnityAdsPlacementStateNoFill.
107	UnityAds wywołało wywołanie zwrotne zmiany miejsca docelowego z wartością kUnityAdsPlacementStateDisabled.
108	reklama została już załadowana w tym miejscu docelowym; Pakiet SDK UnityAds nie obsługuje wczytywania wielu reklam w przypadku tego samego miejsca docelowego.