Integracja AdColony z zapośredniczeniem

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

Skonfiguruj nową aplikację AdColony

Wypełnij formularz i kliknij Utwórz u dołu strony, aby dodać aplikację do AdColony.

Android

Utwórz aplikację AdColony

iOS

Utwórz aplikację AdColony

Po utworzeniu aplikacji możesz uzyskać jej identyfikator, klikając Zarabianie > Aplikacje w sekcji Podstawowe informacje o aplikacji.

Android

Identyfikator aplikacji AdColony

iOS

Identyfikator aplikacji AdColony

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

Strefa konfiguracji AdColony

iOS

Strefa konfiguracji AdColony

Dodatkowe instrukcje tworzenia miejsca docelowego reklamy znajdziesz na karcie odpowiadającej wybranemu formatowi reklamy.

  1. Ustaw Strefa jest aktywna? na Tak.

  2. Wpisz nazwę strefy reklam.

  3. Jako Rozmiar strefy reklam wybierz Baner.

  4. Wpisz wartość dziennego limitu odtworzeń.

Pełnoekranowa

  1. Ustaw Strefa jest aktywna? na Tak.

  2. Wpisz nazwę strefy reklam.

  3. Jako Typ strefy wybierz Przed filmem/reklamą pełnoekranową.

  4. Wpisz wartość dziennego limitu odtworzeń.

Otrzymano

  1. Ustaw Strefa jest aktywna? na Tak.

  2. Wpisz nazwę strefy reklam.

  3. Jako Typ strefy wybierz Value Exchange/V4VC.

  4. Ustaw opcję Tylko po stronie klienta? na Tak i podaj nazwę waluty wirtualnej, dzienną maksymalną liczbę filmów na użytkownika i kwotę nagrody.

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

Identyfikator strefy AdColony

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.

Ustawienia AdColony

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

Test AdColony

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

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

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

Wersja 2.5.0

Wersja 2.4.1

Wersja 2.4.0

Wersja 2.3.0

Wersja 2.2.0

Wersja 2.1.0

Wersja 2.0.3

Wersja 2.0.2

Wersja 2.0.1

Wersja 2.0.0

Wersja 1.0.6

Wersja 1.0.5

  • Przeniesiono te metody z klasy konstruktora AdColonyMediationExtras do klasy AdColonyAppOptions:
    • SetGDPRRequired()
    • SetGDPRConsentString()
    • SetUserId()
    • SetTestMode()
  • Dodano do klasy AdColonyAppOptions te metody:
    • IsGDPRRequired()
    • GetGDPRConsentString()
    • GetUserId()
    • IsTestMode()
  • Usunięto metodę SetZoneId() z klasy konstruktora AdColonyMediationExtras.
  • 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 konstruktora AdColonyMediationExtras 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 klasy AdRequest 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.