Impressionen messen

• Was du davon hast
• Nicht jeder Eintrag hat Impressionen
• Übersicht nach Integration
• Die Metrik eines Eintrags
• Embed Code
• Map
• Nitro CMS
• API und API SDK
  • Mehrere Einträge in einem Aufruf
• Webflow
• Mailjet
• Signage OS
• Einrichtung prüfen

Impressionen zeigen, wie oft ein Eintrag auf einem deiner Kanäle angezeigt wurde. Damit eine Impression ankommt, muss die Integration, die den Eintrag ausliefert, die Metrik des Eintrags aufrufen. Bei einigen Integrationen geschieht das automatisch, bei anderen baust du einen Aufruf oder ein Tracking Pixel ein.

Was du davon hast

In der Statistik eines Eintrags (Content Editor, Dashboard) siehst du:

• Wo der Eintrag gesehen wird: der Verlauf der Impressionen pro Integrationsgruppe zeigt, auf welchem Kanal er ankommt.
• Ob er zulegt: jeder Zeitraum (7 Tage, 30 Tage, 90 Tage, 12 Monate) wird mit dem davor verglichen, dazu der stärkste Tag.
• Was Posts und Pools bewirken: Social Posts und die Aufnahme in einen kuratierten Content Pool stehen als Markierung im Verlauf, direkt neben den Impressionen danach.
• Live: solange die Seite offen ist, zählt «Heute» jeden neuen Aufruf sofort mit.

Über alle Einträge hinweg fliessen die Impressionen in die Statistiken, die Widgets «Beliebte Inhalte» und «Live-Zugriffe» der Standardansicht und den monatlichen Performance-Report.

Nicht jeder Eintrag hat Impressionen

Ein Eintrag ohne Impressionen ist nicht zwingend ein Fehler. Keine Impressionen haben zum Beispiel Einträge,

• die nur intern genutzt werden, etwa als Wert eines Felds in einem anderen Eintrag,
• die gedruckt werden (Adobe InDesign) oder in Canva gestaltet werden,
• die über Import oder einen Hook nur Daten austauschen,
• die nur als Social Post verbreitet werden. Die Zahlen der Social Posts liefern die Netzwerke selbst, Flyo zeigt sie getrennt als «Social Media».

Wird ein Eintrag über eine Integration aus der Übersicht unten ausgeliefert und es kommen trotzdem keine Impressionen an, ist die Metrik dort noch nicht eingerichtet.

Übersicht nach Integration

Integration	Was zählt als Impression	Einrichtung
Embed Code	Der Eintrag ist mindestens 4 Sekunden zu 75 % im sichtbaren Bereich	automatisch
Map	Klick auf einen Eintrag und Aufruf des weiterführenden Links	automatisch
Nitro CMS	Aufruf der Detailseite des Eintrags	entity_metric aufrufen, je nach Framework automatisch
API und API SDK	Aufruf der Metrik-URL des Eintrags	Feld metric aufrufen oder als Pixel einbauen
Webflow	Seitenaufruf mit dem Tracking Pixel	Feld «Metrik Tracking Pixel» synchronisieren
Mailjet	Öffnen des Newsletters, wenn der E-Mail-Client Bilder lädt	{$metric} im Template
Signage OS	Scan des QR-Codes, im Applet zusätzlich die Anzeige eines Slides	QR-Code automatisch, Slides über das Applet

Die Metrik eines Eintrags

Jeder Eintrag bekommt pro Integration eine eigene Metrik mit zwei URLs, die beide dasselbe zählen:

{
  "api": "https://api.flyo.cloud/integration/metric/h/METRICS_HASH",
  "image": "https://api.flyo.cloud/integration/metric/h/METRICS_HASH/pixel.gif"
}

• api rufst du per JavaScript oder vom Server auf. Die URL hat keine CORS-Einschränkung.
• image ist ein unsichtbares 1×1 Pixel für Seiten ohne eigenes JavaScript, zum Beispiel in Webflow oder einem Newsletter.

<img src="https://api.flyo.cloud/integration/metric/h/METRICS_HASH/pixel.gif" width="1" height="1" alt="">

fetch('https://api.flyo.cloud/integration/metric/h/METRICS_HASH')

Im Browser aufrufen

Ruf die Metrik im Browser der Besucherin oder des Besuchers auf, nicht vom Server. Derselbe Aufruf von derselben Adresse zählt innerhalb von 60 Sekunden nur einmal. Vom Server kommen alle Aufrufe von einer Adresse, viele echte Seitenaufrufe würden so zu einer Impression.

Nur auf der Live-Seite

Ruf die Metrik nur auf der öffentlichen Seite auf, nicht in der Vorschau, im Live Edit von Nitro oder auf einer Staging-Umgebung. Sonst zählen die Aufrufe deines Teams mit.

Embed Code

Der Embed Code misst die Impressionen selbst. Eine Impression zählt, sobald ein Eintrag mindestens 4 Sekunden zu 75 % im sichtbaren Bildschirmbereich ist. Es ist nichts einzurichten.

Map

Die Map zählt eine Impression, wenn jemand einen Eintrag anklickt und den weiterführenden Link aufruft. Es ist nichts einzurichten.

Nitro CMS

Der Entities Endpunkt liefert zu jedem Eintrag das Objekt entity_metric mit api und image. Die Detailseite des Eintrags ruft entity_metric.api auf, einmal pro Seitenaufruf. Wie das geht, hängt vom SDK ab:

Framework	Einrichtung
Nuxt	useFlyoEntity() ruft die Metrik beim Laden der Seite im Browser automatisch auf.
Next.js	Die Komponente <FlyoMetric> auf der Detailseite einbauen, siehe unten.
Astro	Ein fetch im Produktionsbuild, siehe unten.
Laravel	Die Head-Komponente ruft die Metrik in der Umgebung production automatisch auf.
Andere	entity_metric.api im Browser aufrufen, wie unter Die Metrik eines Eintrags.

Next.js: enabled schaltet die Metrik im Live Edit aus.

import { FlyoMetric } from "@flyo/nitro-next/client";

<FlyoMetric entity={entity} enabled={!flyo.state.liveEdit} />

Astro: nur im Produktionsbuild einbinden.

{
  isProd && (
    <script is:inline define:vars={{ api: response.entity.entity_metric.api }}>
      fetch(api)
    </script>
  )
}

API und API SDK

Jeder Eintrag aus der API und dem API SDK enthält das Feld metric mit api und image. Im API SDK ist es immer dabei, auch wenn du die Felder mit ?fields= einschränkst.

Ruf metric.api auf, wenn der Eintrag angezeigt wird, oder bau metric.image als Pixel ein, siehe Die Metrik eines Eintrags.

Mehrere Einträge in einem Aufruf

Zeigt eine Seite mehrere Einträge, kannst du ihre Metriken in einem Aufruf senden: POST https://api.flyo.cloud/integration/metrics mit Content-Type: application/json und einem Array aus Hashes oder api-URLs, höchstens 10 pro Aufruf.

[
  "https://api.flyo.cloud/integration/metric/h/5f1b6641a7af7ee4-46-schema",
  "3d8dd5075f5db664917-58-schema"
]

Webflow

Webflow bindet die Metrik als Tracking Pixel ein. Die Schritte stehen unter Webflow, Metrik:

1. In der Webflow Collection ein Feld Tracking Pixel Flyo (Plain Text) anlegen.
2. In Flyo das Feld «Metrik Tracking Pixel» in dieses Feld synchronisieren.
3. Im Collection Template ein Embed Element mit <img src="" /> einfügen und das Feld als src setzen.

Mailjet

Im Newsletter-Template steht die Metrik jedes Eintrags als Variable bereit. Setz sie in ein mj-raw-Element:

<mj-raw>{$metric}</mj-raw>

Eine Impression zählt, wenn der Newsletter geöffnet wird und der E-Mail-Client Bilder lädt. Viele Clients blockieren Bilder, die Zahl liegt also unter den tatsächlichen Öffnungen. Bei grossen Auflagen entstehen viele Impressionen auf einmal. Mehr dazu unter Mailjet, Metrik Pixel.

Signage OS

Zeigt eine Signage-Folie den generierten QR-Code eines Eintrags, zählt jeder Scan als Impression und leitet danach auf den hinterlegten Link weiter, vergleichbar mit einem Klick auf einer Webseite. Das ist ohne Einrichtung aktiv.

Mit dem Signage OS Applet bringt jeder Slide zusätzlich das Feld metric mit. Ruft das Applet die URL auf, wenn der Slide angezeigt wird, zählt auch die Anzeige.

Einrichtung prüfen

1. Öffne die Detailseite des Eintrags auf der Live-Seite und schau in den Entwicklertools des Browsers (Netzwerk) nach einem Aufruf von api.flyo.cloud/integration/metric/h/….
2. Öffne in Flyo die Statistik des Eintrags. Solange sie offen ist, zählt «Heute» jeden Aufruf live mit, die Statistik erscheint mit dem ersten.
3. Kommt nichts an, prüfe, ob die Integration aktiv ist. Inaktive Integrationen zählen nicht.

Ein erneuter Aufruf derselben Metrik von deinem Browser innerhalb von 60 Sekunden zählt nicht noch einmal.

Impressionen und Requests

Impressionen messen die Sichtbarkeit von Inhalten. Requests zählen die Anfragen an die Flyo-Server und bestimmen die genutzten Credits. Die beiden Werte sind nicht dasselbe.