In-App-Statistiken

Zwei Methoden geben Statistiken für sofortige In-App-Kampagnen zurück. Verwenden Sie inapps:totals für Gesamtwerte eines Zeitraums über eine oder mehrere Kampagnen und inapps:timeline für eine Zeitreihe einer einzelnen Kampagne. Die Werte entsprechen dem In-App-Statistikbildschirm im Control Panel.

In-Apps, die von einer Journey gesendet werden

Diese Methoden decken nur sofortige In-App-Kampagnen ab. In-Apps, die von einem Customer Journey-Element zugestellt werden, werden pro Journey-Punkt durch Journey-Statistiken abrufen gemeldet.

Metriken

Feld	Typ	Beschreibung
impressions	number	Wie oft die In-App angezeigt wurde. Im Control Panel als Impressions bezeichnet.
unique_impressions	number	Anzahl der einzigartigen Geräte, auf denen die In-App angezeigt wurde.
interactions	number	Interaktionen mit dem In-App-Inhalt: Klicks auf Schaltflächen, Klicks auf Links und Formularübermittlungen.
unique_interactions	number	Anzahl der einzigartigen Geräte, die mit der In-App interagiert haben.
skips	number	Wie oft Benutzer die In-App geschlossen haben, ohne zu interagieren.
audience	number	Anzahl der einzigartigen Geräte, die im Zeitraum ein beliebiges In-App-Ereignis ausgelöst haben.

Hinweis

Einzigartige Metriken und audience sind Näherungswerte, da sie eine probabilistische Zählung eindeutiger Werte verwenden. Plattformzahlen summieren sich nicht zur Kampagnengesamtsumme: Ein Gerät, das auf zwei Plattformen erscheint, wird einmal in jeder Plattformaufschlüsselung und einmal in der Kampagnengesamtsumme gezählt.

inapps:totals

Gibt die Gesamtsummen für den Zeitraum zurück. Übergeben Sie inapp_codes, um über bestimmte Kampagnen zu berichten, oder lassen Sie es weg, um jede In-App der Anwendung Seite für Seite zu durchlaufen. Dies ist die Methode, die für einen geplanten Export zu verwenden ist.

POST https://api.pushwoosh.com/api/v2/statistics/inapps:totals

Header

Name	Erforderlich	Beschreibung
Authorization	Ja	Server-API-Token im Format Authorization: Api <Server Key>.

Parameter des Anfragekörpers

Name	Erforderlich	Typ	Beschreibung
application	Ja	String	Anwendungscode.
date_range	Ja	Object	Berichtszeitraum. date_from und date_to verwenden das Format JJJJ-MM-TT und sind inklusive. Der Zeitraum wird in UTC gezählt und darf 366 Tage nicht überschreiten.
inapp_codes	Nein	Array	In-App-Codes, bis zu 100 pro Anfrage. Weglassen, um über alle In-Apps der Anwendung zu berichten. Wenn ein Code in der Liste nicht zur Anwendung gehört, schlägt die gesamte Anfrage mit 404 fehl.
platforms	Nein	Array	Beschränken Sie die Metriken auf diese Plattformen. Mögliche Werte: "IOS", "ANDROID", "HUAWEI_ANDROID", "AMAZON", "OSX", "WINDOWS", "SAFARI", "CHROME", "FIREFOX", "WEB".
with_platforms	Nein	Boolean	Fügen Sie jedem Element eine Aufschlüsselung pro Plattform hinzu.
page	Nein	Integer	Seitenzahl, beginnend bei 0. Gilt, wenn inapp_codes weggelassen wird.
per_page	Nein	Integer	Elemente pro Seite, standardmäßig 20, maximal 100.

Beispielanfrage

curl -X POST https://api.pushwoosh.com/api/v2/statistics/inapps:totals \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "application": "XXXXX-XXXXX",
    "date_range": {
      "date_from": "2026-07-01",
      "date_to": "2026-07-31"
    },
    "inapp_codes": ["AAAAA-BBBBB"],
    "with_platforms": true
  }'

Antwortfelder

total ist die Anzahl der In-Apps, die der Anfrage entsprechen. Wenn inapp_codes weggelassen wird, sind das alle In-Apps der Anwendung, sodass die Paginierung sie durchlaufen kann. items enthält die aktuelle Seite. page zählt ab 0.

Beispielantwort

{
  "total": 1,
  "page": 0,
  "per_page": 20,
  "items": [{
    "inapp": {
      "code": "AAAAA-BBBBB",
      "name": "Summer sale",
      "status": "active",
      "rich_media_code": "CCCCC-DDDDD"
    },
    "metrics": {
      "impressions": 15230,
      "unique_impressions": 9120,
      "interactions": 2311,
      "unique_interactions": 1980,
      "skips": 640,
      "audience": 9120
    },
    "platforms": [{
      "platform": "IOS",
      "metrics": {
        "impressions": 8100,
        "unique_impressions": 4900,
        "interactions": 1300,
        "unique_interactions": 1120,
        "skips": 310,
        "audience": 4900
      }
    }],
    "frequency_capping": {
      "suppressions": 45,
      "affected_users": 30,
      "data_available_from": "2026-07-17"
    }
  }]
}

inapps:timeline

Gibt die Gesamtsummen des Zeitraums und eine Zeitreihe für eine In-App-Kampagne zurück.

POST https://api.pushwoosh.com/api/v2/statistics/inapps:timeline

Parameter des Anfragekörpers

Name	Erforderlich	Typ	Beschreibung
application	Ja	String	Anwendungscode.
inapp_code	Ja	String	In-App-Code.
date_range	Ja	Object	Berichtszeitraum. date_from und date_to verwenden das Format JJJJ-MM-TT und sind inklusive. Der Zeitraum wird in UTC gezählt und darf 366 Tage nicht überschreiten. Optionales interval: "HOUR", "DAY" (Standard), "WEEK" oder "MONTH". "HOUR" ist für Zeiträume von bis zu 31 Tagen verfügbar.
platforms	Nein	Array	Beschränken Sie die Metriken auf diese Plattformen.
with_platforms	Nein	Boolean	Fügen Sie den Gesamtsummen und jeder Zeile eine Aufschlüsselung pro Plattform hinzu.

Beispielanfrage

curl -X POST https://api.pushwoosh.com/api/v2/statistics/inapps:timeline \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "application": "XXXXX-XXXXX",
    "inapp_code": "AAAAA-BBBBB",
    "date_range": {
      "date_from": "2026-07-01",
      "date_to": "2026-07-07",
      "interval": "DAY"
    }
  }'

Beispielantwort

{
  "inapp": {
    "code": "AAAAA-BBBBB",
    "name": "Summer sale",
    "status": "active",
    "rich_media_code": "CCCCC-DDDDD"
  },
  "totals": {
    "impressions": 15230,
    "unique_impressions": 9120,
    "interactions": 2311,
    "unique_interactions": 1980,
    "skips": 640,
    "audience": 9120
  },
  "frequency_capping": {
    "suppressions": 45,
    "affected_users": 30,
    "data_available_from": "2026-07-17"
  },
  "rows": [{
    "timestamp": "2026-07-01T00:00:00Z",
    "metrics": {
      "impressions": 2140,
      "unique_impressions": 1700,
      "interactions": 320,
      "unique_interactions": 290,
      "skips": 95,
      "audience": 1700
    }
  }],
  "impression_duration": [
    { "from_seconds": 0, "to_seconds": 5, "count": 3200 },
    { "from_seconds": 5, "to_seconds": 15, "count": 5400 },
    { "from_seconds": 15, "to_seconds": 30, "count": 4100 },
    { "from_seconds": 30, "to_seconds": 0, "count": 2530 }
  ]
}

impression_duration unterteilt, wie lange die In-App auf dem Bildschirm blieb. Im letzten Bucket ist to_seconds 0, was „30 Sekunden und länger“ bedeutet.

Frequency Capping

Der frequency_capping-Block meldet In-App-Anzeigen, die durch Frequency Capping verhindert wurden, und die Anzahl der betroffenen einzigartigen Benutzer. Unterdrückungen werden nicht in impressions gezählt.

Unterdrückungsdaten beginnen am 17. Juli 2026

Unterdrückungen wurden vor diesem Datum nicht aufgezeichnet. Für einen Zeitraum, der früher endet, wird der frequency_capping-Block als null anstelle von Nullen zurückgegeben, sodass ein Mangel an Daten niemals mit einem Capping verwechselt wird, das nichts unterdrückt hat. data_available_from in der Antwort gibt den ersten abgedeckten Tag an. Frequency Capping hat keine Aufschlüsselung pro Plattform.

Datenaufbewahrung

Statistiken werden 365 Tage lang aufbewahrt, sodass ein Zeitraum, der früher beginnt, keine Daten für die nicht abgedeckten Tage zurückgibt.

Antwortcodes

Code	Bedeutung
200	Erfolg.
400	Ungültige Anfrage: ein fehlender oder fehlerhafter date_range, ein Zeitraum länger als 366 Tage, ein stündliches Intervall über mehr als 31 Tage oder mehr als 100 inapp_codes.
401	Fehlender oder ungültiger API-Token.
404	Ein In-App-Code wurde in dieser Anwendung nicht gefunden.