Correct product analytics cohorts and reporting

2026-08-21 17:50:35 +08:00
parent b25f5ae6e9
commit edd0d9feca
31 changed files with 1134 additions and 262 deletions
@@ -28,7 +28,10 @@ regardless of account linkage.
 - Authentication is optional so first-open and pre-login events can be
  measured. Invalid bearer credentials are rejected.
 - `installationId` must be a client-generated UUID stored in the containing app
-  and shared with the keyboard extension through the App Group.
+  and shared with the keyboard extension through the App Group. New clients send
+  it once at the batch root. During the migration window, the server also accepts
+  released clients that repeat one identical `installationId` on every event;
+  missing, incomplete, or conflicting identities reject the entire batch.
 - When a valid account session is present, the installation is linked to that
  account. An installation cannot later be linked to a different account.
 - Every `clientEventId` is a client-generated UUID. The pair