Berichte
reports show KIND erstellt einen Bericht (fleet_health, uptime, publishing, alerts, alert_log oder proof_of_play) und schreibt ihn mit --format csv, xlsx oder pdf und --output FILE in eine Datei; reports subscriptions sendet einen Bericht nach Zeitplan per E-Mail an Projektmitglieder; project export DIR schreibt Projektdaten mit dem Ergebnis jedes Abschnitts. Berichte und Exporte beschreibt jeden davon.
reports list#
Die Berichtsarten und die Filter jeder Art auflisten.
reports listKeine Parameter.
screenrig reports listLiefert data.items, jeweils mit kind, title, description des Berichts und den Filtern, die er annimmt (params), sowie die Datei-formats.
reports show#
Einen Bericht als Zeilen erstellen oder als CSV-, XLSX- oder PDF-Datei schreiben.
reports show <kind> [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--group-by folder|screen|tag]
[--folder-id ID [--direct]] [--tag TAG] [--campaign-id ID] [--advertiser NAME]
[--format json|csv|xlsx|pdf] [--output FILE]| Parameter | Typ | Erforderlich | Standard | Notizen |
|---|---|---|---|---|
<kind> | string | ja | keine | fleet_health, uptime, publishing, alerts, alert_log oder proof_of_play. |
--from | string | nein | 29 Tage vor --to | Erster UTC-Tag, einschließlich, als YYYY-MM-DD. |
--to | string | nein | heute | Letzter UTC-Tag, einschließlich; höchstens 366 Tage nach --from. |
--group-by | string | nein | folder | Was eine Zeile ist: folder, screen oder tag. |
--folder-id | string | nein | keine | Nur dieser Bildschirmordner und alles darin. |
--direct | boolean | nein | aus | Mit --folder-id: nur die Bildschirme direkt im Ordner (--group-by screen) oder der Ordner und seine Unterordner. |
--tag | string | nein | keine | Nur Bildschirme mit diesem Tag. |
--campaign-id | string | nein | keine | proof_of_play: eine Direktkampagne. |
--advertiser | string | nein | keine | proof_of_play: die Kampagnen dieses Werbetreibenden oder Sponsors, nach exaktem Namen in beliebiger Groß-/Kleinschreibung. |
--format | string | nein | json | json, csv, xlsx oder pdf. |
--output | Pfad | nein | ./KIND.FORMAT | Datei, die mit --format csv, xlsx oder pdf geschrieben wird. Standardmäßig wird die Art mit Bindestrichen geschrieben, etwa ./fleet-health.pdf, und der Tag von --to angehängt, wenn angegeben, etwa ./fleet-health-2026-10-28.pdf. |
screenrig reports show fleet_health --group-by screen --from 2026-10-01 --to 2026-10-28
screenrig reports show proof_of_play --advertiser "Acme Corp" --format pdf --output acme-proof-of-play.pdfJSON liefert data.columns, data.rows, data.totals und data.notes; die Zeilen eines Ordnerberichts tragen id, parent_id und depth für die Gliederung, und seine erste Zeile ist das gesamte Projekt. Eine Datei antwortet mit Pfad, Bytes und SHA-256. Ein seitenweiser Bericht wird vollständig geschrieben, bis zu 50000 Zeilen (sonst data.truncated). proof_of_play erfordert ein Projekt, das Werbezeit auf eigenen Bildschirmen verkauft. Zugriff Nur lesen mit der Fähigkeit reports genügt.
reports subscriptions#
Einen Bericht nach Zeitplan per E-Mail an Projektmitglieder senden.
reports subscriptions list
reports subscriptions show <id>
reports subscriptions create --name NAME --kind KIND --format pdf|xlsx|csv
--recipients MEMBERS --cadence daily|weekly|monthly [--weekday DAY]
[--day-of-month N] [--hour N] [--timezone ZONE] [--filter NAME=VALUE]
reports subscriptions update <id> [--name NAME] [--format pdf|xlsx|csv]
[--recipients MEMBERS] [--filter NAME=VALUE] [--cadence daily|weekly|monthly]
[--weekday DAY] [--day-of-month N] [--hour N] [--timezone ZONE]
[--pause | --resume] [--expect-rev REVISION]
reports subscriptions delete <id>
reports subscriptions send <id>| Parameter | Typ | Erforderlich | Standard | Notizen |
|---|---|---|---|---|
<id> | string | ja | keine | Die rsub_-ID eines Abonnements, aus reports subscriptions list. |
--name | string | beim Erstellen | keine | Maximal 100 Zeichen. |
--kind | string | beim Erstellen | keine | Eine Art von reports show: fleet_health, uptime, publishing, alerts, alert_log oder proof_of_play. Sie ändert sich nie. |
--format | string | beim Erstellen | keine | Der Anhang: pdf, xlsx oder csv. |
--recipients | string | beim Erstellen | keine | Bis zu 25 Projektmitglieder, kommagetrennt: eine Benutzer-ID, die E-Mail-Adresse eines Mitglieds oder owner. update ersetzt die Empfänger. |
--filter | string | nein | keine | Ein Berichtsfilter als NAME=VALUE, etwa group_by=screen, folder_id=sfd_ID, tag=Lobby oder advertiser=Acme; wiederholbar. update ersetzt die Filter. |
--cadence | string | beim Erstellen | keine | daily, weekly oder monthly. |
--weekday | string | nein | monday | Wöchentliche Läufe: monday bis sunday. |
--day-of-month | integer | nein | 1 | Monatliche Läufe: der Tag, 1 bis 28. |
--hour | integer | nein | 0 | Stunde des Tages in der Zeitzone, 0 bis 23. |
--timezone | string | nein | UTC | Eine IANA-Zeitzone wie America/Los_Angeles. |
--pause | boolean | nein | aus | Nur update: sendet nichts, bis es fortgesetzt wird. Nicht zusammen mit --resume. |
--resume | boolean | nein | aus | Nur update: sendet ab dem nächsten Termin wieder. |
--expect-rev | integer | nein | keine | Nur update: schlägt fehl, wenn das Abonnement nicht diese Revision hat. |
screenrig reports subscriptions create --name "Monday fleet health" --kind fleet_health --cadence weekly --weekday monday --hour 7 --timezone America/Los_Angeles --format pdf --recipients ann@example.com,usr_01EXAMPLEPERSON0000
screenrig reports subscriptions update rsub_01EXAMPLESUB0000000000 --pauseJeder Lauf deckt den Zeitraum davor in UTC-Tagen ab: gestern, die sieben Tage davor oder den letzten Monat. Empfänger müssen Mitglieder des Projekts sein, und ein Mitglied, das ausscheidet, erhält den Bericht nicht mehr. update braucht mindestens eine Änderung. send sendet den Bericht jetzt für den Zeitraum, den ein Lauf jetzt abdecken würde, ohne den Zeitplan zu verschieben, und antwortet mit dem Abonnement einschließlich last_status und last_error dieses Versands. Ein fehlgeschlagener Lauf wird wiederholt und erscheint als last_status failed mit last_error; ein PDF- oder XLSX-Anhang über 8 MiB wird nicht versendet. Eine Organisation hat höchstens 50 Abonnements über alle ihre Projekte. Lesen erfordert die Fähigkeit project und Zugriff Nur lesen; Erstellen, Ändern, Löschen und Senden erfordern Zugriff Verwalten.
Audit-Protokoll
audit list|show|head|verify|export liest das Audit-Protokoll des Projekts: audit list durchsucht die Konfigurationsänderungen nach Akteur, Quelle, Ressource, Aktion und Feld, audit show zeigt einen Eintrag mit dem Vorher und Nachher jedes geänderten Felds, audit head zeigt den Kettenkopf, der als Anker aufzubewahren ist, audit verify berechnet die Kette neu (optional gegen einen Anker) und endet mit Code 13, wenn sie nicht verifiziert wird, und audit export schreibt das gefilterte Protokoll als CSV-, XLSX- oder PDF-Datei. Audit-Protokoll beschreibt jeden dieser Befehle.
audit list#
Audit-Einträge auflisten, neueste zuerst.
audit list [--actor ID] [--actor-kind KIND] [--source SOURCE] [--resource-type TYPE]
[--resource-id ID] [--action CODE] [--field POINTER] [--since TIME] [--until TIME]
[--limit N] [--after CURSOR]| Parameter | Typ | Erforderlich | Standard | Notizen |
|---|---|---|---|---|
--actor | string | nein | keine | Nur Änderungen dieser Person, dieses Agenten oder Dienstclients, nach ID. |
--actor-kind | string | nein | keine | person, agent, service_client, staff oder system. |
--source | string | nein | keine | Die Oberfläche, über die eine Änderung kam: dashboard, api, cli, device, webhook oder system. |
--resource-type | string | nein | keine | Nur Änderungen an dieser Ressourcenart, etwa screen, playlist, webhook oder member. |
--resource-id | string | nein | keine | Nur Änderungen an dieser Ressource. |
--action | string | nein | keine | Ein Aktionscode wie screen.update oder ein Präfix, das auf * endet, wie playlist.*. |
--field | string | nein | keine | Nur Änderungen, die dieses Element oder eines darunter betroffen haben, als JSON-Pointer wie /label. |
--since | string | nein | keine | Nur Änderungen ab diesem RFC-3339-Zeitpunkt, etwa 2026-10-01T00:00:00Z. |
--until | string | nein | keine | Nur Änderungen vor diesem RFC-3339-Zeitpunkt. |
--limit | integer | nein | 50 | Einträge pro Seite, 1 bis 200. |
--after | string | nein | keine | Die data.next_cursor der vorherigen Seite. |
screenrig audit list --resource-type screen --resource-id scr_01EXAMPLESCREEN00000000
screenrig audit list --action 'playlist.*' --source cli --limit 20Liefert data.items neueste zuerst, jeweils mit actor (kind, id, name), source, action, resource (type, id, name) und changes, jeweils ein path (ein JSON-Pointer in die Ressource), before und after; eine Anmeldeinformation erscheint auf beiden Seiten als (redacted). seq und hash erscheinen, sobald ein Eintrag verkettet ist, innerhalb von Sekunden. data.next_cursor ist auf der letzten Seite null. Zugriff Nur lesen mit der Fähigkeit project genügt.
audit show#
Einen Audit-Eintrag mit dem Vorher und Nachher jedes geänderten Felds anzeigen.
audit show <id>| Parameter | Typ | Erforderlich | Standard | Notizen |
|---|---|---|---|---|
<id> | string | ja | keine | Die aud_-ID eines Eintrags, aus audit list. |
screenrig audit show aud_01EXAMPLEENTRY0000000000Liefert den Eintrag mit path, before und after jedes geänderten Felds, wer die Änderung vorgenommen hat und über welche Oberfläche, und seiner Position in der Kette, sobald er verkettet ist.
audit head#
Den Kettenkopf des Audits anzeigen, der als Anker aufzubewahren ist.
audit headKeine Parameter.
screenrig audit headGibt den zuletzt verketteten Eintrag als SEQ:HASH aus, die Aufbewahrungsuntergrenze, ab der die Kette beginnt, und wie viele Einträge auf die Verkettung warten. Bewahren Sie den Kettenkopf auf: audit verify --anchor SEQ:HASH beweist später, dass der Verlauf nicht umgeschrieben oder gekürzt wurde.
audit verify#
Die Audit-Hash-Kette neu berechnen und alles melden, was nicht übereinstimmt.
audit verify [--from-seq N] [--limit N] [--anchor SEQ:HASH]| Parameter | Typ | Erforderlich | Standard | Notizen |
|---|---|---|---|---|
--from-seq | integer | nein | ältester behaltener Eintrag | Erste zu prüfende Kettenposition. |
--limit | integer | nein | 5000 | Einträge, die in diesem Aufruf geprüft werden, höchstens 5000. |
--anchor | string | nein | keine | Ein von Ihnen aufbewahrter Kettenkopf SEQ:HASH: beweist zusätzlich, dass der Verlauf bis dahin unverändert ist. |
screenrig audit verify --anchor 128:3f2c0b6e9a4d81c7f5e0a2b4c6d8e0f1a3b5c7d9e1f30415263748596a7b8c9dMeldet hash_mismatch, prev_mismatch, gap, head_mismatch, anchor_mismatch oder floor_mismatch pro Eintrag in data.problems. Endet mit Code 13 und data.ok false, wenn die Kette nicht verifiziert wird; data.next_seq setzt eine längere Kette fort.
audit export#
Das gefilterte Audit-Protokoll als CSV-, XLSX- oder PDF-Datei schreiben.
audit export --format csv|xlsx|pdf [--output FILE]
[--actor ID] [--actor-kind KIND] [--source SOURCE] [--resource-type TYPE]
[--resource-id ID] [--action CODE] [--field POINTER] [--since TIME] [--until TIME]| Parameter | Typ | Erforderlich | Standard | Notizen |
|---|---|---|---|---|
--format | string | ja | keine | csv, xlsx oder pdf. |
--output | Pfad | nein | ./audit-log.FORMAT | Zu schreibende Datei. Mit --until hängt der Standardname diesen Tag an, etwa ./audit-log-2026-10-01.csv. |
--actor, --actor-kind, --source, --resource-type, --resource-id, --action, --field, --since, --until | string | nein | keine | Die Filter von audit list. Ohne --since umfasst die Datei die letzten 30 Tage. |
screenrig audit export --format csv --output audit.csv
screenrig audit export --format pdf --resource-type playlist --output playlist-changes.pdfSchreibt eine Zeile pro geändertem Feld, älteste zuerst, bis zu 50000 Zeilen (sonst data.truncated), mit Kettenkopf und Aufbewahrungsuntergrenze in der Datei, und antwortet mit Pfad, Bytes und SHA-256.
Wiedergabe
Wiedergabenachweise liegen in vier Formen vor. playback plays liest eine Zeile pro sichtbarem Start eines Bildes, Videos oder einer Anwendung auf einem Bildschirm, älteste zuerst nach received_at: Wiedergabenachweis für einen Bericht oder einen Werbetreibenden. playback list liest Tagesgesamtwerte, eine Zeile pro Bildschirm, Medienobjekt und UTC-Tag. playback totals liest Wiedergabezahlen pro UTC-Tag oder sortiert die meistgenutzten Bildschirme oder Medien. playback completeness liest, wie viele der von den Playern nummerierten Wiedergaben screenRIG erreicht haben und wo Wiedergaben fehlen.
Jeder Wiedergabebefehl nimmt --format json|csv|xlsx|pdf und --output FILE entgegen, und das Dashboard exportiert dieselben Dateien. json, der Standard, ist der Umschlag des Befehls und lehnt --output ab; die anderen Formate schreiben eine Datei. playback plays und playback list streamen ihr eigenes CSV, und --output - sendet es an stdout statt des Umschlags. Jede andere Datei wird auf dem Server gerendert und unter einem Dateipfad gespeichert. Eine xlsx- oder pdf-Datei enthält höchstens 50.000 Zeilen für playback plays und höchstens 200 für playback list. Jeder Befehl nennt seine Standarddatei.
Abspielungen werden für die Ereignisaufbewahrung des Plans mindestens 30 Tage lang gespeichert.
| Problemcode | Beenden | Bedeutung |
|---|---|---|
invalid_request | 8 | Ein Wiedergabebereich länger als 31 Tage, ein Tagesbereich über dem Limit des Befehls oder ein fehlerhafter Filter. Die CLI lehnt die meisten davon ab, bevor sie etwas sendet (Exit 2). |
rate_limited | 7 | Das Wiedergabe-Export-Budget von 30 Anfragen pro Minute und Organisation ist aufgebraucht. Warten Sie retry_after_seconds. |
Agentenanfragen: Jede JSON-Seite ist eine Agentenanfrage, sodass --all eine Anfrage pro Seite stellt. Ein CSV-Export ist eine Anfrage für seinen gesamten Zeitraum. Jede Wiedergabeanfrage (JSON-Seite, CSV, XLSX oder PDF) und jeder CSV-Export von playback list verbraucht außerdem das Exportbudget für Wiedergaben. playback totals und playback completeness sind je eine Agentenanfrage und verbrauchen nichts von diesem Budget.
playback plays#
Lese einzelne Wiedergabeaufzeichnungen, eine Zeile pro sichtbarem Start.
playback plays [--from TIME] [--to TIME] [--screen-id ID] [--media-id ID] [--tag TAG] [--cursor CURSOR] [--limit N] [--all]
playback plays --format csv|xlsx|pdf [--output FILE] [--from TIME] [--to TIME] [--screen-id ID] [--media-id ID] [--tag TAG]| Parameter | Typ | Erforderlich | Standard | Notizen |
|---|---|---|---|---|
--from TIME | string | nein | 24 Stunden vor --to | Inklusive obere Grenze bei received_at: ein RFC-3339-Zeitpunkt mit Sekunden und Offset, now, oder ein Alter wie 7d, 12h oder 30m. |
--to TIME | string | nein | jetzt | Exklusiv gebunden, in denselben Formen. Der Bereich beträgt höchstens 31 Tage. |
--screen-id ID | string | nein | jeder Bildschirm | Ein scr_ Bildschirm. |
--media-id ID | string | nein | jedes Objekt | Ein med_ Medienobjekt. |
--tag TAG | string | nein | jeder Bildschirm | Ein Tag, den der Bildschirm trug, als die Wiedergabe empfangen wurde: 1 bis 32 Buchstaben oder Ziffern. |
--cursor CURSOR | string | nein | der Beginn des Bereichs | Die next_cursor der vorherigen Seite (pc_…) mit denselben Filtern. |
--limit N | integer | nein | 200 | Zeilen pro JSON-Seite, 1 bis 1000. Nur JSON: --format csv lehnt es ab. |
--all | boolean | nein | aus | Folgen Sie dem Cursor bis zum Ende des Bereichs, 1000 Zeilen pro Seite, sofern --limit nichts anderes angibt, für maximal 50 Seiten. Nur JSON: --format csv lehnt es ab. |
--format FORMAT | string | nein | json | json, csv, xlsx oder pdf. csv streamt den gesamten Bereich; xlsx und pdf enthalten seine ersten 50.000 Zeilen. |
--output FILE | Pfad | nein | ./playback-plays.csv, ./plays.xlsx oder ./plays.pdf | Die zu schreibende Datei; sie braucht ein Dateiformat. Mit --format csv schreibt - das CSV an stdout statt des Umschlags. |
screenrig playback plays --from 7d --tag Lobby --all
screenrig playback plays --format csv --from 2026-09-01T00:00:00Z --to 2026-10-01T00:00:00Z --output september-plays.csv
screenrig playback plays --format xlsx --from 7d --tag Lobby --output lobby-plays.xlsxDie CLI normalisiert beide Grenzen auf UTC und sendet sie bei jeder Anfrage; data.from und data.to geben sie zurück. Die neuesten 5 Sekunden werden zurückgehalten, bis sie sich stabilisieren, sodass eine Wiedergabe etwa 5 Sekunden nach Empfang erscheint, und data.to meldet dieses effektive Ende. Die Wiedergabe einer Anwendung trägt release_id und ein leeres Feld media_id. JSON liefert eine Seite in data.items mit data.next_cursor, und data.next.argv ist der genaue Befehl für die nächste Seite. --all stoppt frühzeitig mit data.next und einer Warnung, beim Seitenlimit (playback_plays_truncated) oder wenn das Exportbudget aufgebraucht ist (playback_export_rate_limited), statt Anfragen zu verbrauchen, die abgelehnt würden.
Das CSV entspricht RFC 4180 mit der festen Kopfzeile screen_id,playlist_id,page_id,primitive_id,media_id,primitive,started_at,received_at,manifest_revision,playlist_revision und Zeiten in RFC 3339 UTC. primitive_id und started_at sind leer, sofern der Player sie nicht gemeldet hat. Eine Zelle, die mit =, +, -, @, Tabulator oder Wagenrücklauf beginnt, erhält ein führendes ', damit Tabellenkalkulationen sie nicht auswerten. Die CLI schreibt über eine private temporäre Datei im selben Verzeichnis und ersetzt eine vorhandene Datei erst nach sauberem Stream-Ende. --timeout ist das Limit für fehlenden Fortschritt im Stream, standardmäßig 60000 ms ohne ein Byte, kein Limit für seine Gesamtdauer. Der Umschlag meldet path, bytes, rows, sha256, content_type, from, to und last_received_at; das CSV wird nie in den Umschlag aufgenommen. Mit --output - geht das CSV an stdout, und es wird kein Umschlag ausgegeben.
Wenn ein Stream unterwegs fehlschlägt, endet der Befehl mit einem Exit-Code ungleich null und schreibt die Zieldatei nie. Die bereits empfangenen vollständigen Zeilen bleiben in FILE.partial (FILE.partial-2 usw., wenn sie bereits existiert), und error.next exportiert den Rest des Bereichs ab dem letzten received_at in eine ungenutzte FILE-rest.csv. Zeilen, die genau in diesem Moment empfangen wurden, erscheinen in beiden; verwerfen Sie die Wiederholungen beim Zusammenfügen. Mit --output - bleibt das unvollständige CSV auf stdout, und der Fehler sowie der Befehl next gehen an stderr.
xlsx und pdf werden auf dem Server gerendert und auf dieselbe Weise über eine private temporäre Datei gespeichert. Der Umschlag meldet path, bytes, sha256, content_type und format, und die Datei enthält die ersten 50.000 Zeilen des Bereichs.
playback list#
Lesen Sie tägliche Wiedergabesummen für dieses Projekt, neueste Tage zuerst.
playback list [--screen-id ID] [--media-id ID] [--day YYYY-MM-DD | --day-from YYYY-MM-DD --day-to YYYY-MM-DD]
[--format json|csv|xlsx|pdf] [--output FILE]| Parameter | Typ | Erforderlich | Standard | Notizen |
|---|---|---|---|---|
--screen-id ID | string | nein | jeder Bildschirm | Muss mit scr_ beginnen. |
--media-id ID | string | nein | jedes Objekt | Muss mit med_ beginnen. |
--day YYYY-MM-DD | string | nein | jeder Tag | Ein UTC-Kalendertag. Nicht mit --day-from oder --day-to. |
--day-from YYYY-MM-DD | string | nein | keine | Erster Tag eines UTC-Tagesbereichs, einschließlich. Mit --day-to umfasst der Bereich höchstens 366 Tage. Bei CSV standardmäßig 30 Tage vor --day-to. Nicht mit --day. |
--day-to YYYY-MM-DD | string | nein | keine | Letzter Tag dieses Bereichs. Bei CSV standardmäßig heute. Nicht mit --day. |
--format FORMAT | string | nein | json | json, csv, xlsx oder pdf. csv streamt jede passende Zeile, ohne Bereich die 31 Tage bis heute. xlsx und pdf enthalten dieselben Zeilen wie die JSON-Liste. |
--output FILE | Pfad | nein | ./playback-aggregates.csv, ./play-aggregates.xlsx oder ./play-aggregates.pdf | Die zu schreibende Datei; sie braucht ein Dateiformat. Mit --format csv schreibt - das CSV an stdout statt des Umschlags. |
screenrig playback list --screen-id scr_01EXAMPLESCREEN00000000 --day 2026-08-14
screenrig playback list --format csv --day-from 2026-09-01 --day-to 2026-09-30
screenrig playback list --format pdf --day-from 2026-09-01 --day-to 2026-09-30 --output september.pdfEine Zeile pro Bildschirm, Medienobjekt und UTC-Tag. Die Filter wählen die eigenen Zeilen des Aufrufers aus. JSON liefert höchstens 200 Zeilen in data.items, neueste Tage zuerst; die Tagessummen werden etwa alle 10 Minuten aktualisiert, und playback plays zeigt neuere Starts. Die CSV-Kopfzeile ist screen_id,media_id,filename,primitive,day,play_count,last_page_id,last_manifest_revision,first_started_at,last_started_at. Das CSV ist eine Anfrage, geschrieben wie ein Wiedergabe-CSV, und seine Antwort meldet path, bytes, rows, sha256 und content_type; eine Antwort für xlsx oder pdf meldet path, bytes, sha256, content_type und format. Ein fehlgeschlagener Tagesexport behält nichts; führen Sie ihn erneut aus.
playback totals#
Lese Wiedergabezahlen pro UTC-Tag oder ordne die meistgenutzten Bildschirme oder Medien.
playback totals [--by day|screen|media|screen_day] [--day-from YYYY-MM-DD] [--day-to YYYY-MM-DD]
[--screen-id ID | --media-id ID] [--top N] [--format json|csv|xlsx|pdf] [--output FILE]| Parameter | Typ | Erforderlich | Standard | Notizen |
|---|---|---|---|---|
--by GROUPING | string | nein | day | day antwortet mit einer Zeile pro UTC-Tag. screen oder media ordnet die geschäftigsten. screen_day antwortet mit der Tagesreihe der Top-Bildschirme. |
--day-from YYYY-MM-DD | string | nein | 29 Tage vor --day-to | Erster UTC-Tag, einschließlich. |
--day-to YYYY-MM-DD | string | nein | heute | Letzter UTC-Tag, inklusive. |
--screen-id ID | string | nein | jeder Bildschirm | Mit --by day nur diesen Bildschirm zählen. Nicht mit --media-id. |
--media-id ID | string | nein | jedes Objekt | Mit --by day nur dieses Medienobjekt zählen. Nicht mit --screen-id. |
--top N | integer | nein | 10 | Zeilen eines Rankings, 1 bis 100; 1 bis 10 mit --by screen_day. Erfordert --by; gilt nicht für --by day. |
--format FORMAT | string | nein | json | json, csv, xlsx oder pdf. Die anderen drei schreiben dieselben Zeilen als Datei. |
--output FILE | Pfad | nein | ./play-totals.csv, ./play-totals.xlsx oder ./play-totals.pdf | Die Datei, die mit --format csv, xlsx oder pdf geschrieben wird. Nur ein Dateipfad: - wird abgelehnt. |
screenrig playback totals
screenrig playback totals --day-from 2026-09-01 --day-to 2026-09-30 --screen-id scr_01EXAMPLESCREEN00000000
screenrig playback totals --by screen --top 5
screenrig playback totals --by media --day-from 2026-09-01 --day-to 2026-09-30
screenrig playback totals --by screen_day --top 3
screenrig playback totals --by screen --top 10 --format xlsx --output busiest-screens.xlsxZählungen stammen aus den täglichen Rollups, die bis zu etwa 21 Minuten nach der Aufnahme folgen; playback plays zeigt neuere Starts. day antwortet auf data.days, screen und media antworten auf data.screens und data.media, und screen_day antwortet auf data.screen_days. Eine Tagesreihe umfasst höchstens 366 Tage (92 mit --screen-id oder --media-id) und ein Ranking höchstens 92. data.truncated ist true, wenn ein Ranking über ein zu großes Fenster für einen Lesevorgang nur die besten Schlüssel jedes Abschnitts behielt. Ein Dateiformat schreibt die Datei des Servers nach --output, und sein Umschlag meldet path, bytes, sha256, content_type und format.
playback completeness#
Liest pro UTC-Tag, wie viele der von den Playern nummerierten Wiedergaben screenRIG erreicht haben, und die Lücken, in denen Wiedergaben fehlten.
playback completeness [--day-from YYYY-MM-DD] [--day-to YYYY-MM-DD] [--screen-id ID] [--limit N]
[--format json|csv|xlsx|pdf] [--output FILE]| Parameter | Typ | Erforderlich | Standard | Notizen |
|---|---|---|---|---|
--day-from YYYY-MM-DD | string | nein | 29 Tage vor --day-to | Erster UTC-Tag, einschließlich. Der Zeitraum umfasst höchstens 92 Tage. |
--day-to YYYY-MM-DD | string | nein | heute | Letzter UTC-Tag, inklusive. |
--screen-id ID | string | nein | jeder Bildschirm | Nur dieser Bildschirm. Muss mit scr_ beginnen. |
--limit N | integer | nein | 100 | Aufzulistende Lücken, neueste zuerst, 1 bis 500. |
--format FORMAT | string | nein | json | json, csv, xlsx oder pdf. Die anderen drei schreiben dieselben Zeilen als Datei. |
--output FILE | Pfad | nein | ./play-completeness.csv, ./play-completeness.xlsx oder ./play-completeness.pdf | Die Datei, die mit --format csv, xlsx oder pdf geschrieben wird. Nur ein Dateipfad: - wird abgelehnt. |
screenrig playback completeness
screenrig playback completeness --day-from 2026-09-01 --day-to 2026-09-30
screenrig playback completeness --screen-id scr_01EXAMPLESCREEN00000000 --limit 20
screenrig playback completeness --format pdf --output completeness.pdfJeder Medienstart trägt eine Nummer, sodass eine Wiedergabe, die ein Bildschirm erzeugt und nie geliefert hat, etwa eine offline erzeugte, die die 24-Stunden-Berichtswarteschlange überschritten hat, eine Lücke hinterlässt. data.completeness ist data.measured_plays geteilt durch die Summe aus data.measured_plays und data.missing_plays für den Zeitraum, von 0 bis 1, und null, wenn keines von beiden gemessen wurde: Wiedergaben ohne Nummern, von Playern, die ihre Wiedergaben nicht nummerieren oder es früher nicht taten, werden nicht gemessen. data.days liefert dieselben drei Werte für jeden UTC-Tag, der welche hat, älteste zuerst, wobei eine Lücke an dem Tag gezählt wird, an dem die darauf folgende Wiedergabe stattfand. data.gaps listet jede Lücke, neueste zuerst, mit screen_id, day, from und to (den Startzeiten der Wiedergaben auf beiden Seiten) und missing_plays auf; --limit begrenzt sie, und data.truncated ist true, wenn mehr existieren. Ein ausgeschalteter Bildschirm erzeugt keine Wiedergaben und hinterlässt keine Lücke. Das Rollup wird alle 10 Minuten aktualisiert. Eine gemessene API-Anfrage; das Wiedergabe-Export-Budget gilt nicht. Ein Dateiformat schreibt die Datei des Servers nach --output, und sein Umschlag meldet path, bytes, sha256, content_type und format.