From 8d3de4b08235cfd689328cdf91a0c3d3f22a4559 Mon Sep 17 00:00:00 2001
From: immber <jessiekrushing@gmail.com>
Date: Wed, 26 Feb 2020 09:29:42 -0800
Subject: [PATCH] [DOCS DAY] added event tracking to v5 section (#2857)

* added event tracking to v5 section

* Add SEO docs and cleanup sidebar

* Fixes raw html in SSO docs

* fixed typo on sso page

Co-authored-by: Kim Gardner <kgardnr@gmail.com>
Co-authored-by: Vinh <vinh@vinh.tech>
---
 docs/_config.yml                |  2 ++
 docs/source/version-5-events.md | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 34 insertions(+)
 create mode 100644 docs/source/version-5-events.md

diff --git a/docs/_config.yml b/docs/_config.yml
index d5a83a62d..eb89b4bdf 100644
--- a/docs/_config.yml
+++ b/docs/_config.yml
@@ -110,6 +110,8 @@ sidebar:
               url: /v5/integrating/counts/
             - title: Moderating via Slack
               url: /v5/integrating/slack/
+            - title: Event tracking
+              url: /v5/integrating/events/
             - title: SEO & iframes
               url: /v5/seo/
         - title: API
diff --git a/docs/source/version-5-events.md b/docs/source/version-5-events.md
new file mode 100644
index 000000000..e8e8e480a
--- /dev/null
+++ b/docs/source/version-5-events.md
@@ -0,0 +1,32 @@
+---
+title: Event Tracking
+permalink: /v5/integrating/events/
+---
+
+The Coral embed script can emit events to the analytics tool of your choice. Common user actions, such as successfully posting a comment, posting a reaction, or changing a setting are all capturable with events. 
+
+## Analytics Tool Integration
+
+To enable event tracking, modify your embed script to subscribe to the events hook. You will also need to add code to your page that sends the events to your analytics system. The particular way you send this will depend on what tool you’re using. Refer to your tool’s API and docs to determine this.
+
+In this example, we’re logging all events to the console as well as sending the `createComment.success` event.
+
+```js
+<script>
+  const CoralStreamEmbed = Coral.createStreamEmbed({
+    events: function(events) {
+      events.onAny(function(eventName, data) {
+        console.log(eventName, data);
+        if (eventName === 'createComment.success') {
+          my_event_tracker.send('createComment', data);
+      });
+    },
+  });
+</script>
+```
+
+
+
+## Available Events
+
+A complete list of trackable events is available on GitHub: https://github.com/coralproject/talk/blob/master/CLIENT_EVENTS.md
\ No newline at end of file