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ś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 kliknij kolejno Projekty i 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 ustawienia reklamy i kliknij Dalej.

Wypełnij formularz i kliknij Dodaj projekt.

Zanotuj identyfikator gry.

Tworzenie jednostek reklamowych i miejsc docelowych

Kliknij kolejno Generowanie przychodu z Unity Ads > Miejsca docelowe i Dodaj jednostkę reklamową.

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

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

Znajdowanie klucza interfejsu API do raportowania Unity Ads

Włączanie trybu testowego

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

Tryb testowy możesz wymusić w przypadku aplikacji, 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ń pośrednictwa dla jednostki reklamowej

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 ramach europejskich i amerykańskich przepisów stanowych w interfejsie AdMob.

Krok 3. Zaimportuj pakiet SDK i adapter Unity Ads

Integracja za pomocą 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. Obecnie Google nie może automatycznie przekazywać sieciom takich informacji.

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 prywatności 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

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 funkcji ResponseInfo w tych klasach:

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

GADMAdapterUnity
GADMediationAdapterUnity

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

Informacje o zmianach w adapterze zapośredniczenia Fluttera Unity Ads

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.