This task creates an extract of your box office returns for the reporting company Comscore (formerly Rentrak).
The task's main purpose is to report changes to a film's tier on the Post-Sale Ticket Value Adjustments (PSTVA) form to Comscore. This requires some set up on the PSTVA form, and on this task. Once that setup is complete, Head Office uses this task to report those changes.
Important! You can run this task manually to report box office returns from specific sites and date ranges, but we don't recommend it. This may interfere with data you've sent to Comscore in the past.
Behaviour
This task extracts your box office returns data based on its task and configuration file parameters. The extract is then delivered using the FTP details specified by its configuration file.
You can set up Head Office to report changes to a film's tier on the PSTVA form to Comscore. Head Office uses this task to report those changes, and provides values for the SiteID, FromDate, and ToDate parameters.
Parameters
Set up these parameters in the Vista Schedule Console or Scheduling Wizard.
|
Property |
Description |
Example |
|
Currency |
The Head Office code of the currency that the extract will assign to your return values. |
USD |
|
CircuitName |
The name that Comscore uses to identify your circuit. Contact Comscore if you're not sure what value to use for this parameter. |
Example Cinemas |
|
CircuitID |
The ID that Comscore uses to identify your circuit. Contact Comscore if you're not sure what value to use for this parameter. |
1234 |
|
ExcludeTicketMode |
The tickets to be excluded from Rentrak extracts. NONE - Do not exclude any tickets; all tickets are reported in the Rentrak extract. ZEROPRICED - Exclude only tickets with a sales value of 0. COMPLIMENTARY - Exclude only complientary tickets. ZEROPRICEDANDCOMPS - Exclude both complimentary tickets and and zero-value tickets. ZEROPRICEDCOMP - Exclude only complimentary tickets that also have a sales value of 0. Note: This property is only available in the Head Office task. In Cinema, the same feature is available as an INI file setting. |
NONE |
|
FileLocation |
Destination path for the export file. If not specified, this will default to the location where the Rentrak Export program resides on the fileserver, for example: D:\Vista\VistaUtilities |
D:\Vista\ExportFiles\Rentrak |
|
ExcludeFilmMode |
Determines which films' data are excluded from the extract. You can set up film records to be excluded from hourly, daily, or weekly consolidator extracts. This is done by selecting Exclude from Consolidator Feeds on a film's record. ExcludeFilmMode determines whether the extract is considered hourly, daily, or weekly for exclusion purposes. H = Hourly D = Daily W = Weekly If you leave this parameter empty, film data will only be excluded for films that have All selected under When to Exclude. |
H |
|
SiteID |
Enter one or more site codes to report data from those sites. Leave this parameter empty to report data from all your sites. |
1001|1002|1003 |
|
FromDate |
When a FromDate and ToDate are specified, the task will report box office returns within their date range. Otherwise it reports returns from your previous business date. The FromDate is inclusive, and based off your business dates. Use YYYY/MM/DD format. Note: If you enter a FromDate, you must enter a ToDate. |
2019/10/18 |
|
ToDate |
When a FromDate and ToDate are specified, the task will report box office returns within their date range. Otherwise it reports returns from your previous business date. The ToDate is inclusive, and based off your business dates. Use YYYY/MM/DD format. Note: If you enter a ToDate, you must enter a FromDate. |
2019/10/20 |
|
NumberOfAdmits |
Determines whether session and screen admits are included in the extract. Include = admits are included. Exclude = admits are excluded. |
Include |
|
ReportMovieFormatsSeparate |
Determines whether each sessions' movie format is reported. When enabled, the export will include the format of each session. Y = Report session formats. N = Don't report session formats. |
Y |
Comments
0 comments
Please sign in to leave a comment.