Die API ist das Produkt

kontakteQuelle ist Pflicht, sobald kontakteProTag gesetzt ist — counted, estimated oder modelled. Eine geschätzte Zahl darf verkauft werden, aber niemals als Messung ausgegeben. Ohne diese Prüfung wäre die Unterscheidung eine Bitte, kein Vertrag.

ags ist eine Zeichenkette, keine Zahl. Der Amtliche Gemeindeschlüssel hat acht Stellen, und die führende Null gehört dazu: "01001000" ist Flensburg. Als Zahl übertragen bleibt 1001000 übrig — acht der sechzehn Bundesländer beginnen mit einer Null, und der Fehler wirft nirgends eine Meldung. Der Marktstandard schliesst Objekte ohne AGS ausdrücklich aus der Kontaktberechnung aus: Ohne ihn bleibt die Fläche buchbar, wird aber je 1.000 Ausspielungen abgerechnet statt je 1.000 Kontakte. Weggelassen heisst „unverändert" — wer ihn entfernen will, schickt eine leere Zeichenkette.

werbeplaetzeProSchleife ist eine Obergrenze, keine Zusage. Der Bildschirm gehört weiter dem Betreiber; sein redaktioneller Inhalt behält immer die Mehrheit der Schleife. Weggelassen heisst „unverändert" — das gilt auch für schleifeSek und spotSek; eine neue Fläche ohne Angabe bekommt 60 / 10 / 2.

Die Taxonomie kennt nicht jedes Umfeld — es gibt weder Autohaus noch Bäckerei. Die Elternebene ("2" für Retail) ist eine gültige, ehrliche Angabe: lieber grob richtig als fein falsch, eine falsche Feinkennung führt zum No-Bid. Was die Taxonomie nicht kennt, gehört in etiketten.

Wer nach iDOOH meldet, sagt es — "venueTypeTaxonomy": "idooh-1.0". Erst dann sind punktierte Kennungen wie 1.1.2.4 gültig. Bis Fassung 0.4.0 wurde das Feld entgegengenommen, gespeichert und nie gelesen: Ein deutscher Netzbetreiber bekam für sein eigenes Inventar 422.

Abmelden geht immer — aber sichtbar. Es Ihnen zu verweigern hiesse, dass wir Werbung auf einem Bildschirm halten, über den Sie keine Verfügung mehr haben; das ist rechtlich schlechter als eine abgebrochene Kampagne. Deshalb: mit Grund, mit Post an den betroffenen Werbekunden, und die Antwort sagt Ihnen, wen es getroffen hat.

Drei Fälle, und der mittlere ist der teure. Eine noch nicht begonnene Buchung wird abgelehnt — es lief nichts, es kostet nichts. Eine laufende wird auf das bereits Gelieferte gekürzt und beendet: Der geleistete Teil wird abgerechnet, der Rest entfällt. Was ohnehin vorbei oder abgelehnt war, bleibt unberührt.

Der Bildschirm wird stillgelegt, nicht gelöscht (aktiv: false). An ihm hängt der Ausspielungsnachweis, und der ist ein steuerlich aufbewahrungspflichtiger Beleg (§ 147 AO). Ein Nachweis, dessen Bildschirm verschwunden ist, belegt nichts mehr.

Der DOOH Hub sagt was, wie oft, in welchem Fenster — nie wo in der Schleife. Das CMS entscheidet die Position, es kennt seinen redaktionellen Inhalt. Wer diese Linie überschreitet, zwingt jedes anbindende System, seine Playlistenlogik offenzulegen — und dann bindet keiner mehr an.

Der Vorlauf gehört dem Bildschirm, nicht dem Spielplan: Er kommt aus vorlaufMinuten (Vorgabe 120). Ein Spielplan „ab sofort" ist für ein Signage-Netz wertlos — er kommt zu spät im Zwischenspeicher an, und ein Spot, der dort nicht liegt, wird schwarz statt bunt. Wer ein Aktualisierungsfenster hat, meldet seine echte Zahl; wir richten das Fenster danach.

sha256 und bytes sind Pflicht, damit das CMS vorladen und prüfen kann. Ein Motiv ohne hochgeladene Datei wird gar nicht erst eingeplant — ein leerer Werbeplatz ist billiger als ein schwarzer Bildschirm.

Eine Lücke heisst „wir wissen es nicht", nicht „es lief nichts". Der Unterschied ist der ganze Sinn dieser Route: Offene Meldelücken blockieren die Festschreibung einer Rechnung, denn wer sie als Null behandelt, rechnet Luft ab.

Kein Herzschlag heisst nicht „Bildschirm aus". Es heisst „wir wissen es nicht" — dieselbe Unterscheidung wie bei den Meldelücken. Ein CMS, das den Herzschlag nicht kann (und das sind heute fast alle), wird dadurch nicht schlechter gestellt: Es bekommt keine schlechtere Sendequote, sondern gar keine Aussage.

Er kostet keinen neuen Schlüssel. Der Bereich ist inventory:write — den hat jedes CMS auf Stufe 1 bereits. Der Zustand des Panels ist eine Eigenschaft der Fläche, kein Lesen von Verfügbarkeiten.

Die Antwort meldet eine abweichende Gerätuhr zurück (clockSkewMs, ab fünf Minuten mit Hinweistext). Eine falsch gehende Uhr vergiftet lautlos jedes startedAt im Nachweis — und man sucht den Fehler dann im falschen Zimmer. Ebenso benannt wird state: "on" bei brightness: 0: Das ist ein schwarzer Bildschirm.

Meldelücken senken die Quote nicht — sie machen sie unbestimmt (bestimmt: false). Eine Sendequote von 99,2 %, die auf halben Daten beruht, ist keine Zahl, sondern eine Vermutung mit Nachkommastelle. In die Netzquote gehen deshalb nur die lückenlos gemeldeten Flächen ein.

Der Herzschlag fliesst hier nicht ein. Eine Fläche ohne Herzschlag bekommt keine schlechtere Quote — das bestrafte den Ehrlichen. Was er beiträgt, ist eine Auffälligkeit, keine Kennzahl.

Nicht sperren, sondern anzeigen. Eine automatische Sperre legt im Zweifel eine echte Fläche lahm, und Sie suchen den Fehler bei sich. Der Herzschlag kann veraltet oder selbst falsch sein — wer daraufhin Nachweise verwirft, vernichtet Umsatz auf Verdacht.

Erledigen heisst nicht stumm schalten. Tritt dieselbe Auffälligkeit wieder auf, wird sie erneut offen. Einmal abgehakt und nie wieder gesehen wäre das Ende der Arbeitsliste.

Warum getrennt und kein Multipart? Weil die Prüfsumme vor dem Inhalt da sein muss. Nur dann ist das Nachrechnen eine echte Prüfung. Kämen sha256 und Datei im selben Rumpf, könnte der Server die Summe genauso gut selbst bilden — dann prüft er seine eigene Rechnung gegen sich selbst und bemerkt eine unterwegs beschädigte Datei nie. Nebenbei: Ein abgebrochener 200-MB-Upload kostet dann nicht die Anmeldung.

Ein Motiv ohne Datei steht auf offen und wird nicht eingeplant. Ohne Inhalt ist es eine Ankündigung, keine Werbung.

Die Bildrate ist trotzdem kein Schönheitsfehler. 30 fps auf einem 25-Hz-Player ruckelt sichtbar, und das ist der klassische Reklamationsfall. Sie steht als Hinweis und nicht als Ablehnung, weil das Ruckeln behebbar ist (Umrechnen auf 25 fps) und die Ablehnung nicht.

Die Grössengrenze ist 1 MB je Sekunde (Full-HD) bzw. 4 MB je Sekunde (UHD), plus 25 % Toleranz — und die Toleranz ist gerechnet, nicht gegriffen: Der Standard erlaubt 10.000 kbit/s Bitrate, das sind 1,19 MiB je Sekunde, und verfehlt damit seine eigene Grössengrenze um 19 %. Wer hier ein Fallbeil setzt, lehnt Dateien ab, die nach dem anderen Absatz desselben Papiers einwandfrei sind.

Die Klasse entscheidet die Pixelzahl, nicht die Kantenlänge. 1080×1920 ist hochkant und trotzdem Full-HD. Die sechs Normauflösungen sind eine Erwartungsliste, keine Positivliste.

Bewegtbild ist an manchen Flächen unzulässig, und das fängt nicht der Upload ab, sondern die Freigabe: Eine Buchung, die ein Video auf einen Bildschirm mit bewegtbildErlaubt: false legt, wird auf der Bahn gesetz abgelehnt — und die hat keinen Übersteuerungsknopf. Das Motiv selbst bleibt gültig, es ist nur auf dieser Fläche nicht buchbar.

Die Freigabeprüfung läuft beim Anlegen, nicht erst beim Ausspielen. Ein Werbekunde soll sofort erfahren, dass seine Branche an diesem Standort ausgeschlossen ist — und nicht erst, wenn er auf den Bericht wartet.

ausspielungenProStunde ist eine Absicht, kein Versprechen. Was tatsächlich lief, steht ausschliesslich im Ausspielnachweis — und nur danach wird abgerechnet.

Der Preis wird eingefroren. Eine spätere Preisanpassung am Bildschirm ändert keine laufende Kampagne rückwirkend.

Das Budget der Kampagne ist seit 0.14.0 eine Grenze, keine Notiz. Übersteigt die Summe aller platzhaltenden Buchungen dieser Kampagne samt der neuen ihr budgetNettoCent, antwortet der Dienst 422 BUDGET_UEBERSCHRITTEN und nennt beide Beträge. ⚠ Bis dahin wurde das Feld beim Anlegen der Kampagne verlangt, geschrieben — und danach las es niemand mehr, der etwas hätte verhindern können: An eine Kampagne mit 1.500 € liessen sich beliebig viele Buchungen hängen. ⚠ budgetNettoCent <= 0 gilt als Platzhalter und wird nicht geprüft — ein bestehendes System mit einer Null im Feld legt also weiterhin Buchungen an.

Der Füllinhalt des Netzes ist nicht buchbar (422 HAUSMOTIV_NICHT_BUCHBAR). Er hält die Sendeschleife auf ihrer zugesagten Länge und wird gezählt, aber nie berechnet.

Stabile, unsignierte Adresse. Der Inhalt hinter einer Motiv-Kennung ändert sich nie — ein neuer Inhalt bekommt eine neue Kennung. Warum das zählt, steht unter Fallstricke.