feat: Add new event tracking page (#582)

* feat: Add new event tracking page

* fix nit

* add TODOs

* fix more broken links

* Update docs/sdks/event-logging/event-tracking.md

Co-authored-by: Eric Metelka <[email protected]>

* rename and fix links

* add js config

* add more details

* event logging section to javascript quickstart. tweaks to event tracking page

* data organization, and SDK configuration updates

* fix broken link

* minor reword

* fix track calls

---------

Co-authored-by: Eric Metelka <[email protected]>
Co-authored-by: Eric Petzel <[email protected]>
Co-authored-by: Eric Petzel <[email protected]>

Author: 3 people

docs/data-management/definitions/assignment-sql.md

@@ -73,7 +73,7 @@ We'll now provide a step-by-step walkthrough for creating Assignment SQL Definit
 ![Write Assignment SQL Query](/img/building-experiments/add-assignment-sql-query.png)
 
 :::info
-If you do not yet have assignment logs in your warehouse, see the [Event Logging page](/sdks/event-logging).
+If you do not yet have assignment logs in your warehouse, see the [Assignment Logging page](/sdks/event-logging/assignment-logging/).
 :::
 
 5. After clicking **Run**, you'll see some sample data. Annotate these columns into Eppo's data model using the right panel:

docs/guides/index.md

@@ -21,5 +21,5 @@ Don't hesitate to shoot us an email at [email protected].
 
 ## Experimentation
 
-- Learn how to set up [event logging](/sdks/event-logging/) with Segment, Rudderstack, mParticle, or Snowplow.
+- Learn how to set up [assignment logging](/sdks/event-logging/assignment-logging/) with Segment, Rudderstack, mParticle, or Snowplow.
 - Analyze experiments with [anonymous user IDs](/guides/advanced-experimentation/anonymous-explainer).

docs/guides/marketing/integrating-with-webflow.md

@@ -109,7 +109,7 @@ window.eppo.init(opts).then(setHeader);
 
 - Provide your SDK key and Feature Flag key in the `'<SDK-KEY>'` and `'<FEATURE-FLAG-KEY>'` placeholders above.
 - Provide the id you are going to use for analytics logging to `'<SUBJECT-ID>'`. Ideally this would be an id from a managed platform such as Segment, Rudderstack, Google Analytics, or an internal platform.
-- Add your client side analytics tracking call once the assignment has been made. Make sure your analytics platform is sending data to your data warehouse connected to Eppo. This will ensure that assignments made by Eppo will be tracked and can be used for experiment analysis. For more information on Eppo's event logging integrations with popular platforms like Segment, mParticle, Rudderstack, and Snowplow, see our documentation [here](/sdks/event-logging).
+- Add your client side analytics tracking call once the assignment has been made. Make sure your analytics platform is sending data to your data warehouse connected to Eppo. This will ensure that assignments made by Eppo will be tracked and can be used for experiment analysis. For more information on Eppo's event logging integrations with popular platforms like Segment, mParticle, Rudderstack, and Snowplow, see our documentation [here](/sdks/event-logging/assignment-logging/).
 
 ## Edge cases
 
@@ -120,4 +120,3 @@ If you end up using a subject key or user traits from a cookie, make sure that t
 ## Demo
 
 To see a demo of the Webflow integration in action, see this link: https://star-wars-demo.webflow.io/. 
-

docs/guides/migrations/launchdarkly-migration.md

@@ -3,7 +3,7 @@
 1. **Install the Eppo SDK**
     - Login to Eppo with your work email: https://eppo.cloud/
     - [Generate an SDK key](https://docs.geteppo.com/sdks/sdk-keys) by navigating to “SDK Keys” under Configuration
-    - [Define a logging function](https://docs.geteppo.com/sdks/event-logging/) for the Eppo SDK to log assignments so they end up in your data warehouse.
+    - [Define a logging function](https://docs.geteppo.com/sdks/event-logging/assignment-logging/) for the Eppo SDK to log assignments so they end up in your data warehouse.
 
       *TypeScript Example:*
 
@@ -290,4 +290,4 @@
     ```tsx
     const values = 
       getInstance().getJSONAssignment(userId, featureKey, attributes);
-    ```
+    ```

docs/guides/migrations/optimizely-migration.md

@@ -3,7 +3,7 @@
 1. **Install the Eppo SDK**
     - Login to Eppo with your work email: https://eppo.cloud/
     - [Generate an SDK key](/sdks/sdk-keys) by navigating to “SDK Keys” under Configuration
-    - [Define a logging function](/sdks/event-logging/) for the Eppo SDK to log assignments so they end up in your data warehouse
+    - [Define a logging function](/sdks/event-logging/assignment-logging/) for the Eppo SDK to log assignments so they end up in your data warehouse
 
         *TypeScript Example:*
 

docs/quick-starts/bandit-quickstart.md

@@ -27,7 +27,7 @@ Store the SDK key securely; it is not possible to view it after closing the moda
 
 Eppo leverages your existing event logging infrastructure to track experiment assignments. Whether you use a third-party system to log events to the data warehouse or have an internally built solution, you'll simply pass in a logging function when initializing the SDK.
 
-The [event logging](/sdks/event-logging/) page has more information on how to set up logging using different logging tools.
+The [Assignment event logging](/sdks/event-logging/assignment-logging/) page has more information on how to set up logging using different logging tools.
 
 This logger should write to a table with columns with the following names (they can be in any order):
 * **timestamp** - Timestamp of the bandit assignment
@@ -46,7 +46,7 @@ Additional information that is provided to the logger that can optionally--but i
 * **optimality_gap** - The difference between the score of the selected action and the highest-scored action
 * **metadata** - Any additional freeform metadata, in JSON format, such as the version of the SDK
 
-Below is an example bandit assignment logger for the Java SDK, defined when building the SDK client. This example writes directly to Snowflake. This is illustrative and not recommended practice. Refer to our [event logging](/sdks/event-logging/) page for recommended options.
+Below is an example bandit assignment logger for the Java SDK, defined when building the SDK client. This example writes directly to Snowflake. This is illustrative and not recommended practice. Refer to our [assignment logging](/sdks/event-logging/assignment-logging/) page for recommended options.
 
 ```java
 .banditLogger(logData -> {

docs/sdks/client-sdks/android/assignments.mdx

@@ -37,8 +37,8 @@ import cloud.eppo.android.EppoClient;
 EppoClient eppoClient = EppoClient.getInstance();
 
 String flagKey = "new-landing-page";
-String subjectKey = getUserId() != null ? getUserId() : "anonymous";Map<String, Object> 
-subjectAttributes = new HashMap<>();
+String subjectKey = getUserId() != null ? getUserId() : "anonymous";
+Map<String, Object> subjectAttributes = new HashMap<>();
 subjectAttributes.put("country", "US");
 subjectAttributes.put("device", "android");
 String defaultValue = "control";
@@ -155,7 +155,7 @@ EppoClient eppoClient = new EppoClient.Builder("YOUR_SDK_KEY", getApplication())
 ```
 
 :::note
-More details about logging and examples can be found in the [event logging](/sdks/event-logging/) page.
+More details about logging and examples can be found in the [assignment logging](/sdks/event-logging/assignment-logging/) page.
 :::
 
 ## Debugging Assignments
@@ -175,4 +175,4 @@ AssignmentDebugInfo debugInfo = eppoClient.getAssignmentDebugInfo(
 Log.d("Eppo", "Assignment debug info: " + debugInfo.toString());
 ```
 
-For more information about debugging, see the [debugging documentation](/sdks/sdk-features/debugging-flag-assignment). 
+For more information about debugging, see the [debugging documentation](/sdks/sdk-features/debugging-flag-assignment).

docs/sdks/client-sdks/android/quickstart.mdx

@@ -35,7 +35,7 @@ public class MyApplication extends Application {
     @Override
     public void onCreate() {
         super.onCreate();
-        
+
         // Initialize the SDK
         try {
             EppoClient eppoClient = new EppoClient.Builder("YOUR_SDK_KEY", this)
@@ -96,7 +96,7 @@ public class MyApplication extends Application {
     @Override
     public void onCreate() {
         super.onCreate();
-        
+
         // Create assignment logger
         AssignmentLogger logger = new AssignmentLogger() {
             @Override
@@ -165,5 +165,5 @@ JSONObject config = eppoClient.getJSONAssignment(key, subject, attributes, defau
 Now that you have the basics working, here are some advanced topics to explore:
 
 - [Advanced SDK Initialization](/sdks/client-sdks/android/initialization)
-- [Assignment Logging Setup](/sdks/event-logging)
-- [Debugging Flag Assignments](/sdks/sdk-features/debugging-flag-assignment)
+- [Assignment Logging Setup](/sdks/event-logging/assignment-logging/)
+- [Debugging Flag Assignments](/sdks/sdk-features/debugging-flag-assignment)

docs/sdks/client-sdks/ios/assignments.mdx

@@ -9,10 +9,10 @@ Assignments are the mechanism through which a given [Subject](/sdks/sdk-features
 
 ## How Assignments Work
 
-The SDK retrieves configuration rules from the Eppo server in two cases: 
+The SDK retrieves configuration rules from the Eppo server in two cases:
 
-1. when starting a new session 
-2. when calling the load function. 
+1. when starting a new session
+2. when calling the load function.
 
 These rules determine variant assignments for subjects. All assignment evaluations happen locally, without additional network requests.
 
@@ -208,5 +208,5 @@ struct ContentView: View {
 
 
 :::note
-More details about logging and examples can be found in the [event logging](/sdks/event-logging/) page.
+More details about logging and examples can be found in the [assignment logging](/sdks/event-logging/assignment-logging/) page.
 :::

docs/sdks/client-sdks/ios/initialization.mdx

@@ -42,7 +42,7 @@ When using the SDK for experiments (rather than just feature flags), you'll need
 
 ```swift
 eppoClient = try await EppoClient.initialize(
-    sdkKey: "mock-sdk-key", 
+    sdkKey: "mock-sdk-key",
     assignmentLogger: segmentAssignmentLogger
 )
 
@@ -58,7 +58,7 @@ func segmentAssignmentLogger(assignment: Assignment) {
     ]
 
     analytics.track(
-        name: "Eppo Assignment", 
+        name: "Eppo Assignment",
         properties: TrackProperties(assignmentDictionary)
     )
 }
@@ -141,7 +141,7 @@ It is recommended to use the `load()` method to fetch the latest flag configurat
 
 The SDK will invoke the `logAssignment` function with an `Assignment` object that contains the following fields:
 
-<ApiOptionRef 
+<ApiOptionRef
   name="timestamp"
   type="string"
   defaultValue=""
@@ -150,7 +150,7 @@ The SDK will invoke the `logAssignment` function with an `Assignment` object tha
 The time when the subject was assigned to the variation. Example: `"2021-06-22T17:35:12.000Z"`
 </ApiOptionRef>
 
-<ApiOptionRef 
+<ApiOptionRef
   name="featureFlag"
   type="string"
   defaultValue=""
@@ -159,7 +159,7 @@ The time when the subject was assigned to the variation. Example: `"2021-06-22T1
 An Eppo feature flag key. Example: `"recommendation-algo"`
 </ApiOptionRef>
 
-<ApiOptionRef 
+<ApiOptionRef
   name="allocation"
   type="string"
   defaultValue=""
@@ -168,7 +168,7 @@ An Eppo feature flag key. Example: `"recommendation-algo"`
 An Eppo allocation key. Example: `"allocation-17"`
 </ApiOptionRef>
 
-<ApiOptionRef 
+<ApiOptionRef
   name="experiment"
   type="string"
   defaultValue=""
@@ -177,7 +177,7 @@ An Eppo allocation key. Example: `"allocation-17"`
 An Eppo experiment key. Example: `"recommendation-algo-allocation-17"`
 </ApiOptionRef>
 
-<ApiOptionRef 
+<ApiOptionRef
   name="subject"
   type="string"
   defaultValue=""
@@ -186,7 +186,7 @@ An Eppo experiment key. Example: `"recommendation-algo-allocation-17"`
 An identifier of the subject or user assigned to the experiment variation. Example: UUID
 </ApiOptionRef>
 
-<ApiOptionRef 
+<ApiOptionRef
   name="subjectAttributes"
   type="[String: EppoValue]"
   defaultValue="[:]"
@@ -195,7 +195,7 @@ An identifier of the subject or user assigned to the experiment variation. Examp
 A dictionary mapping String keys to EppoValue values. These attributes are used for targeting and are only logged if passed to the SDK assignment function. EppoValue can be a String, Number, or Boolean.
 </ApiOptionRef>
 
-<ApiOptionRef 
+<ApiOptionRef
   name="variation"
   type="string"
   defaultValue="undefined"
@@ -205,5 +205,5 @@ The experiment variation the subject was assigned to. Example: `"control"`
 </ApiOptionRef>
 
 :::note
-More details about logging and examples (with Segment, Rudderstack, mParticle, and Snowplow) can be found in the [event logging](/sdks/event-logging/) page.
-:::
+More details about logging and examples (with Segment, Rudderstack, mParticle, and Snowplow) can be found in the [assignment logging](/sdks/event-logging/assignment-logging/) page.
+:::