/**
* This method returns daily statistics for a zone for a specified period.
*
* @access public
*
* @param integer $zoneId The ID of the zone to view statistics
* @param date $oStartDate The date from which to get statistics (inclusive)
* @param date $oEndDate The date to which to get statistics (inclusive)
* @param bool $localTZ Should stats be using the manager TZ or UTC?
* @param array $rsStatisticsData The data returned by the function
* <ul>
* <li><b>advertiser ID integer</b> The ID of the advertiser
* <li><b>advertiserName string (255)</b> The name of the advertiser
* <li><b>requests integer</b> The number of requests for the advertiser
* <li><b>impressions integer</b> The number of impressions for the advertiser
* <li><b>clicks integer</b> The number of clicks for the advertiser
* <li>a<b>revenue decimal</b> The revenue earned for the advertiser
* </ul>
*
* @return boolean True if the operation was successful and false if not.
*
*/
function getZoneAdvertiserStatistics($zoneId, $oStartDate, $oEndDate, $localTZ, &$rsStatisticsData)
{
if (!$this->checkStatisticsPermissions($zoneId)) {
return false;
}
if ($this->_validateForStatistics($zoneId, $oStartDate, $oEndDate)) {
$dalZone = new OA_Dal_Statistics_Zone();
$rsStatisticsData = $dalZone->getZoneAdvertiserStatistics($zoneId, $oStartDate, $oEndDate, $localTZ);
return true;
} else {
return false;
}
}
/**
* Test zone advertiser statistics.
*
*/
function testGetZoneAdvertiserStatistics()
{
$doAgency = OA_Dal::factoryDO('agency');
$doAdvertiser = OA_Dal::factoryDO('clients');
$doCampaign = OA_Dal::factoryDO('campaigns');
$doBanner1 = OA_Dal::factoryDO('banners');
$this->generateBannerWithParents($doAgency, $doAdvertiser, $doCampaign, $doBanner1);
$advertiserId1 = $doAdvertiser->clientid;
$doAgency = OA_Dal::factoryDO('agency');
$doAdvertiser = OA_Dal::factoryDO('clients');
$doCampaign = OA_Dal::factoryDO('campaigns');
$doBanner2 = OA_Dal::factoryDO('banners');
$this->generateBannerWithParents($doAgency, $doAdvertiser, $doCampaign, $doBanner2);
$doAgency = OA_Dal::factoryDO('agency');
$doPublisher = OA_Dal::factoryDO('affiliates');
$doZone = OA_Dal::factoryDO('zones');
$this->generateZoneWithParents($doAgency, $doPublisher, $doZone);
$doDataSummaryAdHourly = OA_Dal::factoryDO('data_summary_ad_hourly');
$doDataSummaryAdHourly->impressions = 31;
$doDataSummaryAdHourly->requests = 32;
$doDataSummaryAdHourly->total_revenue = 33;
$doDataSummaryAdHourly->clicks = 34;
$doDataSummaryAdHourly->date_time = '1984-03-04';
$this->generateDataSummaryAdHourlyForBannerAndZone($doDataSummaryAdHourly, $doBanner1, $doZone);
$doDataSummaryAdHourly = OA_Dal::factoryDO('data_summary_ad_hourly');
$doDataSummaryAdHourly->impressions = 10;
$doDataSummaryAdHourly->requests = 20;
$doDataSummaryAdHourly->total_revenue = 30;
$doDataSummaryAdHourly->clicks = 40;
$doDataSummaryAdHourly->date_time = '2007-04-14';
$this->generateDataSummaryAdHourlyForBannerAndZone($doDataSummaryAdHourly, $doBanner1, $doZone);
$doDataSummaryAdHourly = OA_Dal::factoryDO('data_summary_ad_hourly');
$doDataSummaryAdHourly->impressions = 10;
$doDataSummaryAdHourly->requests = 20;
$doDataSummaryAdHourly->total_revenue = 30;
$doDataSummaryAdHourly->clicks = 40;
$doDataSummaryAdHourly->date_time = '2000-04-14';
$this->generateDataSummaryAdHourlyForBannerAndZone($doDataSummaryAdHourly, $doBanner2, $doZone);
// 1. Get data existing range
$rsZoneStatistics = $this->_dalZoneStatistics->getZoneAdvertiserStatistics($doZone->zoneid, new Date('1984-01-01'), new Date('2007-10-18'));
$rsZoneStatistics->find();
$this->assertTrue($rsZoneStatistics->getRowCount() == 2, 'Some records should be returned');
$rsZoneStatistics->fetch();
$aRow1 = $rsZoneStatistics->toArray();
$rsZoneStatistics->fetch();
$aRow2 = $rsZoneStatistics->toArray();
$this->ensureRowSequence($aRow1, $aRow2, 'advertiserid', $advertiserId1);
// 2. Check return fields names
$this->assertFieldExists($aRow1, 'advertiserid');
$this->assertFieldExists($aRow1, 'advertisername');
$this->assertFieldExists($aRow1, 'requests');
$this->assertFieldExists($aRow1, 'impressions');
$this->assertFieldExists($aRow1, 'clicks');
$this->assertFieldExists($aRow1, 'revenue');
// 3. Check return fields value
$this->assertFieldEqual($aRow1, 'impressions', 41);
$this->assertFieldEqual($aRow1, 'requests', 52);
$this->assertFieldEqual($aRow1, 'revenue', 63);
$this->assertFieldEqual($aRow1, 'clicks', 74);
$this->assertFieldEqual($aRow2, 'impressions', 10);
$this->assertFieldEqual($aRow2, 'requests', 20);
$this->assertFieldEqual($aRow2, 'revenue', 30);
$this->assertFieldEqual($aRow2, 'clicks', 40);
// 4. Get data in not existing range
$rsZoneStatistics = $this->_dalZoneStatistics->getZoneAdvertiserStatistics($doZone->zoneid, new Date('2007-09-21'), new Date('2007-09-21'));
$rsZoneStatistics->find();
$this->assertTrue($rsZoneStatistics->getRowCount() == 0, 'Recordset should be empty');
// 5. Get data from only 1 advertiser
$rsZoneStatistics = $this->_dalZoneStatistics->getZoneAdvertiserStatistics($doZone->zoneid, new Date('1984-01-01'), new Date('1985-03-09'));
$rsZoneStatistics->find();
$this->assertTrue($rsZoneStatistics->getRowCount() == 1, 'Some records should be returned');
$rsZoneStatistics->fetch();
$aRow = $rsZoneStatistics->toArray();
$this->assertFieldEqual($aRow, 'impressions', 31);
}