
Progress Stats
GetProgressStats [finished]
Overlays:
Activation:
GetProgressStats.php ? sessionID = ... & dimensionIDs = ... & indicatorIDs = ... & campaignIDs = ...
[ & placementIDs = ... ]
[ & orderIDs = ... ]
[ & withPlacementRoots = ... ]
[ & placementPrintMode = ... ]
[ & timeDivision = ... ]
[ & recursiveGoals = ... ]
[ & timeUnits = ... ]
[ & showNames = ... ]
[ & humanDates = ... ]
[ & indicatorNames = ... ]
[ & sortIndicatorIDs = ... & indicatorSortOrders = ... ]
[ & limit = ... ]
[ & offset = ... ]
Description:
Returns progress and goal statistics for given campaigns.
Output format may vary depending on the input parameters.
Available dimension intersections are:
- campaign,
- placement,
- order,
- placement × order.
See Indicators->GetIndicatorDimensionsList.
Indicators from groups progress, basicGeneral and basicNonGeneral
are available for this command. See Indicators->GetIndicatorsList.
- *Progress - percentage, non negative real number, 1.0 means 100%.
- *Goal - set for placement, order or campaign
Publishers do not see statistics for placement nodes.
Parameters:
- sessionID: string(16)
- dimensionIDs: uint list - list of indicator dimensions to intersect, they will appear in output
- indicatorIDs: uint list - list of indicators (only progress, goal and basic indicators are allowed)
- campaignIDs: uint list - max 40 campaigns
- placementIDs: uint list - filter for specific placements
- orderIDs: uint list - filter for specific orders
- withPlacementRoots: enum('Y',N') default 'Y' - show records for campaign root placements
- placementPrintMode: enum('all','nodes','leaves') default 'all' - whether to show placements, folders or either placements and folders in output
- timeDivision: enum('General', 'Month', 'Week', 'Day', 'Hour') - name of a time period for which statistics will be displayed
- recursiveGoals: enum('Y','N') - for objects with no goals defined, compute them recursively, enabled by default
- timeUnits: timeunit list
- showNames: enum('Y','N') default 'N' - if enabled, names of objects in the result will be printed
- humanDates: enum('Y','N') default 'N'
- indicatorNames: enum('Y','N') default 'Y' - if enabled, statistic value will be surrounded by XML tag containing indicator name. Otherwise, tag will be named using indicator id (e.g. <indicatorID_3>34</indicatorID_3>).
- sortIndicatorIDs: uint list - list of indicators, that will be used to sort records, must be subset of indicatorIDs
- indicatorSortOrders: enum('asc','desc') list - orders of indicator sorting, list must have the same length as sortIndicatorIDs
- limit: uint - limits result to given number of records
- offset: uint - skips given number of records
Results:
<GetProgressStats>
<status>OK</status>
<statisticsNumber>23</statisticsNumber> : uint - all records number (if there were no limit and offset)
<statistics>
<statisticsRecord>
<campaignID>14771</campaignID> : uint
<orderID>11258</orderID> : uint
<placementID>4005331</placementID> : uint
<periodName>General</periodName> : string
<clicks>10634</clicks> : nullable float - statistic value
<actionsProgress>0.000333</actionsProgress> : nullable float - statistic value
</statisticsRecord>
</statistics>
</GetProgressStats>