Filtered Reports
AddFilteredReport [finished]
Nakładki:
Wywołanie:
AddFilteredReport.php ? sessionID = ... & campaignID = ... & lowerTimeUnit = ... & upperTimeUnit = ... & name = ...
[ & email = ... ]
Opis:
Adds new filtered report (user defined filter for campaign time
used to compute statistics) and assigns ID to it. No more than 1000 filtered reports can be added in hour.
Parametry:
- sessionID: string(16)
- campaignID: uint
- lowerTimeUnit: timeunit - filter start date
- upperTimeUnit: timeunit - filter end date
- name: string(63)
- email: string(255) - used to send notification, that statistics have been calculated
Wynik:
<AddFilteredReport>
<status>OK</status>
<filteredReportID>123</filteredReportID> : uint
</AddFilteredReport >
Zwracane błędy:
DeleteFilteredReport [finished]
Nakładki:
Wywołanie:
DeleteFilteredReport.php ? sessionID = ... & filteredReportID = ...
Opis:
Deletes previously created filtered report.
Parametry:
- sessionID: string(16)
- filteredReportID: uint
Wynik:
<DeleteFilteredReport>
<status>OK</status>
</DeleteFilteredReport>
Zwracane błędy:
GetFilteredReportsList [finished]
Nakładki:
Wywołanie:
GetFilteredReportsList.php ? sessionID = ... & campaignIDs = ...
[ & humanDates = ... ]
Opis:
Returns a list of ordered filtered reports. See AddFilteredReport.
Parametry:
- sessionID: string(16)
- campaignIDs: uint list
- humanDates: enum('Y','N') - default 'N' : when this option is enabled, start and end date are printed in human readable format, otherwise in UNIX Timestamp-like format. To convert timestamp-like format to human readable, one needs to interpret the timestamp in GMT time zone.
Wynik:
<GetFilteredReportsList>
<status>OK</status>
<filteredReportsNumber>1234</filteredReportsNumber> : uint - records number
<filteredReports>
<filteredReport>
<filteredReportID>1</filteredReportID> : uint
<name>rep</name> : string(63)
<email>abc@de.ef</email> : string(255)
<campaignID>123</campaignID> : uint
<campaignName>some campaign</campaignName> : string(255)
<isReady>Y</isReady> : enum('Y', 'N') - are statistics already computed
<lowerTimeUnit>1242123024</lowerTimeUnit> : date/timestamp-like - filter start date
<upperTimeUnit>1242123024</upperTimeUnit> : date/timestamp-like - filter end date
</filteredReport>
</filteredReports>
</GetFilteredReportsList>