GetSumList

CDBResult
CTraffic::GetSumList(
 string data_type,
 array filter = array(),
)

The method GetSumList returns the number of hits, hosts, sessions, visitors, events on hourly, daily or monthly basis.

Parameters

Parameter	Description
data_type	Data type. Possible values: hour - return data on hourly basis; weekday - on daily basis; month - on monthly basis.
filter	Array used to filter the resulting list. The following keys can be used in the array: SITE_ID - the ID of the site whose statistics is to be obtained; DATE1 - starting date; DATE2 - ending date.

Structure of the returned record

The structure of the returned record varies depending on the data_type parameter value.

when (data_type is hour):

Array
(
    [HOUR_HOST_0] => host count from 0:00 till 1:00
    ...
    [HOUR_HOST_23] => host count from 23:00 till 00:00

    [HOUR_SESSION_0] => session count from 00:00 till 01:00
    ...
    [HOUR_SESSION_23] => session count from 23:00 till 0:00
    
    [HOUR_HIT_0] => hit count from 0:00 till 1:00
    ...
    [HOUR_HIT_23] => hit count from 23:00 till 0:00
    
    [HOUR_EVENT_0] => event count from 0:00 till 1:00
    ...
    [HOUR_EVENT_23] => event count from 23:00 till 0:00
    
    [HOUR_GUEST_0] => visitor count from 0:00 till 1:00
    ...
    [HOUR_GUEST_23] => visitor count from 23:00 till 0:00
    
    [HOUR_NEW_GUEST_0] => new visitor count from 0:00 till 1:00
    ...
    [HOUR_NEW_GUEST_23] => new visitor count from 23:00 till 0:00
        
    [HOUR_FAVORITE_0] => number of new visitors who
                         added to Favorites, from 0:00 till 1:00
    ...
    [HOUR_FAVORITE_23] => number of new visitors who
                          added to Favorites, from 23:00 till 0:00
)

when data_type is weekday:

Array
(
    [WEEKDAY_HOST_0] => number of Sunday's hosts
    [WEEKDAY_HOST_1] => number of Monday's hosts
    ...
    [WEEKDAY_HOST_6] => number of Saturday's hosts

    [WEEKDAY_SESSION_0] => number of Sunday's sessions
    [WEEKDAY_SESSION_1] => number of Monday's sessions
    ...
    [WEEKDAY_SESSION_6] => number of Saturday's sessions

    [WEEKDAY_HIT_0] => number of Sunday's hits
    [WEEKDAY_HIT_1] => number of Monday's hits
    ...
    [WEEKDAY_HIT_6] => number of Saturday's hits

    [WEEKDAY_EVENT_0] => number of Sunday's events
    [WEEKDAY_EVENT_1] => number of Monday's events
    ...
    [WEEKDAY_EVENT_6] => number of Saturday's events

    [WEEKDAY_GUEST_0] => number of Sunday's visitors
    [WEEKDAY_GUEST_1] => number of Monday's visitors
    ...
    [WEEKDAY_GUEST_6] => number of Saturday's visitors

    [WEEKDAY_NEW_GUEST_0] => number of Sunday's new visitors
    [WEEKDAY_NEW_GUEST_1] => number of Monday's new visitors
    ...
    [WEEKDAY_NEW_GUEST_6] => number of Saturday's new visitors

    [WEEKDAY_FAVORITE_0] => number of Sunday's visitors
                            who added the site to Favorites
    [WEEKDAY_FAVORITE_1] => Monday's visitors
    ...
    [WEEKDAY_FAVORITE_6] => Saturday's visitors
)

when data_type is month:

Array
(
    [MONTH_HOST_1] => number of January's hosts
    ...
    [MONTH_HOST_12] => number of December's hosts
    
    [MONTH_SESSION_1] => number of January's sessions
    ...
    [MONTH_SESSION_12] => number of December's sessions

    [MONTH_HIT_1] => number of January's hits
    ...
    [MONTH_HIT_12] => number of December's hits

    [MONTH_EVENT_1] => number of January's events
    ...
    [MONTH_EVENT_12] => number of December's events

    [MONTH_GUEST_1] => number of January's visitors
    ...
    [MONTH_GUEST_12] => number of December's visitors

    [MONTH_NEW_GUEST_1] => number of January's new visitors
    ...
    [MONTH_NEW_GUEST_12] => number of December's new visitors

    [MONTH_FAVORITE_1] => number of January's visitors
                          who added to Favorites
    ...
    [MONTH_FAVORITE_12] => number of December's visitors
                           who added to Favorites
)

Example


<?
// obtain information on daily traffic
$rs = CTraffic::GetSumList("weekday");
$ar = $rs->Fetch();
for ($i=0; $i<=6; $i++)
{
    switch($i)
    {
        case 0: echo "sun"; break;
        case 1: echo "mon"; break;
        case 2: echo "tue"; break;
        case 3: echo "wed"; break;
        case 4: echo "thu"; break;
        case 5: echo "fri"; break;
        case 6: echo "sat"; break;
    }
    echo "<br>";
    echo "hosts: ".$ar["WEEKDAY_HOST_".$i]."<br>";
    echo "sessions: ".$ar["WEEKDAY_SESSION_".$i]."<br>";
    echo "hits: ".$ar["WEEKDAY_HIT_".$i]."<br>";
    echo "visitors: ".$ar["WEEKDAY_GUEST_".$i]."<br>";
    echo "new visitors: ".$ar["WEEKDAY_NEW_GUEST_".$i]."<br>";
    echo "<br><br>";
}
?>

CTraffic::GetSumList

Parameters

Structure of the returned record

See Also

Example