Przejdź do głównej zawartości

Ad Mediator, czyli dodajemy wiele sieci reklamowych do aplikacji Windows Phone

Sposobów na zarabianie na aplikacjach mobilnych jest bardzo dużo. Od udostępniania płatnych wersji oprogramowania, poprzez mikropłatności, aż do reklam umieszczanych wewnątrz aplikacji. Ten ostatni element nie wymaga dużego wkładu własnego od programisty, nie zmusza użytkowników do wydawania ciężko zarobionych pieniędzy, a dodatkowo jest możliwy do wdrożenia niemalże w każdym typie aplikacji. Co więcej, reklama może być motorem napędowym do innych płatności. Wystarczy, że umieścimy wersję płatną bez reklam lub dodamy mikropłatność, która wyłączy reklamy.

Osoby tworzące aplikacje na Windows Phone w czystym środowisku deweloperskim mają gotową kontrolkę AdControl, która umożliwia proste wyświetlanie reklam Microsoft Advertising. Działa to wyśmienicie, ale jeśli chcielibyśmy dodać inne sieci reklamowe (w celu zwiększenia przychodów poprzez optymalizację reklamodawców do rynku) jak AdMob od Google czy AdDuplex, wówczas mamy nie lada problem.

desk

AdMob (Google), AdDuplex, Smaato i inne, mają własne SDK do obsługi reklam w Windows Phone. Aby móc wyświetlać reklamy od kilku reklamodawców należy zagłębić się w szczegóły konfiguracji każdej z kontrolek, a poza tym napisać kod, który będzie zarządzał kilkoma kontrolkami. Na pewno nie jest to ani proste, ani wydajne, a co więcej, możemy być pewnie, iż już ktoś miał identyczny problem i zapewne go dawno rozwiązał!

Wszyscy znają zasadę DRY (Don’t Repeat Yourself), która zalecająca unikanie różnego rodzaju powtórzeń wykonywanych przez deweloperów. W obecnych czasach, gdzie mamy dostęp do sieci, forów i NuGeta, warto dodać jeszcze zasadę DROP: Don't Repeat Other People. Nie inaczej jest w tym przypadku. Od dłuższego czasu dostępna jest kontrolka AdRotator, która współpracuje z wieloma sieciami reklamowymi i posiada ciekawy zestaw opcji. Jednakże warto wiedzieć, że w listopadzie 2014 Microsoft stworzył własną kontrolkę Ad Mediator do zarządzania wieloma sieciami reklamowymi pod Windows Phone. Jest to ciekawa alternatywa do AdRotator, a do tego posiada interesujące funkcje, które znacznie ułatwiają wdrożenie i konfigurację wielu sieci reklamowych. Olbrzymim plusem jest także możliwość zdalnego zarządzania kontrolką z poziomu Dev Center.

Ad Mediator wspiera Windows Phone 8.0/8.1 pod Silverlightem oraz Windows Phone 8.1 XAML. W przyszłości lista ta zostanie rozszerzona o aplikacje Windows Phone 8.1 tworzone w JavaScripcie oraz aplikacje pod Windows Store (Modern). Kontrolka posiada następujące sieci reklamowe (z uwzględnieniem wsparcia dla poszczególnych typów aplikacji):

desk

Implementacja i konfiguracja Ad Mediatora w Windows Phone nie jest skomplikowana. Oto poradnik jak krok pro kroku dodać wiele sieci reklamowych do własnej aplikacji na system mobilny od Microsoftu.

Dodanie Ad Mediatora do projektu

Pierwszą czynnością będzie pobranie rozszerzenia Ad Mediator i zainstalowanie go. Wówczas możemy przystąpić do dodania i konfiguracji kontrolki w projekcie:

  • Dodanie kontrolki do strony

Najszybszym sposobem stworzenia kontrolki jest przeciągnięcie AdMediatorControl z Toolboxa na okno Designera wybranej strony. Pamiętać należy, że każda kontrolka musi mieć własny, unikatowy ID w obrębie aplikacji:

  <WindowsPhone8:AdMediatorControl 
            x:Name="AdMediator_121F5B"
            Id="AdMediator-Id-ED7FED89-9736-4889-A807-894C9765148F" 
            Height="80"
            Width="480"
            VerticalAlignment="Top" 
            HorizontalAlignment="Center" />
  • Obsługa zdarzeń

W celu debugowania, jak i reakcji na zdarzenia (np. ukrywanie kontrolki, gdy nie ma reklam lub w przypadku braku dostępu do sieci), warto dodać eventy do AdMediatorControl:



//problem z konfiguracją SDK wybranej sieci
void AdMediator_AdSdkEvent(object sender, AdSdkEventArgs e)
{
    Debug.WriteLine("AdSdk event {0} by {1}", e.EventName, e.Name);
}

//nie wyświetlą się żadne reklamy
void AdMediator_AdMediatorError(object sender, AdMediatorFailedEventArgs e)
{
    Debug.WriteLine("AdMediatorError:" + e.Error + " " + e.ErrorCode );
}

//kontrolka wyświetli reklamę z wybranej sieci
void AdMediator_AdFilled(object sender, AdSdkEventArgs e)
{
    Debug.WriteLine("AdFilled:" + e.Name);
}

//błąd wybranej sieci (brak połączenia z serwerem, brak reklam z sieci, itp.)
void AdMediator_AdError(object sender, AdFailedEventArgs e)
{
    Debug.WriteLine("AdSdkError by {0} ErrorCode: {1} ErrorDescription: {2} 
                Error: {3}",e.Name, e.ErrorCode, e.ErrorDescription, e.Error);
}
  • Obsługa nieoczekiwanych wyjątków ze strony poszczególnych sieci reklamowych

Zaleca się, aby do pliku App.xaml.cs dodać obsługę wyjątków sieci reklamowych. Dzięki temu będziemy w stanie uniknąć wywrócenia się aplikacji spowodowanej błędem, którejś z wtyczek zewnętrznych. W zdarzeniu UnhandledException dodajemy:



    if (e != null)
   {
       Exception exception = e.ExceptionObject;
       if ((exception is XmlException || exception is NullReferenceException) && exception.ToString().ToUpper().Contains("INNERACTIVE"))
       {
           Debug.WriteLine("Handled Inneractive exception {0}", exception);
           e.Handled = true;
           return;
       }
       else if (exception is NullReferenceException && exception.ToString().ToUpper().Contains("SOMA"))
       {
           Debug.WriteLine("Handled Smaato null reference exception {0}", exception);
           e.Handled = true;
           return;
       }
       else if ((exception is System.IO.IOException || exception is NullReferenceException) && exception.ToString().ToUpper().Contains("GOOGLE"))
      {
          Debug.WriteLine("Handled Google exception {0}", exception);
          e.Handled = true;
          return;
       }
       else if (exception is ObjectDisposedException && exception.ToString().ToUpper().Contains("MOBFOX"))
       {
           Debug.WriteLine("Handled Mobfox exception {0}", exception);
           e.Handled = true;
           return;
       }
       else if ((exception is NullReferenceException || exception is XamlParseException) && exception.ToString().ToUpper().Contains("MICROSOFT.ADVERTISING"))
       {
           Debug.WriteLine("Handled Microsoft.Advertising exception {0}", exception);
           e.Handled = true;
           return;
       }
              
   }



Konfiguracja poszczególnych reklamodawców w Visual Studio

Przyszedł czas na konfiguracje sieci reklamowych. W przykładzie użyję Microsoft Advertising, AdDuplex oraz AdMob (Google).

  • Dodanie sieci reklamowych

Ad Mediator umożliwia szybkie dodanie wybranych sieci reklamowych. W tym celu należy na projekcie Windows Phone kliknąć prawym przyciskiem i wybrać opcję:

Add->ConnectedService...

desk

a w nowo otwartym oknie Services Manager wybrać

  • Select ad networks*

desk

Zaznaczamy w tym miejscu sieci reklamowe, jakie mają być dostępne w aplikacji.

  • Ręczne dodanie brakujących bibliotek

desk

W przykładzie zarówno Microsoft Advertising, jak i AdDuplex nie wymagają dodatkowych bibliotek do działania (inaczej mówiąc Ad Mediator pobierze je za nas). Inaczej jest jednak z AdMob. W tym przypadku aplikacja nie może pobrać dllek i musimy dodać je ręcznie, pobierając paczkę ok. 250 KB ze strony Google Mobile Ads SDK

  • Dane dostępowe

desk

Jeśli wszystko udało się poprawnie dołączyć do projektu, każda z sieci będzie posiadała status Fetched w oknie Services Manager (jeśli mimo wszystko jest inaczej, patrz niżej). Teraz przyszedł czas na szybką konfiguracje sieci, poprzez identyfikatory, które wygenerowaliśmy/dostaliśmy od poszczególnych reklamodawców:

desk

  • Konfiguracja funkcji

Jak zapewne zauważyliście, każda z sieci posiada listę funkcji, które musi spełniać aplikacja, aby móc taką sieć reklamową dodać. Są to niezbędne elementy, które wykorzystywane są przez kontrolkę jak np. możliwość dostępu do sieci, czy wykorzystanie kontrolki webowej.

W tym celu w oknie Services Manager należy przejrzeć ostatnia kolumnę * Required capabilities* i w pliku WMAppManifest.xml dodać wymagana opcje:

desk

desk

Tak skonfigurowana aplikacja powinna już wyświetlać reklamy:

desk

Zdalna konfiguracja reklamodawców przez DevCenter

Jedną z najbardziej wartościowych funkcji Ad Mediatora jest pełna integracja z centrum deweloperskim DevCenter. Po dodaniu aplikacji poprzez portal, DevCenter sam wykryje obecność Ad Mediatora i aktywuje panel do zdalnej konfiguracji kontrolki.

desk

desk

W ty miejscu można skonfigurować:

  • czy dana konfiguracja będzie obejmowała wszystkie markety, czy zostanie dostosowana do konkretnego marketu (języka)

  • rozdzielenie procentowe reklamodawców:

  • automatyczny, równomierny podział

  • ręczne ustalenie procentowe

W tym miejscu można również ustalić czy sieć reklamowa ma być całkowicie wyłączona lub pełnić rolę zapasową

  • dane dostępowe od poszczególnych sieci reklamowych

  • rozmiar bannerów

  • czas odświeżenia

Plik konfiguracyjny Ad Mediatora można pobrać klikając na Download config , w celu podmiany domyślnie stworzonego pliku w Visual Studio, aby ten nie nadpisywał konfiguracji w DevCenter podczas wgrywania nowej wersji.

Najczęstsze problemy i ich rozwiązania

Mimo, że Ad Mediator jest niesłychanie prostym i przyjemnym narzędziem, zdarzają się często małe, ale uciążliwe problemy. Oto kilka z nich, wraz ze wskazówkami na ich rozwiązanie:

  • Żadna z reklam się nie wyświetla

Najszybszą analizą takiego problemu jest podczepienie zdarzenia AdError , opisanego w punkcie Obsługa zdarzeń . W tym miejscu kontrolka zwraca szczegółowe dane odnośnie jaka sieć reklamowa zwróciła wyjątek, z opisem i kodem błędu.

  • Brak reklam na emulatorze

Jest to całkiem normalna przypadłość. Polecam przetestowanie reklam poprzez wgranie aplikacji na realne urządzenie.

  • Ad Mediator nie widzi dllek sieci reklamowych wgranych ręcznie (AdMob i inne) [status Not Fetched]

Jeśli Ad Mediator pokazuje stan dllki na Not Fetched lub Dev Center wskazuje brak dllki w projekcie, pomimo dodania jej do projektu, wówczas warto usunąć sieć reklamową z Ad Mediatora. Należy jednak zrobić to z poziomu NuGeta. W oknie menadżera pakietów usuwamy problematyczną sieć. W tym momencie upewniamy się, że potrzebne dllki są już w projekcie i ponownie dodajemy sieć reklamową poprzez Ad Mediatora, który sam doda niezbędne pakiety z NuGeta.

  • Jak dostosować sieci reklamowe i ich procentowy udział?

Jest to najtrudniejsze z zadań podczas dodawania reklam. W wielu przypadkach różne sieci reklamowe posiadają więcej lub mniej reklam w zależności od regionu. Dodatkowo niektóre sieci nie zawsze mają w danym momencie przygotowaną reklamę w danym regionie i kategorii (występuje to często w przypadku naszego regionu w Microsoft Advertising). Warto również zainteresować się AdDuplexem, który pomaga deweloperem we wzajemnej reklamie ich aplikacji.

Mam nadzieję, że ten poradnik będzie pomocny przy tworzeniu aplikacji i zarabianiu na nich. Życzę wszystkim wysokiego współczynnika klikalności (CTR) :D

Komentarze

Popularne posty z tego bloga

Oni migają tymi kolorami w sposób profesjonalny. Narodziny gamedevu z ducha demosceny w Polsce - Piotr Marecki i Tomasz TDC Cieślewicz, recenzja książki

Tytuł książki jest mocno rozbudowany i zapewne pierwsze spojrzenie na okładkę może odstraszyć potencjalnego klienta, jednakże, warto dać szansę tej pozycji. Zaskoczeń jest kilka, chociaż nie tylko tych pozytywnych. Zatem przejdźmy do krótkiej recenzji "Oni migają tymi kolorami w sposób profesjonalny". TDC - Demoscena, Atari, Mirage i piractwo w Polsce Książka jest zbiorem historii opowiadanych przez Tomasza TDC Cieślewicza. Swoje przygody z IT zaczął w 1988 roku, kiedy to otrzymał Atari 800 XL. Od 1989 roku związany był z Mirage i jako jeden z najmłodszych tworzył gry na rynek polski. Był również współpracownikiem "Bajtka" i członkiem redakcji "Atari Magazynu". Bardzo mocno związany z demosceną Atari, gdzie tworzy do dziś. Zaangażowany w szkolenia i warsztaty z programowania. Obecnie redaktor Atarionline.pl Przyznaję, że wcześniej nie słyszałem o Tomaszu Cieślewiczu, ale po przeczytaniu tej książki śmiało można powiedzieć, że dziś zapewne byłby fre

222 polskie gry, które warto znać - Marcin Kosman, recenzja książki

Marcin Kosman dał się poznać jako autor ciekawej pozycji o polskim game devie: " Nie tylko Wiedźmin. Historia polskich gier komputerowych ". Po pięciu latach wraca z nową książką, również związaną z polską branżą grową, ale w zupełnie innej formie. 222 polskie gry "222 polskie gry, które warto znać" to wyjątkowa książka. Co więcej, to nie jest książka jako taka, a bliżej jej do albumu. W języku angielskim funkcjonują one jako tzw. "Coffee table books", czyli książki/albumy bardziej do oglądania, niż do czytania. Tak jest właśnie z omawianą pozycją. W twardych okładach, w formacie B5 i na pięknym, kredowym papierze, znalazło się 222 polskich gier z lat 1983-2019. Każda strona to duża grafika, z kilkoma zdaniami o grze od autora książki, a czasem również dodatkowy, akapitem od osób tworzących dany kawałek softu. Wybór gier jest na tyle szeroki, że można śmiało powiedzieć, iż wybrano faktycznie najbardziej znaczące i rozpoznawalne tytuły. Jako,

Licznik Blogowy - wersja 0.6, czyli własne statystyki i wykresy tuż pod ręką

Zapewne wielu z Was pamiętam, a może i używa:) , mojej wtyczki Licznik Blogowy do najpopularniejszych przeglądarek, skierowanej do blogerów na portalu dobreprogramy. Jeśli ktoś nie kojarzycie, to w skrócie: Licznik Blogowy to wtyczka do Chroma/Opery/Firefoxa. Za jej pomocą przejrzycie szybko pełne statystyki swoich wpisów na blogu. Lista wpisów może być sortowana wg: ilości wyświetleń, ilości komentarzy, daty publikacji i adnotacji moderacji. Łatwo znajdziecie publikacje, oznaczone przez moderatorów, a to wszystko w estetycznej i miłej formie, dostosowanej do wybranej skórki na blogu. Licznik Blogowy 0.6 - czas na własne wykresy! :) Ostatnia odsłona wtyczki przyniosła ciekawe refleksje po rozmowie z szanownym Panem Mordziem. Zaproponował on, aby wtyczka mogła generować wykresy na podstawie zebranych danych. Pomysł wydał mi się niezmiernie interesujący, stąd też obecna aktualizacja (0.6) przynosi możliwość tworzenia wykresów, opierając się na zabranych danych. Używani

Oprogramowanie z czasopism - wątpliwa przyjemność?

Środek tygodnia, w skrzynce pocztowej pojawia się świeżutki numer Chipa. Jak zawsze szybko rozrywam folie (srut!), wyszukuję płytę(y) dołączonej do magazynu, gdzieś ukrytej pomiędzy stronami. Sukces! Tutaj już postępuje delikatniej, opuszkami palców dostaję się powoli do spoiwa łączącego tekturową kopertę DVD z kartką. Już tylko chwila dzieli mnie od odseparowania DVD od magazynu.... (trach)... niech to! Kartka się porwała, no cóż, nie pozostaje mi nic innego, jak brutalnie wyrwać to coś razem ze stroną. Z drugiej strony i tak pewnie jest reklama (ups... nie tym razem :P). W taki sposób, chcąc pozbyć się zbędnej (?) płyty DVD z Chipa, doszedłem do wniosku, iż od kiedy ponownie zaprenumerowałem czasopismo (na dwa lata, a było to już hmm, prawie dwa lata temu?), ani razu nawet nie włożyłem płyty do czytnika! W sumie przeglądając magazyny często zwracamy uwagę na dodatki do czasopism. W sieci jest wiele stron, których jedynym celem są owe dodatki ( http://www.markolf.pl/ , http://ww

"Amerykański sen" Microsoftu, na którym traci Windows Phone

Do poniższych przemyśleń doszedłem w ostatnim czasie, po publikacji danych na temat regionalizacji w ekosystemie Windows Phone. Są to dwie, ważne informacje. Szczególnie ważne dla nas, użytkowników z Polski (jak i wszystkich spoza USA). Microsoft jako cel postawił sobie zawojowanie rynku USA. To widać od początku powstania Windows Phone. Cały system nakierowany jest przed wszystkim na rynek amerykański. Jak to wygląda z punktu widzenia Polaków oraz jak rozwija się Windows Phone w USA? Windows Phone 7.x - pozdrawiamy użytkowników spoza USA Otóż urządzenia z Windows Phone 7 nie miały nawet polskiego interfejsu, czy klawaitury. Co było dość uciążliwe z oczywistych względów. Te pojawiły się dopiero rok po premierze, wraz z wydaniem dużej aktualizacji do 7.5 tzw. Mango . Oczywiście to nie koniec przykładów jak Microsoft traktuje klientów spoza USA. Linia Windows Phone 7.x ma nadal kilka małych "dodatków", które świadczą jak producent mobilnych okienek podchodzi do klien

Zdrowe ciało, zdrowy duch, zdrowy programista — przegląd aplikacji

Dziś w temacie rozszerzenia do Visual Studio, ale bardziej od strony tego co już jest na rynku i z czego można już korzystać od święta . Tak jak już pisałem , Healthy with Visual Studio będzie wtyczką do Visual Studio, która zadba o przerwę i czas pracy. Może uda się również dorobić jakieś proste ćwiczenia, do rozluźnienia spiętych mięśni. Zrób sobie przerwę i poćwicz Obecnie na rynku jest bardzo duża liczba aplikacji, które pomogą w pracy przy komputerze. 6 lat temu przedstawiłem kilka programów , które do dziś dzień są liderami w swojej niszy. Postaram się w tym wpisie przedstawić je tutaj ponownie z omówieniem kilku nowych, które wydają się niezmiernie ciekawe. Workrave Program legenda. Chyba jedna z najbardziej rozbudowanych i znanych aplikacji. Multiplatformowa, niewielka, a jednocześnie bardzo pomocna. Od ostatniego wpisu w 2011 roku niemalże nic się nie zmieniło. Mamy zatem monitoring pracy z wymuszaniem przerw (czasem dosłownie!), wizualizację ćwiczeń czy

HotZlot 2013 - nie regulujcie odbiorników

HotZlot 2013 już za około miesiąc. Wszyscy zapewne czekają na zaproszenia i rejestrację. Redakcja skutecznie odwraca naszą uwagę od HotZlotu konkursem związanym z Office 365, ale my wiemy, że coś się szykuje ;) Pod adresem http://2013.hotzlot.pl/ znajduje się niby niewiele, ot niewinny błąd: Szybki rzut okiem i już wiemy, że Docent na IIS już stworzył katalog aplikacji z conetentem w D:\IISContent\hotzlot.pl-2013 . Ograniczenie na adres IP nie pozwoli nam na otworzenie strony. Jednakże wystarczy kilka kliknięć w IIS i strona zostanie udostępniona dla ogółu. Zatem, na co czekacie droga Redakcjo? ;) Klikamy tutaj: http://www.hotzlot.pl/ (obecnie jeszcze informacje o HotZlocie 2012) - może licznik wyświetleń musi osiągnąć jakiś poziom, aby pojawiła się informacja o HotZlocie 2013? ;) Pierwszy przeciek! :P Nasz znany bloger i waleczny komentator gowain, zdobył screen z jeszcze nieopublikowanej wersji strony na HotZlot 2013! Co więcej, w kwestii przecieku wypowiedziała si

jQuery - miłość od pierwszego wejrzenia!

[code].......##..#######..##.....##.########.########..##....## .......##.##.....##.##.....##.##.......##.....##..##..##. .......##.##.....##.##.....##.##.......##.....##...####.. .......##.##.....##.##.....##.######...########.....##... .##....##.##..##.##.##.....##.##.......##...##......##... .##....##.##....##..##.....##.##.......##....##.....##... ..######...#####.##..#######..########.##.....##....##... [/code] jQuery - write less, do more Chciałbym podzielić sie z Wami, pięknem jQuery [1] (dalej jq). Kilka miesięcy temu skandyn dodał wpis , w którym przedstawił pobieżnie, jak zrobić prosta galerię z jq, bez zagłębiania i wstępnej prezentacji geniuszu jq:). Tutaj chciałbym ogólnie zaprezentować jq, dla niewtajemniczonych (są jeszcze tacy?:)). Czym jest jq? Można powiedzieć, iż jest to biblioteka do Java Script (dalej js), która, pomaga w obsłudze js i drzew DOM. Jednakże robi to w tak finezyjny sposób, iż po pewnym czasie korzystania z niej, dochodzimy do wniosku, i

Zdrowa praca przy komputerze cz. 1 - Aplikacje wspomagające

Każdy z nas spędza przy komputerze pewien czas, prawie każdego dnia. Dla części jest to również narzędzie pracy. Często zapominamy, iż oprócz czystego biurka :) , należy zadbać o to by nie zaszkodzić sobie. W tym króciutkim, pierwszym wpisie o "Zdrowej pracy przy komputerze", chciałbym zacząć od zaprezentowania dwóch bardzo przydatnych aplikacji, zarówno w domu jak i w pracy. F.lux Pierwszą aplikacją jest mały program do oszczędzania naszych oczu podczas pracy w nocy. Ok, w nocy mało kto pracuje przy kompie, ale czytając tekst na jasnym tle przy sztucznym oświetleniu (powiedzmy jakaś żarówka) nasz wzrok bardzo się męczy. Problemem jest duży kontrast, pomiędzy bardzo jasnym wyświetlaniem obrazu przez monitor, a tłem naszego pokoju. Po dłuższej pracy oczy męczą się szybciej, niż przy naturalnym świetle. Przydatny w takich chwilach jest program F.lux [1]. Jego zadaniem jest jedynie (albo aż) dopasowanie jasności monitora, do oświetlenia panującego w pokoju. Aplikacja je

Niezbędne, "zakazane" aplikacje do Windows Phone 7.5

Świat Windows Phone i nie tylko, czeka z niecierpliwością na nowe wcielenie systemu w wersji 8. Aby umilić czas, przygotowałem kolejną porcję aplikacji, których nie sposób znaleźć w Marketplace. Przedstawione niżej programy, rozszerzają możliwość konfiguracji Windows Phone, a także dodają nowe funkcje, niezbędne dla części z nas. W skrócie o czym dziś będzie mowa: WinTT - tweaker BlueManager - przesyłanie plików przez Bluetooth Orientation Lock - blokowanie autorotacji obrazu WinTT WinTT jest jednym z pierwszych tweakerów jakie powstały na Windows Phone. Oferuje on całkiem pokaźna liczbę opcji, dzięki którym można skonfigurować mobilne okienka. Aplikacja została podzielona na kilka grup, oto krótkie omówienia najciekawszych, dostępnych funkcji: Tweaks - kilka przydatnych opcji do włączenia. Warto zwrócić uwagę na: możliwość zwiększenia ilość zakładek w IE włączenie dostępu do Marketplace/Muzyki/Wideo podczas synchronizacji z Zune wymuszenie