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 ustalania stawek jest w zamkniętej fazie testów beta. Aby uzyskać dostęp, skontaktuj się z menedżerem konta.

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 artykule Pierwsze kroki.
• 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 i wybierz 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

Znajdowanie klucza interfejsu API do raportowania Unity Ads

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 wybierając Włącz tryb testowy (czyli 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 popyt Unity Ads w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

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 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

Integracja przez pub.dev

Dodaj w pliku pubspec.yaml pakietu te zależności z najnowszymi wersjami pakietu SDK i adaptera Unity Ads:

dependencies:
  gma_mediation_unity: ^1.0.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

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 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 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 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 „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 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 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

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.

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

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

GADMAdapterUnity
GADMediationAdapterUnity

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

Informacje o zmianach w Unity Ads Flutter Mediation Adapter

Wersja 1.1.0

• Weryfikowana zgodność z adapterem Unity na Androida w wersji 4.12.3.0
• Zweryfikowana zgodność z adapterem Unity na 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.