Ihre Vorteile
Mit Analytics API von Showpad können Sie alles generieren und herunterladen, was Sie in dem Berichte-Abschnitt auf der Online Plattform von Showpad sehen. Wann wurde ein Asset angesehen, wie lange wird es angesehen? Wer hat welches Asset mit wem geteilt?
Mit der Analytics-API von Showpad können Sie die Rohdaten als CSV- oder JSON-Datei herunterladen, damit Sie sie in Ihrer eigenen BI-Lösung verwenden und mit anderen Datenquellen in Ihrer Organisation kombinieren können und benutzerdefinierte Analysen ausführen können. Die Analytics-API berücksichtigt auch die Anonymisierung von Benutzernamen und IDs. Sie können weiterhin Tabellen verknüpfen, um die Daten zu analysieren.
Es kann einen Unterschied zwischen den Daten geben, die vom API Export zurückkommen und den Analytics in der Online Plattform von Showpad. Die von der API zurückgegebene CSV-Datei ist detaillierter und enthält alle Rohdaten. Die tabellarischen Daten in unserer Online Plattform für die Anzeige von Summen und Top-Inhalten können vom Roh-API-Datenexport abweichen. Dies wird im Folgenden näher erläutert.
Sehen Sie es sich an
Verwenden Sie den Ereignisendpunkt, um die Freigabedaten zurückzugeben, die Sie für andere Exportendpunkte benötigen.
Hauptfunktionen
- Laden Sie detaillierte Daten im CSV- und JSON-Format herunter
- Importieren Sie die Daten nach dem Export in Ihre benutzerdefinierten Tools
- Passen Sie die maximale Anzahl der zurückgegebenen Antworten an
- Nur GET kann Analysedaten empfangen
- Falls aktiviert, respektieren wir die Anonymisierung der Benutzernamen und IDs in den Ergebnissen
Was Sie für den Erfolg benötigen
- Den ultimativen Preisplan von Showpad
- Zugriff auf die Online Plattform von Showpad
- Kenntnisse über APIs
- Showpad, API Explorer, REST-Clients und Befehlszeilen sind für Sie kein Rätsel
- Beachten Sie, dass die Rohdaten für den Export von den in der Online Plattform tabellierten Daten für die Anzeige von Summen und Top-Inhalten abweichen können
Steuern Sie zurückgegebene Artikel mit dem X-Showpad-Scroll-Id-Header
- Standardmäßig ist die maximale Anzahl der zurückgegebenen Elemente im Ereignis-API-Endpunkt auf 500 festgelegt. Sie können das Limit ändern und einen Bereich zwischen 50 und 1000 Antworten einstellen. Die Antwort wird mit einem Header namens X-Showpad-Scroll-ID geliefert, der ein Token enthält. Wenn Sie dieselbe Anfrage erneut stellen, diesen Header jedoch für Ihre Anfrage festlegen, erhalten Sie den zweiten Stapel von Ereignissen. Sie erhalten eine weitere X-Showpad-Scroll-ID zurück, mit der Sie den dritten Stapel von Ereignissen usw. abrufen können. Auf diese Weise können Sie eine Schleife in der Anwendung ausführen, bis alle gewünschten Ereignisse abgerufen wurden. Wenn keine Ereignisse als Antwort zurückgegeben werden, zeigt dies das Ende an. Es gibt Millionen von Ereignissen in der Datenbank und es ist nicht möglich, alles auf einmal zurückzugeben. Sie können also einen Bildlauf durchführen, bis Sie alle gewünschten Ereignisse haben.
- Die Ergebnisse des Events API-Exports sind begrenzt und Sie müssen den X-Showpad-Scroll-Id-Header verwenden, um weiterhin Daten zu empfangen.
- Der X-Showpad-Scroll-Id-Header wird nicht bei jedem Anruf / jeder Antwort geändert. Sie bleibt x-mal gültig. Verwenden Sie daher für die nächste Anforderung immer den Header X-Showpad-scroll-id aus der Antwort.
Der Header gibt der API einen Anhaltspunkt, wer den Aufruf vornimmt, und gibt den nächsten Berichtsstapel zurück. Er ist vergleichbar mit einem Authentifizierungsschlüssel.
Wichtige Fakten zu den zurückgegebenen Daten
- Bei der Prüfung der Ansichts-Daten ist es möglich, dass sich die Zahlen im Reports-Abschnitt unserer Online Plattform und die aus dem API Export unterscheiden. Wenn ein potenzieller Kunde auf Inhalte von einer Freigabe klickt und diese anzeigt und den Computer verlässt, zählt Showpad weiterhin die Stunden, in denen die Inhalte geöffnet waren. In Showpads Online Plattform werden diese Daten tabelliert und auf 1 Stunde begrenzt. In den Rohdaten wird jedoch bis zu 8 Stunden lang gezählt.
- In der Online Plattform Top Inhalte-Bericht werden Freigaben in Tabellenform angegeben, wie oft ein Teil des Inhalts für eine Person freigegeben wurde. Ein Dokument, das mit 2 Personen gleichzeitig geteilt wird, zählt als 2 Freigaben. Wenn Sie den Bericht „Top Inhalt“ überprüfen, werden beispielsweise 100 Freigaben angezeigt. Dies zeigt, welche Benutzer in der App Inhalte geteilt haben. Diese 100 stehen für 100 verschiedene Benutzer. Beim API-Export werden die detaillierten Daten angezeigt. Wenn Sie also richtig hinzugefügt werden, erhalten Sie dieselben Zahlen.
- Um die Daten im CSV-Format zu exportieren, ändern Sie einfach die JSON-Erweiterung mit CSV in Ihrem Curl-Befehl. Dies gibt eine CSV-Datei zurück, die Sie in Ihren benutzerdefinierten Tools verwenden können.
Sehen Sie sich an, wie es im Showpad API Explorer funktioniert
- Sie können über die Online Plattform auf unseren API Explorer zugreifen: Einstellungen - Integrationen - API.
Um direkt auf den API Explorer zuzugreifen, rufen Sie https://{yourSubdomain}.showpad.biz/devportal/explorer auf. - Wechseln Sie zur API v3, um die Analytics-API zu verwenden.
- Öffnen Sie den API Explorer und öffnen Sie Exporte.
- Sie sehen alle verfügbaren Export-Endpunkte. Diese geben Ihnen alle Rohdaten über Vermögenswerte, Abteilungen, Kanäle,...
- Für den Analytics-Teil ist der Events-Endpunkt der wichtigste. Dieser Endpunkt enthält alle Freigabedaten und zeigt beispielsweise an, welche Benutzer-ID was mit welcher Kontakt-ID geteilt hat.
Weitere Informationen zum Exportieren von Ereignissen (/API/v3/exports/events.JSON)
App geöffnet
Ein Verkaufs-Benutzer öffnete die Showpad App
Asset-in-App-Ansicht
Asset wurde von einem Verkäufer/Adminnutzer in der Showpad App angesehen
Shared-Asset-viewed
Möglicher Kunde hat einen Asset in einer Freigabe angezeigt
Asset-Shared
Ein Vertriebsbenutzer hat ein Asset für einen potenziellen Nutzer freigegeben
Shared-Asset-Downloaded
Ein potenzieller Kunde lädt ein Asset herunter, das mit ihm geteilt worden ist.
Anteil angesehen
Ein Anteil ist von einem Interessenten angesehen worden
Share-created
Ein Anteil ist von einem Verkaufsbenutzer versandt worden
E-Mail-Freigabe geöffnet
Ein potenzieller Kunde hat die E-Mail mit einer Freigabe geöffnet
- Verwenden Sie diese Daten, um Beziehungen zu den anderen Exportendpunkten herzustellen.