NAME
WebService::Eulerian::Analytics::Website::TPOpedataClick - access to the TPOpedataClick service for a given website
DESCRIPTION
This module allow you to access the TPOpedataClick service, which holds information on all the click generated as outbout traffic.
SYNOPSIS
use WebService::Eulerian::Analytics::Website::TPOpedataClick;
#
my $api = new WebService::Eulerian::Analytics::Website::TPOpedataClick(
apikey => 'THE KEY PROVIDED BY YOUR ACCOUNT MANAGER FOR API ACCESS',
host => 'THE HOST ON WHICH THE API IS HOSTED'
);METHODS
getLogByTPOpeName : return all information on outbound clicks for a given outbound campaign
Note: you can only request data on a day timespan.
input
id of the targetted website
hash reference with the following parameters :
o tpope_name : name of the outbound campaign
o date_from : date from value (dd/mm/yyyy format)
o date_to : date to value (dd/mm/yyyy format) inclusive
o without_channel : provide inbound channel information, optionnal (default: 0), if set to 1 the inbound channel information won't be provided. The response will be faster.
output
array reference containing data on each outbound click
sample
my $ra_log = $api->getLogByTPOpeName($my_website_id, {
tpope_name => 'NAME_OF_TARGETTED_CAMPAIGN',
date_from => 'DD/MM/YYYY',
date_to => 'DD/MM/YYYY',
});
#
if ( $api->fault ) {
die $api->faultstring();
}
#
for ( @{ $ra_log } ) {
print "date ".localtime($_->{epoch})." | IP : ".$_->{ip}." | Channel Information : level0=".$_->{channel_0}." level1=".$_->{channel_1}." level2=".$_->{channel_2}."\n";
}METHODS
getLogByTPMediaName : return all information on outbound clicks for a given outbound media
Note: you can only request data on a day timespan.
input
id of the targetted website
hash reference with the following parameters :
o tpmedia_name : name of the outbound media
o date_from : date from value (dd/mm/yyyy format)
o date_to : date to value (dd/mm/yyyy format) inclusive
o without_channel : provide inbound channel information, optionnal (default: 0), if set to 1 the inbound channel information won't be provided. The response will be faster.
output
array reference containing data on each outbound click
sample
my $ra_log = $api->getLogByTPMediaName($my_website_id, {
tpmedia_name => 'NAME_OF_TARGETTED_TPMEDIA',
date_from => 'DD/MM/YYYY',
date_to => 'DD/MM/YYYY',
});
#
if ( $api->fault ) {
die $api->faultstring();
}
#
for ( @{ $ra_log } ) {
print "date ".localtime($_->{epoch})." | IP : ".$_->{ip}." | Channel Information : level0=".$_->{channel_0}." level1=".$_->{channel_1}." level2=".$_->{channel_2}." | Outbound Campaign : ".$_->{tpope_name}."\n";
}METHODS
getLogByOpeName : return all information on outbound clicks for a given inbound campaign
Note: you can only request data on a day timespan.
input
id of the targetted website
hash reference with the following parameters :
o ope_name : name of the inbound compaign
o date_from : date from value (dd/mm/yyyy format)
o date_to : date to value (dd/mm/yyyy format) inclusive
output
array reference containing data on each outbound click
sample
my $ra_log = $api->getLogByOpeName($my_website_id, {
ope_name => 'NAME_OF_INBOUND_CAMPAIGN',
date_from => 'DD/MM/YYYY',
date_to => 'DD/MM/YYYY',
});
#
if ( $api->fault ) {
die $api->faultstring();
}
#
for ( @{ $ra_log } ) {
print "date ".localtime($_->{epoch})." | IP : ".$_->{ip}." | Outbound Campaign : ".$_->{tpope_name}."\n";
}SEE ALSO
WebService::Eulerian::Analytics
AUTHOR
Mathieu Jondet <mathieu@eulerian.com>
COPYRIGHT
Copyright (c) 2008 Eulerian Technologies Ltd http://www.eulerian.com
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA