Package   Class  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

palio.modules
Class Ads

java.lang.Object
  extended by palio.modules.core.Module
      extended by palio.modules.Ads
All Implemented Interfaces:
palio.Constants, palio.modules.core.CurrentModuleDataKeys
public final class Ads
extends palio.modules.core.Module
implements palio.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(palio.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(palio.Instance instance,
           java.util.Properties parameters)
    throws palio.PalioException
Throws:
palio.PalioException
Method Detail

getVersion

public java.lang.String getVersion()
Description copied from class: palio.modules.core.Module
Returns the module version

Specified by:
getVersion in class palio.modules.core.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: 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
Package   Class  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD