palio.modules
Class Ads

java.lang.Object
  palio.modules.core.Module
      palio.modules.Ads

All Implemented Interfaces:

Constants, palio.modules.core.CurrentModuleDataKeys

public final class Ads
extends Module
implements Constants

Moduł do obsługi serwera z reklamami. Możliwe statusy występujące w tym module: [A]ctive, [B]locked, [D]eleted. Obsługiwane typy rotatora reklam: [S]impleRotator (wyświetla reklamy po kolei), [D]rawRotator (losowanie reklam z uwzględnieniem wag).

Moduł wymaga dodatkowych tabelek w bazie danych. Dodatkowo w konfiguracji można podać parametr "connector".

Moduł trzeba dodać w konfiguracji instancji jPalio.

Version:

1.1.1

Author:

Mateusz Gembarzewski

Field Summary

Fields inherited from interface palio.Constants

DECIMAL_ZERO, INTEGER_ONE, LONG_MINUS_ONE, LONG_ONE, LONG_THREE, LONG_TWO, LONG_ZERO, STRING_EMPTY

Fields inherited from interface palio.modules.core.CurrentModuleDataKeys

DESIGNER_ACTIONS_BUFFER, HTML_FORM_BUILDER, HTML_MAP_BUILDER, HTML_MENU_BUILDER, HTML_TOOLTIPS_BUFFER, ITEXT_DOCUMENT, MAIL_MESSAGE, XLS_DOCUMENT, XML_DOCUMENT

Constructor Summary

Ads(Instance instance, java.util.Properties parameters)

Method Summary

void	activateAd(java.lang.Long adID) Aktywuje zablokowaną reklamę przez ustawienie statusu [A]ctive.
void	activateClient(java.lang.Long clientID) Aktywuje zablokowanego klienta przez ustawienie statusu [A]ctive.
void	activateRotator(java.lang.Long rotatorID) Aktywuje zablokowany rotator przez ustawienie statusu [A]ctive.
java.util.LinkedList	adHistory(java.lang.Long adID, java.util.Date dateFrom, java.util.Date dateTo) Zwraca historię odsłon i kliknięć na daną reklamę.
java.lang.Object[]	adStats(java.lang.Long adID) Zwraca proste statystyki odsłon i kliknięć na daną reklamę.
java.lang.Object[]	adStats(java.lang.Long adID, java.util.Date dateFrom, java.util.Date dateTo) Zwraca proste statystyki odsłon i kliknięć na daną reklamę.
java.lang.Object[]	adURL(java.lang.Long rotatorID, java.lang.Object[] adFields) Zwraca komplet linków do danej reklamy.
void	blockAd(java.lang.Long adID) Blokuje aktywną reklamę przez ustawienie statusu [B]locked.
void	blockClient(java.lang.Long clientID) Blokuje aktywnego klienta przez ustawienie statusu [B]locked.
void	blockRotator(java.lang.Long rotatorID) Blokuje aktywny rotator przez ustawienie statusu [B]locked.
java.util.LinkedList	clientStats(java.lang.Long clientID) Zwraca proste statystyki odsłon i kliknięć na reklamy danego klienta.
java.util.LinkedList	clientStats(java.lang.Long clientID, java.util.Date dateFrom, java.util.Date dateTo) Zwraca proste statystyki odsłon i kliknięć na reklamy danego klienta.
java.lang.Long	createAd(java.lang.Long rotatorID, java.lang.Long clientID, java.lang.Object[] fileBanner, java.lang.Long weight, java.util.Date expired, java.lang.Long maxViewCount, java.lang.String targetLink, java.lang.String caption, java.lang.String description) Tworzy nową reklamę.
java.lang.Long	createAd(java.lang.Long rotatorID, java.lang.Long clientID, java.lang.String banner, java.lang.Long weight, java.util.Date expired, java.lang.Long maxViewCount, java.lang.String targetLink, java.lang.String caption, java.lang.String description) Tworzy nową reklamę.
java.lang.Long	createClient(java.lang.String name, java.lang.String address, java.lang.String city, java.lang.String country, java.lang.String phone, java.lang.String email, java.lang.String identifier, java.lang.String description) Tworzy nowego klienta (właściciela reklam).
java.lang.Long	createRotator(java.lang.String name, java.lang.String type, java.lang.String description) Tworzy nowy rotator reklam (grupa reklam z określoną polityką wyświetlania).
void	deleteAd(java.lang.Long adID) Kasuje reklamę (ustawia status [D]eleted).
void	deleteClient(java.lang.Long clientID) Kasuje klienta wraz ze wszystkimi jego reklamami (ustawia status [D]eleted).
void	deleteRotator(java.lang.Long rotatorID) Kasuje rotator wraz ze wszystkimi podpiętymi do niego reklamami (ustawia status [D]eleted).
java.lang.Object[]	getAd(java.lang.Long adID) Zwraca dane reklamy w postaci tablicy z wartościami pól: [identyfikator, status, nazwa rotatora, nazwa klienta, data utworzenia, data ostatniej odsłony, waga, ilość wyświetleń, całkowita ilość wyświetleń, maksymalna ilość wyświetleń, data ostatniego kliknięcia, liczba kliknięć, data zablokowania, data wygaśnięcia, adres docelowy, podpis, opis].
java.util.LinkedList	getAds() Zwraca listę wszystkich reklam.
java.util.LinkedList	getAds(java.lang.Long rotatorID, java.lang.Long clientID) Zwraca listę reklam przypisanych do podanego rotatora i/lub klienta.
java.lang.Object[]	getClient(java.lang.Long clientID) Zwraca dane klienta w postaci tablicy z wartościami pól: [identyfikator, status, nazwa, data utworzenia, data zablokowania, adres, miasto, kraj, numer telefonu, adres email, dodatkowy identyfikator, opis].
java.lang.Object[]	getClient(java.lang.String clientName) Zwraca dane klienta w postaci tablicy z wartościami pól: [identyfikator, status, nazwa, data utworzenia, data zablokowania, adres, miasto, kraj, numer telefonu, adres email, dodatkowy identyfikator, opis].
java.util.LinkedList	getClients() Zwraca listę wszystkich klientów.
java.lang.Object[]	getRotator(java.lang.Long rotatorID) Zwraca dane rotatora w postaci tablicy z wartościami pól: [identyfikator, status, typ, nazwa, data utworzenia, data zablokowania, opis].
java.lang.Object[]	getRotator(java.lang.String rotatorName) Zwraca dane rotatora w postaci tablicy z wartościami pól: [identyfikator, status, typ, nazwa, data utworzenia, data zablokowania, opis].
java.util.LinkedList	getRotators() Zwraca listę wszystkich rotatorów.
java.lang.String	getVersion() Returns the module version
java.util.LinkedList	rotatorStats(java.lang.Long rotatorID) Zwraca proste statystyki odsłon i kliknięć na reklamy w danym rotatorze.
java.util.LinkedList	rotatorStats(java.lang.Long rotatorID, java.util.Date dateFrom, java.util.Date dateTo) Zwraca proste statystyki odsłon i kliknięć na reklamy z danego rotatora.
java.lang.Object[]	rotatorURL(java.lang.Long rotatorID) Zwraca komplet linków (dwuelementowa tablica) do danego rotatora reklam, z którego pierwszy element używamy do wyświetlenia reklamy (atrybut SRC) a drugi do kliknięcia na reklamie (atrybut HREF).
java.lang.Object[]	rotatorURL(java.lang.String rotatorName) Zwraca URL do danego rotatora reklam.
void	undeleteAd(java.lang.Long adID) Przywraca skasowaną reklamę (ustawia status [A]ctive).
void	undeleteClient(java.lang.Long clientID) Przywraca skasowanego klienta (ustawia status [A]ctive).
void	undeleteRotator(java.lang.Long rotatorID) Przywraca skasowany rotator (ustawia status [A]ctive).
void	updateAd(java.lang.Long adID, java.lang.Long rotatorID, java.lang.Long clientID, java.lang.Long weight, java.util.Date expired, java.lang.Long maxViewCount, java.lang.String targetLink, java.lang.String caption, java.lang.String description) Aktualizuje dane reklamy.
void	updateClient(java.lang.Long clientID, java.lang.String name, java.lang.String address, java.lang.String city, java.lang.String country, java.lang.String phone, java.lang.String email, java.lang.String identifier, java.lang.String description) Aktualizuje dane klienta.
void	updateRotator(java.lang.Long rotatorID, java.lang.String name, java.lang.String type, java.lang.String description) Aktualizuje dane rotatora.

Methods inherited from class palio.modules.core.Module

getConfigParam, getDescription, getModuleTranslation

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Ads

public Ads(Instance instance,
           java.util.Properties parameters)
    throws palio.PalioException

Throws:

palio.PalioException

Method Detail

getVersion

public java.lang.String getVersion()

Description copied from class: Module

Returns the module version

Specified by:

getVersion in class Module

createRotator

public java.lang.Long createRotator(java.lang.String name,
                                    java.lang.String type,
                                    java.lang.String description)
                             throws palio.PalioException

Tworzy nowy rotator reklam (grupa reklam z określoną polityką wyświetlania). Jeżeli zostanie podana wartość type inna niż "S" lub "D" to funkcja wyrzuci wyjątek "unknown type". Jeżeli rotator o podanej nazwie istnieje (nawet jeżeli ma status [D]elete) to funkcja wyrzuci wyjątek "rotator exists". Nowy rotator jest tworzony ze statusem [A]ctive.

Parameters:

name - nazwa dla rotatora

type - typ rotatora: "S" lub "D"

description - dodatkowy opis rotatora

Returns:

identyfikator nowego rotatora

Throws:

palio.PalioException

getRotator

public java.lang.Object[] getRotator(java.lang.Long rotatorID)
                              throws palio.PalioException

Zwraca dane rotatora w postaci tablicy z wartościami pól: [identyfikator, status, typ, nazwa, data utworzenia, data zablokowania, opis]. Statusy: [A]ctive, [B]Blocked.

Throws:

palio.PalioException

getRotator

public java.lang.Object[] getRotator(java.lang.String rotatorName)
                              throws palio.PalioException

Zwraca dane rotatora w postaci tablicy z wartościami pól: [identyfikator, status, typ, nazwa, data utworzenia, data zablokowania, opis]. Statusy: [A]ctive, [B]Blocked.

Throws:

palio.PalioException

getRotators

public java.util.LinkedList getRotators()
                                 throws palio.PalioException

Zwraca listę wszystkich rotatorów. Każdy element listy to tablica z wartościami pól: [identyfikator, status, typ, nazwa, data utworzenia, data zablokowania, opis]. Statusy: [A]ctive, [B]Blocked.

Throws:

palio.PalioException

blockRotator

public void blockRotator(java.lang.Long rotatorID)
                  throws palio.PalioException

Blokuje aktywny rotator przez ustawienie statusu [B]locked.

Parameters:

rotatorID - identyfikator rotatora

Throws:

palio.PalioException

activateRotator

public void activateRotator(java.lang.Long rotatorID)
                     throws palio.PalioException

Aktywuje zablokowany rotator przez ustawienie statusu [A]ctive.

Parameters:

rotatorID - identyfikator rotatora

Throws:

palio.PalioException

updateRotator

public void updateRotator(java.lang.Long rotatorID,
                          java.lang.String name,
                          java.lang.String type,
                          java.lang.String description)
                   throws palio.PalioException

Aktualizuje dane rotatora. Jeżeli zostanie podana wartość type inna niż "S" lub "D" to funkcja wyrzuci wyjątek "unknown type". Jeżeli istnieje inny rotator o podanej nazwie (nawet jeżeli ma status [D]elete) to funkcja wyrzuci wyjątek "rotator exists". Funkcja nie aktualizuje rotatorów ze statusem [D]eleted.

Parameters:

rotatorID - identyfikator rotatora

name - nowa nazwa rotatora

type - nowy typ rotatora: "S" lub "D"

description - nowy opis rotatora

Throws:

palio.PalioException

deleteRotator

public void deleteRotator(java.lang.Long rotatorID)
                   throws palio.PalioException

Kasuje rotator wraz ze wszystkimi podpiętymi do niego reklamami (ustawia status [D]eleted).

Throws:

palio.PalioException

undeleteRotator

public void undeleteRotator(java.lang.Long rotatorID)
                     throws palio.PalioException

Przywraca skasowany rotator (ustawia status [A]ctive). Reklamy podpięte do rotatora nie są aktywowane. Generalnie taka funkcja powinna być użyta w ostateczności, tylko wtedy, gdy koniecznie musimy mieć możliwość używania rotatora o takiej samej nazwie jak rotator skasowany.

Throws:

palio.PalioException

rotatorURL

public java.lang.Object[] rotatorURL(java.lang.Long rotatorID)
                              throws palio.PalioException

Zwraca komplet linków (dwuelementowa tablica) do danego rotatora reklam, z którego pierwszy element używamy do wyświetlenia reklamy (atrybut SRC) a drugi do kliknięcia na reklamie (atrybut HREF). Wyszukiwanie odpowiedniej reklamy odbywa się dopiero wewnątrz serwletu, czyli podczas generowania strony nie wiadomo jaka zostanie wyświetlona reklama. Dodatkowo, jeżeli rotator nie będzie miał żadnej reklamy do wyświetlenia to pojawi się w przeglądarce ikona "złamanego obrazka", bo tag IMG tak czy innaczej trzeba wygenerować.
Przykład użycia:

 $=(AdURL, $ads.rotatorURL(1))
 <a href='$AdURL[1]'><img src='$AdURL[0]'></a>
 

Throws:

palio.PalioException

rotatorURL

public java.lang.Object[] rotatorURL(java.lang.String rotatorName)
                              throws palio.PalioException

Zwraca URL do danego rotatora reklam.

Throws:

palio.PalioException

adURL

public java.lang.Object[] adURL(java.lang.Long rotatorID,
                                java.lang.Object[] adFields)
                         throws palio.PalioException

Zwraca komplet linków do danej reklamy. Pierwszy element zwracanej tablicy używamy do wyświetlenia reklamy (atrybut SRC) a drugi do kliknięcia na reklamie (atrybut HREF). Następne elementy zależnie od podanych parametrów. Wyszukiwanie odpowiedniej reklamy odbywa się w momencie wywołania funkcji.
Dodatkowe pola jakie można wyciągnąć na temat reklamy:

• ID - identyfikator
• STATUS - aktualny status
• CREATED - data utworzenia
• LAST_OPENED - data ostatniego wejścia (kliknięcia)
• LAST_VIEWED - data ostatniego wyświetlenia
• WEIGHT - waga
• OPEN_COUNT - całkowita ilość otwarć
• VIEW_COUNT - ilość wyświetleń
• ALL_VIEW_COUNT - całkowita ilość wyświetleń
• MAX_VIEW_COUNT - maksymalna ilość wyświetleń do zablokowania (sprawdzane z VIEW_COUNT)
• BLOCKED - data ostatniego zablokowania
• DELETED - data skasowania
• EXPIRED - data wygaśnięcia
• TARGET_LINK - link docelowy
• CAPTION - podpis
• DESCRIPTION - dodatkowy opis
• CLIENT_ID - identyfikator klienta

Przykład użycia:

 $=(AdURL, $ads.adURL(1, [CAPTION]))
 <a href='$AdURL[1]'><img src='$AdURL[0]' alt='$AdURL[2]'></a>
 

Parameters:

rotatorID - identyfikator rotatora

adFields - dodatkowe pola dotyczące reklamy jakie chcemy wyciągnąć z tabeli AD_ADS

Returns:

tablica z wynikami

Throws:

palio.PalioException - rzucane wyjątki: "no such rotator", "unknown rotator type"

createClient

public java.lang.Long createClient(java.lang.String name,
                                   java.lang.String address,
                                   java.lang.String city,
                                   java.lang.String country,
                                   java.lang.String phone,
                                   java.lang.String email,
                                   java.lang.String identifier,
                                   java.lang.String description)
                            throws palio.PalioException

Tworzy nowego klienta (właściciela reklam). Jeżeli klient o podanej nazwie istnieje (nawet jeżeli ma status [D]elete) to funkcja wyrzuci wyjątek "client exists". Nowy klient jest tworzony ze statusem [A]ctive.

Parameters:

name - nazwa klienta

address - adres klienta

city - miasto klienta

country - kraj klienta

phone - numer telefonu klienta

email - adres email klienta

identifier - dodatkowy identyfikator klienta

description - dodatkowy opis klienta

Returns:

identyfikator nowego klienta

Throws:

palio.PalioException

getClient

public java.lang.Object[] getClient(java.lang.Long clientID)
                             throws palio.PalioException

Zwraca dane klienta w postaci tablicy z wartościami pól: [identyfikator, status, nazwa, data utworzenia, data zablokowania, adres, miasto, kraj, numer telefonu, adres email, dodatkowy identyfikator, opis]. Statusy: [A]ctive, [B]Blocked.

Throws:

palio.PalioException

getClient

public java.lang.Object[] getClient(java.lang.String clientName)
                             throws palio.PalioException

Zwraca dane klienta w postaci tablicy z wartościami pól: [identyfikator, status, nazwa, data utworzenia, data zablokowania, adres, miasto, kraj, numer telefonu, adres email, dodatkowy identyfikator, opis]. Statusy: [A]ctive, [B]Blocked.

Throws:

palio.PalioException

getClients

public java.util.LinkedList getClients()
                                throws palio.PalioException

Zwraca listę wszystkich klientów. Każdy element listy to tablica z wartościami pól: [identyfikator, status, nazwa, data utworzenia, data zablokowania, adres, miasto, kraj, numer telefonu, adres email, dodatkowy identyfikator, opis]. Statusy: [A]ctive, [B]Blocked.

Throws:

palio.PalioException

blockClient

public void blockClient(java.lang.Long clientID)
                 throws palio.PalioException

Blokuje aktywnego klienta przez ustawienie statusu [B]locked.

Parameters:

clientID - identyfikator klienta

Throws:

palio.PalioException

activateClient

public void activateClient(java.lang.Long clientID)
                    throws palio.PalioException

Aktywuje zablokowanego klienta przez ustawienie statusu [A]ctive.

Parameters:

clientID - identyfikator klienta

Throws:

palio.PalioException

updateClient

public void updateClient(java.lang.Long clientID,
                         java.lang.String name,
                         java.lang.String address,
                         java.lang.String city,
                         java.lang.String country,
                         java.lang.String phone,
                         java.lang.String email,
                         java.lang.String identifier,
                         java.lang.String description)
                  throws palio.PalioException

Aktualizuje dane klienta. Jeżeli istnieje inny klient o podanej nazwie (nawet jeżeli ma status [D]elete) to funkcja wyrzuci wyjątek "client exists". Funkcja nie aktualizuje klientów ze statusem [D]eleted.

Parameters:

clientID - identyfikator klienta

name - nowa nazwa klienta

description - nowy opis klienta

Throws:

palio.PalioException

deleteClient

public void deleteClient(java.lang.Long clientID)
                  throws palio.PalioException

Kasuje klienta wraz ze wszystkimi jego reklamami (ustawia status [D]eleted).

Throws:

palio.PalioException

undeleteClient

public void undeleteClient(java.lang.Long clientID)
                    throws palio.PalioException

Przywraca skasowanego klienta (ustawia status [A]ctive). Reklamy klienta nie są aktywowane. Generalnie taka funkcja powinna być użyta w ostateczności, tylko wtedy, gdy koniecznie musimy mieć możliwość używania klienta o takiej samej nazwie jak klient skasowany.

Throws:

palio.PalioException

createAd

public java.lang.Long createAd(java.lang.Long rotatorID,
                               java.lang.Long clientID,
                               java.lang.String banner,
                               java.lang.Long weight,
                               java.util.Date expired,
                               java.lang.Long maxViewCount,
                               java.lang.String targetLink,
                               java.lang.String caption,
                               java.lang.String description)
                        throws palio.PalioException,
                               java.io.IOException

Tworzy nową reklamę. Plik reklamy (banner, np.: obrazek) zostanie wczytany do tabeli AD_MEDIA. Jeżeli nie ma rotatora (ze statusem [A]ctive lub [B]locked) o podanym identyfikatorze to funkcja wyrzuci wyjątek " no rotator". Jeżeli nie ma klienta (ze statusem [A]ctive lub [B]locked) o podanym identyfikatorze to funkcja wyrzuci wyjątek " no client". Nowa reklama jest tworzona ze statusem [A]ctive. Jeżeli po parametrze bannernie da się dotrzeć do żadnego pliku to funkcja rzuca wyjątek "banner not found".

Parameters:

rotatorID - identyfikator rotatora

clientID - identyfikator klienta

banner - URL (bezwzględny, np: "http://xyz.com/plik.jpg") lub ścieżka do pliku reklamy

weight - waga z jaką będzie losowana reklama (jeżeli należy do rotatora używającego wag)

expired - data wygaśnięcia aktywności reklamy (po tej dacie reklama zostanie zablokowana)

maxViewCount - maksymalna liczba odsłon reklamy (po osiągnięciu ilości odsłon reklama zostanie zablokowana)

targetLink - link do którego prowadzi reklama

caption - krótki opis, np.: do znacznika ALT w tagu IMG

description - dodatkowy opis reklamy

Returns:

identyfikator nowej reklamy

Throws:

palio.PalioException

java.io.IOException

createAd

public java.lang.Long createAd(java.lang.Long rotatorID,
                               java.lang.Long clientID,
                               java.lang.Object[] fileBanner,
                               java.lang.Long weight,
                               java.util.Date expired,
                               java.lang.Long maxViewCount,
                               java.lang.String targetLink,
                               java.lang.String caption,
                               java.lang.String description)
                        throws palio.PalioException

Tworzy nową reklamę. Plik reklamy (banner, np.: obrazek) zostanie wczytany do tabeli AD_MEDIA. Jeżeli nie ma rotatora (ze statusem [A]ctive lub [B]locked) o podanym identyfikatorze to funkcja wyrzuci wyjątek " no rotator". Jeżeli nie ma klienta (ze statusem [A]ctive lub [B]locked) o podanym identyfikatorze to funkcja wyrzuci wyjątek " no client". Nowa reklama jest tworzona ze statusem [A]ctive.

Parameters:

rotatorID - identyfikator rotatora

clientID - identyfikator klienta

fileBanner - plik reklamy w postaci tablicy Object[] - takiej jaką się otrzymuje z formularza z pola uploadField

weight - waga z jaką będzie losowana reklama (jeżeli należy do rotatora używającego wag)

expired - data wygaśnięcia aktywności reklamy (po tej dacie reklama zostanie zablokowana)

maxViewCount - maksymalna liczba odsłon reklamy (po osiągnięciu ilości odsłon reklama zostanie zablokowana)

targetLink - link do którego prowadzi reklama

caption - krótki opis, np.: do znacznika ALT w tagu IMG

description - dodatkowy opis reklamy

Returns:

identyfikator nowej reklamy

Throws:

palio.PalioException

getAd

public java.lang.Object[] getAd(java.lang.Long adID)
                         throws palio.PalioException

Zwraca dane reklamy w postaci tablicy z wartościami pól: [identyfikator, status, nazwa rotatora, nazwa klienta, data utworzenia, data ostatniej odsłony, waga, ilość wyświetleń, całkowita ilość wyświetleń, maksymalna ilość wyświetleń, data ostatniego kliknięcia, liczba kliknięć, data zablokowania, data wygaśnięcia, adres docelowy, podpis, opis]. Statusy: [A]ctive, [B]Blocked.

Throws:

palio.PalioException

getAds

public java.util.LinkedList getAds()
                            throws palio.PalioException

Zwraca listę wszystkich reklam. Każdy element listy to tablica z wartościami pól: [identyfikator, status, nazwa rotatora, nazwa klienta, data utworzenia, data ostatniej odsłony, waga, ilość wyświetleń, całkowita ilość wyświetleń, maksymalna ilość wyświetleń, data ostatniego kliknięcia, liczba kliknięć, data zablokowania, data wygaśnięcia, adres docelowy, podpis, opis]. Statusy: [A]ctive, [B]Blocked.

Throws:

palio.PalioException

getAds

public java.util.LinkedList getAds(java.lang.Long rotatorID,
                                   java.lang.Long clientID)
                            throws palio.PalioException

Zwraca listę reklam przypisanych do podanego rotatora i/lub klienta. Każdy element listy to tablica z wartościami pól: [identyfikator, status, nazwa rotatora, nazwa klienta, data utworzenia, data ostatniej odsłony, waga, ilość wyświetleń, całkowita ilość wyświetleń, maksymalna ilość wyświetleń, data ostatniego kliknięcia, liczba kliknięć, data zablokowania, data wygaśnięcia, adres docelowy, podpis, opis]. Statusy: [A]ctive, [B]Blocked.

Throws:

palio.PalioException

blockAd

public void blockAd(java.lang.Long adID)
             throws palio.PalioException

Blokuje aktywną reklamę przez ustawienie statusu [B]locked.

Parameters:

adID - identyfikator reklamy

Throws:

palio.PalioException

activateAd

public void activateAd(java.lang.Long adID)
                throws palio.PalioException

Aktywuje zablokowaną reklamę przez ustawienie statusu [A]ctive.

Parameters:

adID - identyfikator reklamy

Throws:

palio.PalioException

updateAd

public void updateAd(java.lang.Long adID,
                     java.lang.Long rotatorID,
                     java.lang.Long clientID,
                     java.lang.Long weight,
                     java.util.Date expired,
                     java.lang.Long maxViewCount,
                     java.lang.String targetLink,
                     java.lang.String caption,
                     java.lang.String description)
              throws palio.PalioException

Aktualizuje dane reklamy.

Parameters:

rotatorID - identyfikator rotatora

clientID - identyfikator klienta

weight - waga z jaką będzie losowana reklama (jeżeli należy do rotatora używającego wag)

expired - data wygaśnięcia aktywności reklamy (po tej dacie reklama zostanie zablokowana)

maxViewCount - maksymalna liczba odsłon reklamy (po osiągnięciu ilości odsłon reklama zostanie zablokowana)

targetLink - link do którego prowadzi reklama

caption - krótki opis, np.: do znacznika ALT w tagu IMG

description - dodatkowy opis reklamy

Throws:

palio.PalioException

deleteAd

public void deleteAd(java.lang.Long adID)
              throws palio.PalioException

Kasuje reklamę (ustawia status [D]eleted).

Throws:

palio.PalioException

undeleteAd

public void undeleteAd(java.lang.Long adID)
                throws palio.PalioException

Przywraca skasowaną reklamę (ustawia status [A]ctive).

Throws:

palio.PalioException

adStats

public java.lang.Object[] adStats(java.lang.Long adID)
                           throws palio.PalioException

Zwraca proste statystyki odsłon i kliknięć na daną reklamę. Funkcja jest szybsza niż odpowiednia wersja z podanymi datami od-do.

Parameters:

adID - identyfikator reklamy

Returns:

tablica [całkowita ilość odsłon, data ostatniej odsłony, całkowita ilość kliknięć, data ostatniego kliknięcia]

Throws:

palio.PalioException

adStats

public java.lang.Object[] adStats(java.lang.Long adID,
                                  java.util.Date dateFrom,
                                  java.util.Date dateTo)
                           throws palio.PalioException

Zwraca proste statystyki odsłon i kliknięć na daną reklamę.

Parameters:

adID - identyfikator reklamy

dateFrom - statystyki od podanej daty (może być null)

dateTo - statystyki do podanej daty (może być null)

Returns:

tablica [całkowita ilość odsłon, data ostatniej odsłony, całkowita ilość kliknięć, data ostatniego kliknięcia]

Throws:

palio.PalioException

clientStats

public java.util.LinkedList clientStats(java.lang.Long clientID)
                                 throws palio.PalioException

Zwraca proste statystyki odsłon i kliknięć na reklamy danego klienta. Funkcja jest szybsza niż odpowiednia wersja z podanymi datami od-do.

Parameters:

clientID - identyfikator klienta

Returns:

tablica [całkowita ilość odsłon, data ostatniej odsłony, całkowita ilość kliknięć, data ostatniego kliknięcia, identyfikator reklamy]

Throws:

palio.PalioException

clientStats

public java.util.LinkedList clientStats(java.lang.Long clientID,
                                        java.util.Date dateFrom,
                                        java.util.Date dateTo)
                                 throws palio.PalioException

Zwraca proste statystyki odsłon i kliknięć na reklamy danego klienta. Każdy element listy z wynikami to tablica z następującymi danymi: [całkowita ilość odsłon, data ostatniej odsłony, całkowita ilość kliknięć, data ostatniego kliknięcia, identyfikator reklamy]

Parameters:

clientID - identyfikator klienta

dateFrom - statystyki od podanej daty (może być null)

dateTo - statystyki do podanej daty (może być null)

Returns:

lista wyników

Throws:

palio.PalioException

rotatorStats

public java.util.LinkedList rotatorStats(java.lang.Long rotatorID)
                                  throws palio.PalioException

Zwraca proste statystyki odsłon i kliknięć na reklamy w danym rotatorze. Funkcja jest szybsza niż odpowiednia wersja z podanymi datami od-do.

Parameters:

rotatorID - identyfikator rotatora

Returns:

tablica [całkowita ilość odsłon, data ostatniej odsłony, całkowita ilość kliknięć, data ostatniego kliknięcia, identyfikator reklamy]

Throws:

palio.PalioException

rotatorStats

public java.util.LinkedList rotatorStats(java.lang.Long rotatorID,
                                         java.util.Date dateFrom,
                                         java.util.Date dateTo)
                                  throws palio.PalioException

Zwraca proste statystyki odsłon i kliknięć na reklamy z danego rotatora. Każdy element listy z wynikami to tablica z następującymi danymi: [całkowita ilość odsłon, data ostatniej odsłony, całkowita ilość kliknięć, data ostatniego kliknięcia, identyfikator reklamy]

Parameters:

rotatorID - identyfikator rotatora

dateFrom - statystyki od podanej daty (może być null)

dateTo - statystyki do podanej daty (może być null)

Returns:

lista wyników

Throws:

palio.PalioException

adHistory

public java.util.LinkedList adHistory(java.lang.Long adID,
                                      java.util.Date dateFrom,
                                      java.util.Date dateTo)
                               throws palio.PalioException

Zwraca historię odsłon i kliknięć na daną reklamę. Każdy element listy z wynikami to tablica z następującymi danymi: [data odsłony, data kliknięcia, numer IP odbiorcy reklamy]

Parameters:

adID - identyfikator reklamy

dateFrom - historia od podanej daty (może być null)

dateTo - historia do podanej daty (może być null)

Returns:

lista wyników

Throws:

palio.PalioException