The billing period

The billing period in CityScreen Context is the calendar month.

Closing one means producing the documents the parties reconcile against. The records those documents are built from carry on as they were, and stay available for any other period anyone asks about.

This page is for whoever handles month-end — organization employees in the owner, admin or manager roles.

What closing a period does

Closing a period produces documents.

Every financial transaction and every balance stays as it was. A charge recorded on the 3rd of a month is the same record on the 3rd of the following month, whatever documents have been produced in between.

Whether the invoice built from the document was paid is known when somebody records the payment — see Recording a payment.

Re-running a period is safe. Generating the same report type for the same organization and period again replaces the previous document with a fresh one built from current data.

The monthly run

At the start of each month the platform generates settlement reports for the whole of the previous calendar month.

It works on organizations that had confirmed auction delivery in that month, and produces four documents for each of them. The four are every combination of two distinctions:

  • organization-facing or administrator-facing — the same delivery, addressed to the two parties that have to agree on it;

  • direct or indirect — business the organization sold through its own demand relationships, or business sold through the platform operator’s.

Organizations with programmatic guaranteed campaign delivery in the month get four more in the same combinations, covering the programmatic guaranteed business separately.

The platform operator also gets one consolidated document for the whole month.

Reports on request only

Reports for automated guaranteed campaigns are generated on request. See What gets billed for why automated guaranteed business is accounted for separately.

Reports scoped to a single legal entity are likewise generated on request. The monthly run produces one document per organization, covering all of its legal entities together.

What is in a settlement report

One XLSX workbook, laid out as a statement of delivery: the operator’s own particulars, the counterparty’s particulars, and then the delivery itself.

Where the counterparty is a demand partner, the document is grouped by partner, since each one is invoiced separately. The direct auction report is the case to picture: one block per partner, each block a self-contained statement of what that partner owes. Where the counterparty is the platform operator instead, there is a single block and the grouping is by campaign; the indirect auction report is laid out that way.

Within a group, each line is one campaign-and-creative combination on one face, and carries:

  • the campaign, the creative and its duration

  • the face’s name, its identifier and its city

  • the number of confirmed ad plays in the period

  • the total value of those ad plays, and the total commission on them

Every figure is a delivered figure; see Under-delivery for how they relate to the booked volume.

Direct reports additionally carry the period’s CoT and private-deal lines, appended to the same document, so one file covers everything settled directly for that month. Indirect reports do not.

Reports on request

Any period can be reported at any time, without waiting for month-end.

In the client cabinet, under Statistics, the Reports screen offers the four auction and programmatic guaranteed variants, over any date range. Reports produced here are automatically narrowed to the requester’s legal entity if their account is attached to one. The automated guaranteed variant is requested from its own screen, beside the guaranteed play statistics — see Reports.

The platform operator can produce the same documents, plus the automated guaranteed variant, on an organization’s behalf.

Generation runs in the background. When it finishes, an in-app notification appears and the document joins the list. Documents produced by the monthly run arrive without a notification.

Download and access

A report is downloaded from the list, as an XLSX file.

Which reports a person sees in the list depends on their role: an organization employee is shown the organization-facing types for their own organization, and a platform administrator is shown the administrator-facing ones.

An organization employee can download reports belonging to their own organization, and an employee whose account is attached to a legal entity can download only the reports scoped to that same legal entity. The same check applies to viewing a report’s details and to deleting one.

How long reports are kept

A report is kept for 30 days from the moment it was generated.

An expired report is removed together with its file. To get it back, generate it again for the same period.

Anyone who can see a report can also delete it before then, from the report’s own page.

If a month-end document has to survive longer than 30 days, download it and keep it wherever the organization keeps its accounting paperwork.
  • Billing — accounts, balances and recording a payment

  • What gets billed — which sales models appear in which report

  • Reports — report generation and retention in general

  • Late and lost plays — why a period’s counts can differ from the operator’s own