In diesem Beitrag erkl\u00e4re ich wie unser neuer StatsManager im Hintergrund funktioniert und wie dieser per API angesteuert und benutzt werden kann.<\/p>\n\n\n\n
Zuerst ein paar Begriffe kl\u00e4ren:<\/p>\n\n\n\n
F\u00fcr Riddle selbst gibt es drei Namespaces:<\/p>\n\n\n\n
Diese sind wie „Schubladen“. Das hei\u00dft, dass in jeder dieser Schubladen Stats f\u00fcr alle diese Teilbereiche liegen. So kannst du zum Beispiel auch abfragen, wie viele Stats ein Team am Tag bekommen hat indem du im Namespace „team“ den Tag (z.B. „2021-15-01“) queriest.
Wenn du den selben Tag im Namespace „rid“ queriest, bekommst du zur\u00fcck wie viele Stats an diesem Tag f\u00fcr die spezifierte RiddleID reinkamen.
Die Magie dahinter ist, dass wir uns dadurch viel sparen k\u00f6nnen, da alles schon vorkalkuliert ist. Es ist zum Beispiel nicht n\u00f6tig \u00fcber alle Riddles eines Teams\/Users zu iterieren um dessen Gesamtstats zu bekommen – das regelt alles bereits der Namespace und summiert diese Stats bereits auf.
So w\u00e4re es z.B. auch m\u00f6glich schlau zu kombinieren: Wenn alle Riddle eines Teams bis auf eins summiert werden sollen, k\u00f6nnte man die Team Stats nehmen und die Stats von dem ausgeschlossenen Riddle abziehen.<\/p>\n\n\n\n
In der API gibt es das Param „entityId“ oder bei mehreren Entities auch „entityIds“. Das sind einfach die unique EntityIDs aus der Datenbank. Nat\u00fcrlich muss man dann aufpassen, dass man Namespace und die EntityID richtig matcht. Wenn man Namespace=’team‘ und die EntityID eines Riddles w\u00e4hlt, kann es nat\u00fcrlich nicht funktionieren.<\/p>\n\n\n\n
Bei jedem Zugriff auf den StatsManager muss man spezifizieren welchen Zeitraum man ausw\u00e4hlt. Z.B. from => „2021-15-01“ und to => „2021-18-01“. Das ist dann 15. bis 18. Januar 2021.<\/p>\n\n\n\n
Fetch liefert ein Dokument<\/strong> mit vielen Details, d.h. z.B. alle individuellen Answers. Diese Art von Fetch sollte genutzt werden wenn man f\u00fcr eine individuelle Entity ALLE <\/em><\/strong>Infos returnt haben m\u00f6chte.<\/p>\n\n\n\n URL: <\/strong>\/creator\/stats-v2\/fetch\/{namespace}\/{entityId}\/{from}\/{to} Bulk-Fetch droppt die Stats die das Stats-Array \u00fcberladen. Wenn mehrere Riddles\/Teams aufsummiert werden, sammeln sich sehr viele individuelle Answers an und der Speicher wird \u00fcberschritten => diese werden nicht beachtet. URL: <\/strong>\/creator\/stats-v2\/bulk-fetch\/{namespace}\/{from}\/{to} Die dritte Art von Fetch ist „Overview-Fetch“. Dieses gliedert den Zeitraum zwischen from<\/strong> & to<\/strong> in Tage auf und gibt je ein Stats-Array pro Tag zur\u00fcck. In diesem Beitrag erkl\u00e4re ich wie unser neuer StatsManager im Hintergrund funktioniert und wie dieser per API angesteuert und benutzt werden kann. Begriffe Zuerst ein…<\/p>\n
Beispiel:<\/strong> Alle Stats f\u00fcr Team mit der ID 800 vom 01.01.21 bis zum 31.12.21
– namespace: team
– entityId: 800
– from: 2021-01-01
– to: 2021-12-31<\/p>\n\n\n\n
Bulk-Fetch<\/strong> summiert mehrere EntityIDs auf<\/strong>, liefert jedoch nur ein Stats-Array zur\u00fcck (=> aufsummiert).<\/p>\n\n\n\n
Param <\/strong>namespace: Hier bedeutet namespace so viel wie: Wenn ‚team‘, dann zeig dem User all die Stats, die f\u00fcr Team-User relevant sind (keine individuellen Riddles); das Gleiche dann mit User
Beispiel:<\/strong> Alle Stats f\u00fcr einen User in der Statistics Team-\u00dcbersicht
– namespace: team
– from: 2021-01-01
– to: 2021-12-31
Folgende Kategorien + Stats werden aggregiert:<\/p>\n\n\n\npublic function getCategoriesAndLabels(): array\n {\n return [\n 'core_metrics' => [\n 'view',\n 'start',\n 'finish',\n 'lead',\n 'time',\n ],\n 'device' => [\n 'desktop',\n 'mobile',\n 'tablet',\n ],\n 'social' => [\n 'fbMessenger',\n 'whatsapp',\n 'facebook',\n 'twitter',\n 'linkedin',\n ],\n 'form' => [\n 'skip',\n 'view',\n ],\n 'region' => $this->getAllRegions(),\n ];\n }<\/code><\/pre>\n\n\n\n
Das ist zum Beispiel sehr hilfreich bei einer Historie oder wenn man die Stats-Werte von jeglichen Entities \u00fcber einen gewissen Zeitraum vergleichen will.
URL: <\/strong>\/creator\/stats-v2\/overview-fetch\/{namespace}\/{entityId}\/{from}\/{to}<\/p>\n","protected":false},"excerpt":{"rendered":"