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

Integracja Unity Ads z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Unity Ads za pomocą zapośredniczenia orazintegracji kaskadowej. Dowiesz się z niego, jak dodać reklamy Unity do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować z iOS aplikacją pakiet SDK i adapter Unity Ads.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia do Unity Ads ma następujące możliwości:

Integracja
Ustalanie stawek	¹
Wodospad
Formaty
Baner
Pełnoekranowa
Otrzymano
Natywna

Wymagania

Cel wdrożenia iOS w wersji 12.0 lub nowszej

Najnowszy pakiet SDK do reklam mobilnych Google
Wykonaj zapośredniczenie Przewodnik dla początkujących

Krok 1. Skonfiguruj konfiguracje w interfejsie Unity Ads

Zarejestruj się lub zaloguj w Unity Ads.

Tworzenie projektu

W panelu reklam Unity otwórz Projects (Projekty) i kliknij Create Project (Utwórz projekt).

Wypełnij formularz i kliknij Create Project (Utwórz projekt), aby dodać projekt.

Otwórz Zarabianie > Rozpocznij, a potem kliknij Rozpocznij.

W oknie Konfiguracja projektu wybierz Chcę korzystać z zapośredniczenia i Google AdMob w polu Partner zapośredniczenia, a potem kliknij Dalej.

Wybierz ustawienia reklam i kliknij Dalej.

Wypełnij formularz i kliknij Add Project (Dodaj projekt).

Zanotuj identyfikator gry.

Utwórz jednostkę reklamową

Otwórz Zarabianie > Jednostki reklamowe, a następnie kliknij Dodaj jednostkę reklamową.

Wpisz nazwę jednostki reklamowej, a potem wybierz opcje Platforma i Format reklamy.

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

Dodaj miejsce docelowe

Po utworzeniu projektu kliknij Generowanie przychodu > Miejsca docelowe. Aby utworzyć nowe miejsce docelowe, kliknij Dodaj miejsce docelowe obok jednostki reklamowej.

Podaj niezbędne informacje i kliknij Dodaj miejsce docelowe.

Zanotuj identyfikator miejsca docelowego.

Znajdź klucz interfejsu Unity Ads Reporting API

Ustalanie stawek

Nie musisz tego robić w przypadku integracji z określaniem stawek.

Wodospad

Oprócz identyfikatora gry i identyfikatora miejsca docelowego do skonfigurowaniaAd Manager identyfikatora jednostki reklamowej będą też potrzebne klucz interfejsu API Unity Ads i główny identyfikator organizacji.

Kliknij Zarabianie > Konfiguracja > Zarządzanie interfejsem API i zanotuj klucz dostępu do interfejsu Monetization Stats API.

Następnie otwórz Zarabianie > Ustawienia organizacji i zanotuj podstawowy identyfikator organizacji.

Włącz tryb testowy

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

Aby wymusić tryb testowy w swojej aplikacji, kliknij przycisk edycji obok: Apple App Store , zaznacz Zastąp tryb testowy klienta i wybierz Wymuś włączenie trybu testowego (czyli używaj reklam testowych) na wszystkich urządzeniach.

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

Wypełnij formularz i kliknij Zapisz.

Krok 2. Skonfiguruj żądania reklam Unity Ads w Ad Manager interfejsie

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku.

Wpisz niepowtarzalną nazwę grupy zysku, ustaw Stan na Aktywna, wybierz Format reklamy, a jako Typ zasobów reklamowych wybierz Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcjach 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 przypadku usługiUnity Ads, możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.

Jako Sieć reklamowa wybierz Unity Ads, wpisz niepowtarzalną nazwę i włącz Zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpiszAPI Key and Organization core ID uzyskane w poprzedniej sekcji.

Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako typ integracji, iOS jako platformę i Aktywne jako stan. WpiszGame ID and Placement ID uzyskane w poprzedniej sekcji. Następnie wpisz domyślną wartość CPM.

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

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

Wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia amerykańskich przepisów stanowych , aby dodać Unity Ads do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w Ad Manager UI.

Krok 3. Zaimportuj pakiet SDK Unity Ads i adapter

Używanie CocoaPods (zalecane)

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

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK Unity Ads i połącz plik UnityAds.framework w projekcie.
Pobierz najnowszą wersję adaptera Unity Ads za pomocą linku do pobierania w dzienniku zmian i dodaj link UnityAdapter.framework w swoim projekcie.

Krok 4. Wdróż ustawienia prywatności w pakiecie SDK do wyświetlania reklam Unity

Zgoda użytkowników z UE i RODO

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali określone informacje na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz aby uzyskać od nich zgodę. 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). Podczas uzyskiwania zgody musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe, a także podać informacje o sposobie ich wykorzystania. Obecnie Google nie może automatycznie przekazać tym sieciom wyboru użytkownika dotyczącego zgody.

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

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 przypadku poszczególnych metod, znajdziesz w przewodnikach poświęconych interfejsom API do uzyskiwania zgody na przetwarzanie danych i danych o prywatności. Zgodność z RODO

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają umożliwienia użytkownikom wycofania zgody na sprzedaż danych osobowych (w znaczeniu określonym w ustawie), za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej sprzedawcy. Przewodnik dotyczący 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. Musisz więc wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i zastosować się do zaleceń każdej z nich, by zapewnić zgodność z zasadami.

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 informacje o wartościach, które można podać w przypadku poszczególnych metod, znajdziesz w przewodnikach dotyczących interfejsów API dotyczących zgody na przetwarzanie danych i danych o prywatności i Zgodność z ustawą CCPA

Krok 5. Dodaj wymagany kod

Integracja SKAdNetwork

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

Błędy kompilacji

Swift

Do integracji Swift nie jest wymagany żaden dodatkowy kod.

Objective-C

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

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby Ad Manager i włącz tryb testowy w Unity Ads interfejsie użytkownika.

Weryfikacja reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyUnity Ads, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z Unity Ads (Waterfall) źródeł reklam.

Kody błędów

Jeśli adapter nie otrzyma reklamy z Unity Ads, wydawcy mogą sprawdzić błąd w odpowiedzi za pomocą polecenia GADResponseInfo.adNetworkInfoArray w tych klasach:

GADMAdapterUnity
GADMediationAdapterUnity

Oto kody i powiązane z nimi komunikaty wysyłane przez adapter UnityAds, gdy reklama się nie wczytuje:

Kod błędu	Przyczyna
0-10	Pakiet UnityAds SDK zwrócił komunikat o błędzie. Więcej informacji znajdziesz w opisie kodu.
101	Brak parametrów serwera UnityAds skonfigurowanych w Ad Manager interfejsie lub są one nieprawidłowe.
102	UnityAds zwróciło miejsce docelowe ze stanem NO_FILL.
103	UnityAds zwróciło miejsce docelowe ze stanem DISABLED.
104	UnityAds próbowała wyświetlić reklamę bez kontekstu.
105	Kontekst używany do inicjowania, wczytywania lub wyświetlania reklam z Unity Ads nie jest instancją aktywności.
106	Firma UnityAds próbowała wyświetlić reklamę, która nie jest gotowa do wyświetlenia.
107	Urządzenie nie obsługuje UnityAds.
108	UnityAds może wczytywać tylko 1 reklamę na miejsce docelowe naraz.
109	Reklamy UnityAds zakończyły działanie ze stanem ERROR (błąd).
200-204	Błąd związany z banerem UnityAds. Więcej informacji znajdziesz w opisie kodu.
0-9	Pakiet UnityAds SDK zwrócił komunikat o błędzie. Więcej informacji znajdziesz w dokumentacji Unity.
101	Brak parametrów serwera UnityAds skonfigurowanych w Ad Manager interfejsie lub są one nieprawidłowe.
102	Urządzenie nieobsługiwane przez UnityAds.
103	Reklamy UnityAds zakończyły prezentację ze stanem błędu kUnityAdsFinishStateError.
104	Po wywołaniu inicjatora obiekt reklamy Unity jest pusty.
105	Nie udało się wyświetlić reklam Unity, ponieważ reklama nie jest gotowa.
106	Nazwa miejsca docelowego UnityAds nazywa się wywołaniem zwrotnym ze stanem miejsca docelowego kUnityAdsplacementStateNoFill.
107	Parametr UnityAds nazywa się wywołaniem zwrotnym miejsca docelowego ze stanem miejsca docelowego kUnityAdsplacementStateDisabled.
108	Reklama na potrzeby tego miejsca docelowego została już wczytana. Pakiet UnityAds SDK nie obsługuje wczytywania wielu reklam w przypadku tego samego miejsca docelowego.