Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z AdColony za pomocą zapośredniczenia, zarówno w zakresie określania stawek, jak i integracji kaskady. Omawiamy w nim, jak dodać AdColony do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować AdColony SDK i adapter z aplikacją na Unity.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia AdMob dla AdColony ma te możliwości:
Integracja | |
---|---|
Ustalanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Otrzymano |
Wymagania
- Unity w wersji 5.6 lub nowszej
- Najnowszy pakiet SDK do reklam mobilnych Google
- [Na potrzeby określania stawek]: wtyczka zapośredniczenia reklam mobilnych Google dla AdColony w wersji 1.0.5 lub nowszej (zalecana jest najnowsza wersja)
- Aby przeprowadzić wdrożenie na Androidzie:
- Interfejs API Androida na poziomie 19 lub wyższym
- Aby wdrożyć w iOS:
- Wartość docelowa wdrożenia iOS w wersji 12.0 lub nowszej
- Działający projekt na Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
- Skorzystaj z zapośredniczenia Wprowadzenie
Krok 1. Skonfiguruj ustawienia w interfejsie AdColony
Zarejestruj się i zaloguj na konto AdColony. Dodaj swoją aplikację do panelu wydawcy AdColony, klikając przycisk Skonfiguruj nową aplikację.
Wypełnij formularz i kliknij Utwórz u dołu strony, aby dodać aplikację do AdColony.
Android
iOS
Po utworzeniu aplikacji możesz uzyskać jej identyfikator, klikając Zarabianie > Aplikacje w sekcji Podstawowe informacje o aplikacji.
Android
iOS
Następnie utwórz nową strefę reklamową, klikając przycisk Skonfiguruj nową strefę reklamową w sekcji Strefy reklam na stronie aplikacji. Zalecamy utworzenie nowej strefy reklamowej na potrzeby zapośredniczenia, AdMob nawet jeśli ją masz.
Android
iOS
Dodatkowe instrukcje tworzenia miejsca docelowego reklamy znajdziesz na karcie odpowiadającej wybranemu formatowi reklamy.
Baner
- Ustaw Strefa jest aktywna? na Tak.
Wpisz nazwę strefy reklam.
Jako Rozmiar strefy reklam wybierz Baner.
Wpisz wartość dziennego limitu odtworzeń.
Pełnoekranowa
- Ustaw Strefa jest aktywna? na Tak.
Wpisz nazwę strefy reklam.
Jako Typ strefy wybierz Przed filmem/reklamą pełnoekranową.
Wpisz wartość dziennego limitu odtworzeń.
Otrzymano
- Ustaw Strefa jest aktywna? na Tak.
Wpisz nazwę strefy reklam.
Jako Typ strefy wybierz Value Exchange/V4VC.
Ustaw opcję Tylko po stronie klienta? na Tak i podaj nazwę waluty wirtualnej, dzienną maksymalną liczbę filmów na użytkownika i kwotę nagrody.
Wpisz wartość dziennego limitu odtworzeń.
Gdy skończysz, kliknij przycisk Utwórz, aby utworzyć strefę reklam.
Po utworzeniu strefy reklam Identyfikator strefy znajdziesz w sekcji Integracja tej strefy. Identyfikator strefy zostanie użyty w następnym kroku.
Znajdowanie klucza interfejsu AdColony API
Ustalanie stawek
W przypadku integracji określania stawek ten krok nie jest wymagany.
Wodospad
Aby skonfigurowaćAdMob identyfikator jednostki reklamowej, musisz mieć klucz interfejsu API AdColony. W panelu wydawcy AdColony otwórz Ustawienia konta, aby znaleźć klucz interfejsu API.
Włącz tryb testowy
Aby włączyć reklamy testowe w AdColony, otwórz panel AdColony i kliknij Zarabianie > Aplikacje. W sekcji Strefy reklam wybierz strefę, w której chcesz włączyć reklamy testowe. Reklamy testowe możesz włączyć, zaznaczając w sekcji Programowanie pole wyboru Tak na Wyświetlaj tylko reklamy testowe?.
Krok 2. Skonfiguruj oferty reklamowe AdColony w AdMob interfejsie użytkownika
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.
Dodaj AdColony do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi
Wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia amerykańskich przepisów stanowych , aby dodać AdColony do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w AdMob UI.
Krok 3. Zaimportuj pakiet SDK AdColony i adapter
Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla AdColony, korzystając z linku do pobierania w dzienniku zmian, i wyodrębnij GoogleMobileAdsAdColonyMediation.unitypackage
z pliku ZIP.
W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsAdColonyMediation.unitypackage
. Zaznacz wszystkie pliki i kliknij Importuj.
Następnie wybierz Zasoby > Program do rozpoznawania Usług Google Play > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka zewnętrznego menedżera zależności przeprowadzi rozpoznawanie zależności od podstaw i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
aplikacji na Unity.
Krok 4. Zaimplementuj ustawienia prywatności w pakiecie SDK AdColony
Zgoda użytkowników z UE a RODO
Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) udzielili określonych informacji na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz uzyskali od nich odpowiednie zgody. 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). Żeby uzyskać zgodę na wykorzystanie danych, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub wykorzystywać dane osobowe, a także dostarczać informacje o korzystaniu z nich przez poszczególne sieci. Obecnie Google nie może automatycznie przekazać zgody użytkownika na wykorzystanie danych do takich sieci.
Wtyczka zapośredniczenia reklam mobilnych Google dla AdColony w wersji 2.6.1 dodała klasę AdColonyAppOptions
z metodami SetPrivacyFrameworkRequired()
i SetPrivacyConsentString()
, aby umożliwić przekazywanie zgody na pakiet SDK AdColony. Poniższy przykładowy kod pokazuje, jak przekazać do adaptera AdColony informacje o zgodzie, które są następnie używane w metodzie inicjowania AdColony. Te opcje należy ustawić przed zainicjowaniem pakietu SDK do reklam mobilnych Google, aby upewnić się, że zostaną prawidłowo przekazane do pakietu SDK AdColony.
using GoogleMobileAds.Api.Mediation.AdColony;
// ...
AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.GDPR, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.GDPR, "myPrivacyConsentString");
Więcej informacji oraz wartości, które mogą być podane w metodzie, znajdziesz w artykule o ochronie prywatności konsumentów (w języku angielskim) i przewodniku po wdrażaniu przepisów dotyczących ochrony prywatności.
Amerykańskie przepisy stanowe o ochronie prywatności
Amerykańskie przepisy stanowe o ochronie prywatności wymagają przyznania użytkownikom prawa do wycofania zgody na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie), przy czym opcja ta jest dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej sprzedającego. 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 żadnej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność z zasadami.
Wtyczka zapośredniczenia reklam mobilnych Google dla AdColony w wersji 2.6.1 dodała klasę AdColonyAppOptions
z metodami SetPrivacyFrameworkRequired()
i SetPrivacyConsentString()
, aby umożliwić przekazywanie zgody na pakiet SDK AdColony. Poniższy przykładowy kod pokazuje, jak przekazywać do adaptera AdColony informacje o zgodzie, które są następnie używane w metodzie inicjowania AdColony. Te opcje należy ustawić przed zainicjowaniem pakietu SDK do reklam mobilnych Google, aby mieć pewność, że zostaną prawidłowo przekazane do pakietu SDK AdColony.
using GoogleMobileAds.Api.Mediation.AdColony;
// ...
AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.CCPA, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.CCPA, "myPrivacyConsentString");
Więcej informacji oraz wartości, które mogą być podane w metodzie, znajdziesz w artykule o ochronie prywatności konsumentów (w języku angielskim) i przewodniku po wdrażaniu przepisów dotyczących ochrony prywatności.
Krok 5. Dodaj wymagany kod
Android
Integracja z AdColony nie wymaga dodatkowego kodu.
iOS
Integracja SKAdNetwork
Wykonaj dokumentację AdColony, aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu.
Krok 6. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby AdMob i włącz tryb testowy w AdColony interfejsie użytkownika.
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyAdColony, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z AdColony (Bidding) and AdColony (Waterfall) źródeł reklam.
Kroki opcjonalne:
Android
Uprawnienia
Aby uzyskać optymalną wydajność, AdColony zaleca dodanie poniższych opcjonalnych uprawnień do pliku AndroidManifest.xml
znajdującego się w katalogu Assets/Plugins/Android/GoogleMobileAdsPlugin
projektu na Unity.
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.VIBRATE" />
iOS
Integracja z iOS nie wymaga żadnych dodatkowych czynności.
Parametry specyficzne dla sieci
Pakiet zapośredniczenia AdColony obsługuje dodatkowe parametry konfiguracji i żądania, które można przekazywać do adaptera za pomocą klas AdColonyMediationExtras
i AdColonyAppOptions
.
Klasa AdColonyMediationExtras
zawiera te metody:
SetShowPrePopup(bool)
- Określa, czy przed wyświetleniem reklamy ma się wyświetlać wyskakujące okienko. Ustaw wartość „false”, jeśli nie chcesz, by przed wyświetleniem reklam wyświetlał się wyskakujące okienko.
SetShowPostPopup(bool)
- Określa, czy wyskakujące okienko ma być wyświetlane po wyświetleniu reklamy. Ustaw wartość „false”, jeśli nie chcesz pokazać wyskakującego okienka po wyświetleniu reklamy.
Klasa AdColonyAppOptions
zawiera te metody:
SetUserId(string)
- Ustawia identyfikator User-ID na potrzeby pakietu SDK AdColony, który udostępnia dodatkowe statystyki serwerowi reklam AdColony.
SetTestMode(bool)
- Określa, czy w przypadku pakietu SDK AdColony ma być włączony tryb testowy.
Oto przykład kodu, który pokazuje, jak ustawić te konfiguracje i parametry żądania reklamy:
// Set app-level configurations
AdColonyAppOptions.SetUserId("myUser");
AdColonyAppOptions.SetTestMode(true);
// Set ad request parameters
AdColonyMediationExtras extras = new AdColonyMediationExtras();
extras.SetShowPrePopup(true);
extras.SetShowPostPopup(true);
AdRequest request = new AdRequest.Builder()
.AddMediationExtras(extras)
.Build();
Kody błędów
Jeśli adapter nie otrzyma reklamy z AdColony, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z ResponseInfo
w tych klasach:
Android
com.jirbo.adcolony.AdColonyAdapter
com.google.ads.mediation.adcolony.AdColonyMediationAdapter
iOS
GADMAdapterAdColony
GADMediationAdapterAdColony
Oto kody i powiązane z nimi wiadomości wysyłane przez adapter AdColony, gdy nie można wczytać reklamy:
Android
Kod błędu | Przyczyna |
---|---|
100 | Pakiet SDK AdColony zwrócił błąd. |
101 | Nieprawidłowe parametry serwera (np. brak identyfikatora strefy). |
102 | Żądanie reklamy dla tego samego identyfikatora strefy zostało już wysłane. |
103 | Pakiet SDK AdColony zwrócił błąd inicjowania. |
104 | Żądany rozmiar banera nie jest zmapowany na prawidłowy rozmiar reklamy AdColony. |
105 | Błąd prezentacji, ponieważ reklama nie została wczytana. |
106 | Kontekst użyty do zainicjowania pakietu SDK AdColony nie był instancją Activity . |
iOS
Kod błędu | Przyczyna |
---|---|
0–3 | Pakiet SDK AdColony zwrócił błąd. Więcej informacji znajdziesz w dokumentacji. |
101 | Nieprawidłowe parametry serwera (np. brak identyfikatora strefy). |
102 | Kontroler widoku głównego wyświetlającego reklamę to nil . |
103 | Pakiet SDK AdColony zwrócił błąd inicjowania. |
104 | Pakiet AdColony SDK nie obsługuje dwukrotnej konfiguracji w ciągu 5 sekund. |
105 | Nie udało się wyświetlić reklamy. |
106 | Strefa używana na potrzeby reklam z nagrodą nie jest strefą reklamy z nagrodą w portalu AdColony. |
Historia zmian wtyczki AdColony Unity Mediation
Wersja 2.6.3 (w toku)
- Naprawiliśmy ostrzeżenie o zduplikowanej definicji definicji
MediationExtras
.
Wersja 2.6.2
- Treści adaptera zostały przeniesione do:
GoogleMobileAds/Mediation/AdColony/
. - Zrefaktoryzowano przestrzeń nazw adaptera na
GoogleMobileAds.Mediation.AdColony
. - Obsługuje adapter AdColony na Androida w wersji 4.8.0.2.
- Obsługuje adapter AdColony na iOS w wersji 4.9.0.2.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.1.0.
Wersja 2.6.1
- Zaktualizowaliśmy interfejsy API prywatności z klasy
AdColonyAppOptions
do tych metod, aby zapewnić zgodność z RODO i CCPA:SetGDPRRequired(bool)
->SetPrivacyFrameworkRequired(AdColonyPrivacyFramework, bool)
IsGDPRRequired()
->GetPrivacyFrameworkRequired(AdColonyPrivacyFramework)
SetGDPRConsentString(string)
–>SetPrivacyConsentString(AdColonyPrivacyFramework, string)
GetGDPRConsentString()
->GetPrivacyConsentString(AdColonyPrivacyFramework)
- Obsługuje adapter AdColony na Androida w wersji 4.8.0.1.
- Obsługuje adapter AdColony na iOS w wersji 4.9.0.2.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.4.1.
Wersja 2.6.0
- Obsługuje adapter AdColony na Androida w wersji 4.8.0.0.
- Obsługuje adapter AdColony na iOS w wersji 4.9.0.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.1.0.
Wersja 2.5.0
- Obsługuje adapter AdColony na Androida w wersji 4.7.0.0.
- Obsługuje adapter AdColony na iOS w wersji 4.8.0.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 2.4.1
- Obsługuje adapter AdColony na Androida w wersji 4.6.5.0.
- Obsługuje adapter AdColony na iOS w wersji 4.7.2.2.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 2.4.0
- Obsługuje adapter AdColony na Androida w wersji 4.6.5.0.
- Obsługuje adapter AdColony na iOS w wersji 4.7.2.0.
Wersja 2.3.0
- Obsługuje adapter AdColony na Androida w wersji 4.5.0.0.
- Obsługuje adapter AdColony na iOS w wersji 4.6.1.0.
Wersja 2.2.0
- Obsługuje adapter AdColony na Androida w wersji 4.2.4.0.
- Obsługuje adapter AdColony na iOS w wersji 4.4.1.0.
Wersja 2.1.0
- Obsługuje adapter AdColony na Androida w wersji 4.2.0.0.
- Obsługuje adapter AdColony na iOS w wersji 4.3.0.0.
Wersja 2.0.3
- Powtórnie pakietu
adcolony-extras-library.jar
do wersjiadcolony-unity-android-library.aar
przy użyciu kompilacji.aar
z myślą o Unity 2020.- Przy przejściu na tę wersję usuń z projektu
adcolony-extras-library.jar
.
- Przy przejściu na tę wersję usuń z projektu
- Obsługuje adapter AdColony na Androida w wersji 4.1.4.1.
- Obsługuje adapter AdColony na iOS w wersji 4.1.5.0.
Wersja 2.0.2
- Obsługuje adapter AdColony na Androida w wersji 4.1.4.1.
- Obsługuje adapter AdColony na iOS w wersji 4.1.4.1.
Wersja 2.0.1
- Obsługuje adapter AdColony na Androida w wersji 4.1.4.0.
- Obsługuje adapter AdColony na iOS w wersji 4.1.4.0.
Wersja 2.0.0
- Obsługuje adapter AdColony na Androida w wersji 4.1.0.0.
- Obsługuje adapter AdColony na iOS w wersji 4.1.2.0.
Wersja 1.0.6
- Obsługuje adapter AdColony na Androida w wersji 3.3.11.0.
- Obsługuje adapter AdColony na iOS w wersji 3.3.8.1.0.
Wersja 1.0.5
- Przeniesiono te metody z klasy konstruktora
AdColonyMediationExtras
do klasyAdColonyAppOptions
:SetGDPRRequired()
SetGDPRConsentString()
SetUserId()
SetTestMode()
- Dodano do klasy
AdColonyAppOptions
te metody:IsGDPRRequired()
GetGDPRConsentString()
GetUserId()
IsTestMode()
- Usunięto metodę
SetZoneId()
z klasy konstruktoraAdColonyMediationExtras
. - Obsługuje adapter AdColony na Androida w wersji 3.3.10.1.
- Obsługuje adapter AdColony na iOS w wersji 3.3.7.2.
Wersja 1.0.4
- Zaktualizowaliśmy wtyczkę, aby obsługiwała nowy interfejs API z nagrodą w otwartej wersji beta.
- Obsługuje adapter AdColony na Androida w wersji 3.3.8.1.
- Obsługuje adapter AdColony na iOS w wersji 3.3.6.1.
Wersja 1.0.3
- Obsługuje adapter AdColony na Androida w wersji 3.3.5.1.
- Obsługuje adapter AdColony na iOS w wersji 3.3.5.0.
Wersja 1.0.2
- Obsługuje pakiet AdColony Android SDK w wersji 3.3.4.
- Obsługuje pakiet AdColony iOS SDK w wersji 3.3.4.
- Element
SetTestMode()
z klasy konstruktoraAdColonyMediationExtras
jest teraz ignorowany w przypadku Androida. Wydawcy mogą teraz wysyłać żądania reklam testowych z AdColony na Androida, określając urządzenie testowe za pomocąAddTestDevice()
z klasyAdRequest
Builder. - Do klasy
AdColonyMediationExtras
Builder dodaliśmy te metody:SetGDPRRequired()
SetGDPRConsentString()
Wersja 1.0.1
- Obsługuje pakiet AdColony Android SDK w wersji 3.3.0-unity.
- Obsługuje pakiet AdColony iOS SDK w wersji 3.3.0.
Wersja 1.0.0
- Pierwsza wersja!
- Obsługuje pakiet AdColony Android SDK w wersji 3.3.0.
- Obsługuje pakiet AdColony iOS SDK w wersji 3.3.0.