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 obejmującego 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ą Flutter .

Obsługiwane integracje i formaty reklam

AdMob Adapter pośredniczący Unity Ads ma następujące możliwości:

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

¹ Integracja ustalania stawek jest w ramach zamkniętej bety. Aby uzyskać dostęp, skontaktuj się z menedżerem konta.

Wymagania

• Najnowsza wersja pakietu SDK do reklam mobilnych Google
• Flutter 3.7.0 lub nowszy
• Aby wdrożyć na Androidzie:
  • Poziom interfejsu API 21 lub nowszy
• Aby wdrożyć aplikację na iOS:
  • docelowa wersja iOS 12.0 lub nowsza
• działający Flutter projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w pierwszych krokach.
• 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 Add Project (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.

Android

iOS

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

Dodaj miejsce docelowe

Określanie stawek

Aby utworzyć miejsca docelowe z ustalaniem stawek, skontaktuj się ze swoim menedżerem konta Google.

Wodospad

Po utworzeniu projektu kliknij Generowanie przychodu > 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.

Android

iOS

Znajdź klucz interfejsu Unity Ads Reporting API

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 AdMob 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 aplikacji możesz włączyć, klikając przycisk edycji na każdej platformie, zaznaczając Zastąp tryb testowy klienta i klikając Włącz tryb testowy (czyli użyj reklam testowych) na wszystkich urządzeniach.

Android

iOS

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 na reklamy Unity Ads w  AdMob UI

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 instrukcji na Androida.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika po iOS.

Dodawanie partnerów reklamowych do listy zgodnej z RODO i przepisami stanowymi w USA

Ważne: musisz mieć uprawnienia do zarządzania kontem, aby dokończyć konfigurację dotyczącą zgody z UE, RODO, ustawy CPRA i platformy do przesyłania wiadomości dla użytkowników. Więcej informacji znajdziesz w artykule Zarządzanie dostępem użytkowników do konta.

Aby dodać Unity Ads do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w interfejsie AdMob, wykonaj czynności opisane w ustawieniach RODO i ustawieniach dotyczących przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter Unity Ads

Uwaga: brak integracji zgodnych wersji pakietów SDK Unity Ads i Google Mobile Ads może spowodować problemy z kompilacją.

Integracja przez pub.dev

Dodaj tę zależność z najnowszymi wersjami funkcji Unity Ads Pakiet SDK i adapter w pakiecie Plik pubspec.yaml:

dependencies:
  gma_mediation_unity: ^1.0.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki do zapośredniczenia reklam mobilnych Google dla Unity Ads, wyodrębnij pobrany plik i dodaj wyodrębniony folder wtyczki (oraz jego zawartość) do projektu Flutter. Następnie sprawdź informacje o wtyczce w pubspec.yaml przez dodanie tej zależności:

dependencies:
  gma_mediation_unity:
    path: path/to/local/package

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

Wtyczka do mediowania reklam mobilnych Google dla Unity Adsobsługuje metodę GmaMediationUnity.setGDPRConsent() . Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu Unity Ads SDK. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setGDPRConsent(true);

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

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. 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ść.

Wtyczka do mediowania reklam mobilnych Google dla Unity Adsobsługuje metodę GmaMediationUnity.setCCPAConsent() . Ten przykładowy kod pokazuje, jak przekazywać informacje o zgodzie użytkowników do pakietu SDK Unity Ads. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

Krok 5. Dodaj wymagany kod

Android

Integracja Unity Ads na Androida nie wymaga dodatkowego kodu.

iOS

Integracja z SKAdNetwork

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

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob i włączyć tryb testowy w interfejsie Unity Ads.

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy w AdMob i 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 (kaskadowych).

Kody błędów

Jeśli adapter nie otrzyma reklamy z Unity Ads, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi za pomocą polecenia ResponseInfo z tych klas:

Android

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

iOS

GADMAdapterUnity
GADMediationAdapterUnity

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

Android

Kod błędu	Przyczyna
0-10	Pakiet SDK UnityAds zwrócił błąd. Więcej informacji znajdziesz w kodowaniu.
101	Parametry serwera UnityAds skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje.
102	UnityAds zwrócił miejsce docelowe ze stanem NO_FILL.
103	UnityAds zwróciła miejsce docelowe z wartością DISABLED (WYŁĄCZONE).
104	UnityAds próbował wyświetlić reklamę z kontekstem o wartości null.
105	Kontekst używany do inicjowania, wczytywania lub wyświetlania reklam z Unity Ads nie jest wystąpieniem aktywności.
106	Firma UnityAds próbowała wyświetlić reklamę, która nie jest gotowa do wyświetlenia.
107	Na urządzeniu nie można korzystać z UnityAds.
108	UnityAds może wczytywać tylko 1 reklamę na miejsce docelowe naraz.
109	UnityAds zakończyło działanie w stanie BŁĄD.
200-204	UnityAds Banner a specific error. Więcej informacji znajdziesz w kodowaniu.

iOS

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 AdMob 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 inicjatora obiekt reklamy 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.

Historia zmian adaptera zapośredniczenia Flutter w reklamach Unity

Wersja 1.1.0

• Zweryfikowano zgodność z adapterem Unity na Androida w wersji 4.12.3.0
• Weryfikowana zgodność z adapterem Unity iOS w wersji 4.12.3.1
• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.2.0.

Wersja 1.0.0

• Pierwsza wersja.
• Weryfikowana zgodność z adapterem Unity Android w wersji 4.10.0.0
• Weryfikowana zgodność z adapterem Unity iOS w wersji 4.10.0.0
• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.0.0.