Integracja Unity Ads z zapośredniczeniem

Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Unity Ads za pomocą zapośredniczenia, na temat integracji kaskadowych. 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 ustalania stawek jest zamknięta w wersji beta, skontaktuj się ze swoim menedżerem konta i poproś o dostęp.

Wymagania

• Najnowsza wersja pakietu SDK do reklam mobilnych Google
• Flutter w wersji 3.7.0 lub nowszej
• Do wdrożenia na Androidzie
  • Interfejs API Androida na poziomie 21 lub wyższym
• Aby wdrożyć aplikację na iOS:
  • Cel wdrożenia iOS w wersji 12.0 lub nowszej
• działający Flutter projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Zobacz Rozpocznij, aby dowiedzieć się więcej.
• Dokończ zapośredniczenie Przewodnik dla początkujących

Krok 1. Skonfiguruj ustawienia w interfejsie Unity Ads

Zarejestruj się lub zaloguj w Unity Ads.

Utwórz projekt

W panelu reklam Unity otwórz Projekty i kliknij Utwórz projekt.

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

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

W oknie Konfiguracja projektu wybierz Planuję korzystać z zapośredniczenia, a następnie Google AdMob dla partnera zapośredniczenia, a następnie kliknij Dalej.

Wybierz ustawienia reklamy i kliknij Dalej.

Wypełnij formularz i kliknij 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

Znajdź klucz interfejsu Unity Ads Reporting API

Włączanie trybu testowego

Tryb testowy możesz włączyć w Panel Unity Ads W obszarze roboczym Twojego 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 żądania reklam Unity Ads w AdMob interfejsie

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

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

Krok 3. Zaimportuj pakiet SDK i adapter Unity Ads

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

Obowiązujące w Google zgoda użytkownika z UE Google, musisz dopilnować, aby takie oświadczenia zostały ujawnione. zgody użytkowników z Europejskiego Obszaru Gospodarczego dotyczące: wykorzystywania 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). Wyświetlając prośbę o zgodę na wykorzystanie danych, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe i dostarczają informacji o korzystaniu z poszczególnych sieci. Google obecnie nie może automatycznego przekazywania do takich sieci wyboru użytkownika dotyczącego zgody.

Wtyczka zapośredniczenia do reklam mobilnych Google dla Unity Ads obejmuje GmaMediationUnity.setGDPRConsent() . Poniższy przykładowy kod pokazuje, jak przekazać informacje o zgodzie 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.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

Stany Zjednoczone przepisy stanowe o ochronie prywatności wymagają dawania użytkownikom zrezygnować z „wyprzedaży”, „danych osobowych” (zgodnie z definicją w ustawie tych haseł) z opcją rezygnacji dostępną za pomocą dobrze widocznego powiadomienia „Nie sprzedawaj Informacje” w wierszu „sprzedaż”, na stronie głównej strony. Przewodnik dotyczący zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w celu 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 do mediowania reklam mobilnych Google dla Unity Adsobsługuje metodę GmaMediationUnity.setCCPAConsent() . Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu Unity Ads SDK. Jeśli chcesz wywoływać tę metodę, zalecamy wykonanie więc 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łącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby AdMob 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 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 powiązane z nimi komunikaty wysyłane przez adapter UnityAds, gdy: nie można wczytać reklamy:

Historia zmian adaptera zapośredniczenia Flutter w reklamach Unity

Wersja 1.1.0

• Zweryfikowano zgodność z adapterem Unity na Androida w wersji 4.12.2.0
• Zweryfikowano zgodność z adapterem systemu iOS Unity w wersji 4.12.2.0
• Utworzono i przetestowano z użyciem wtyczki Google Mobile Ads Flutter w wersji 5.1.0.

Wersja 1.0.0

• Pierwsza wersja.
• Zweryfikowano zgodność z adapterem Unity na Androida w wersji 4.10.0.0
• Wersja 4.10.0.0 adaptera Unity iOS jest zgodna z weryfikowaną wersją
• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.0.0.