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

cpanm WebService::Eulerian::Analytics

perl -MCPAN -e shell
install WebService::Eulerian::Analytics