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

Obsługiwane integracje i formaty reklam

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

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

1 Integracja określania stawek jest w wersji beta dostępnej publicznie.

Wymagania

  • Najnowsza wersja pakietu SDK do reklam mobilnych Google
  • Flutter w wersji 3.7.0 lub nowszej
  • [Do określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w określaniu stawek, użyj wtyczki Google Mobile Ads do zapośredniczenia reklam Unity Ads w wersji 3.11.1 lub nowszej (zalecana najnowsza wersja).
  • 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 projekt Flutter skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w sekcji Pierwsze kroki.
  • Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.

Krok 1. Skonfiguruj ustawienia w interfejsie Unity Ads

Zarejestruj lub zaloguj się w Unity Ads.

Utwórz projekt

W panelu Unity Ads otwórz Projekty i kliknij Nowy.

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

Kliknij kolejno Zarabianie na reklamach w Unity Ads i Rozpocznij.

W oknie Nowy projekt kliknij Użyję pośrednictwa i Google AdMob w sekcji Partner pośrednictwa, a potem kliknij Dalej.

Wybierz opcję ustawień reklam i kliknij Dalej.

Wybierz ustawienia miejsca docelowego i kliknij Dalej.

Określanie stawek

Wodospad

Wypełnij formularz i kliknij Dodaj projekt.

Zanotuj identyfikator gry.

Tworzenie jednostek reklamowych i miejsc docelowych

Kliknij Zarabianie na reklamach Unity Ads > Miejsca docelowe, wybierz swój projekt i kliknij Dodaj jednostkę reklamową.

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

Android

iOS

Określanie stawek

W sekcji Konfiguracja wybierz Określanie stawek. W sekcji Miejsce docelowe wpisz nazwę miejsca docelowego.

Zanotuj identyfikator miejsca docelowego.

Wodospad

W sekcji Konfiguracja wybierz Kaskada. W sekcji Placement (Miejsce docelowe) wpisz Name of placement (Nazwa miejsca docelowego), GEO Tagging (Tagowanie geograficzne) i Target (Cele).

Zanotuj identyfikator miejsca docelowego.

Na koniec kliknij Dodaj jednostkę reklamową, aby zapisać jednostkę reklamową i miejsce docelowe.

Znajdowanie klucza interfejsu API do raportowania Unity Ads

Określanie stawek

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

Wodospad

Kliknij Generowanie przychodów z reklam Unity Ads > Zarządzanie interfejsem API i zapisz klucz interfejsu API w sekcji Dostęp do interfejsu Monetization Stats API.

Następnie otwórz Generowanie przychodu z Unity Ads > Ustawienia organizacji i zapisz główny identyfikator organizacji.

Włączanie trybu testowego

Tryb testowy można włączyć w panelu Unity Ads. Kliknij Generowanie przychodu z Unity Ads > Testowanie.

Tryb testowy możesz włączyć w przypadku każdej platformy, klikając przycisk edycji, włączając opcję Zastąp tryb testowy klienta i wybierając Włącz tryb testowy (czyli używaj reklam testowych) na wszystkich urządzeniach.

Android

iOS

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

Wpisz szczegóły urządzenia testowego i kliknij Zapisz.

Krok 2. Skonfiguruj popyt Unity Ads w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.

Dodawanie Unity Ads do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA

Wykonaj czynności opisane w ustawieniach dotyczących europejskich przepisów i amerykańskich przepisów stanowych, aby dodać Unity Ads do listy partnerów reklamowych w Europejskich i Amerykańskich Przepisach Stanowych w interfejsie AdMob.

Krok 3. Zaimportuj pakiet SDK i adapter Unity Ads

Integracja przez pub.dev

Dodaj w pliku pubspec.yaml pakietu następującą zależność z najnowszymi wersjami pakietu SDK i adaptera Unity Ads:

dependencies:
  gma_mediation_unity: ^1.2.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki mediacji reklam mobilnych Google do Unity Ads, wyodrębnij pobrany plik i dodaj wyodrębniony folder wtyczki (oraz jego zawartość) do projektu Flutter. Następnie odwołuj się do wtyczki w pliku pubspec.yaml, dodając tę zależność:

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

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

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 zapośredniczenia reklam mobilnych Google dla Unity Ads wykorzystuje 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 interfejsach API dotyczącej zgody na wykorzystanie danych i interfejsów API danych i wytycznych dotyczących zgodności z RODO Unity Ads.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności nakładają na Ciebie obowiązek zapewnienia użytkownikom możliwości wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu musisz umieścić na stronie głównej podmiotu sprzedającego dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać 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 pośrednictwa. 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 zapośredniczenia reklam mobilnych Google dla Unity Ads wykorzystuje metodęGmaMediationUnity.setCCPAConsent(). 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.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.

Weryfikacja 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 podstawowy w odpowiedzi reklamy, korzystając z ResponseInfo w tych klasach:

Android

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

iOS

GADMAdapterUnity
GADMediationAdapterUnity

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

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ł miejsce docelowe ze stanem 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 UnityAds próbował 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 ERROR.
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 finished presenting with error state 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.

Changelog adaptera zapośredniczenia Unity Ads na platformę Flutter

Wersja 1.2.0

  • Skompilowano i przetestowano za pomocą wtyczki Google Mobile Ads dla Fluttera w wersji 5.3.1.

Wersja 1.1.0

  • Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.2.0.

Wersja 1.0.0

  • Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.0.0.