Skip to content

Conversation

@zc632995195
Copy link
Contributor

@zc632995195 zc632995195 commented Dec 23, 2025

Background

I did in 2 commits:

  • 1st commit is the update of streaming transformation limit I need --> basically highlight/add what we improve on Q4 2025
  • 2nd commit is what Claude Code improves on this doc.

Let me know if they are good, or I can revert 2nd commit if needed.


Note

Refreshes the streaming-transformations.md doc for clarity and completeness.

  • Setup: Clearer step-by-step flow (server secret key, enabling "Send events", explicit selection of events/properties/user properties)
  • Examples: Split into focused cases for AppsFlyer (renamed events) and Braze (derived properties)
  • Payload/selection: Clarifies that only explicitly selected transformations are streamed; explains nested JSON structure and field naming
  • Performance: Rephrases p95 latency target to "60 seconds" and clarifies expectation
  • Limitations: Expands with unsupported types (non-compliant custom events, group/cart/nested properties), notes Data Warehouse exclusion, and details channel classifiers/lookup properties access and behavior
  • FAQ: Updates wording (selecting raw vs transformed, channel classifier enablement) for precision

Written by Cursor Bugbot for commit 442f5a6. This will update automatically on new commits. Configure here.

@zc632995195 zc632995195 requested review from a team December 23, 2025 19:44
@vercel
Copy link

vercel bot commented Dec 23, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
amplitude-docs Ready Ready Preview Dec 23, 2025 10:02pm

* The **Select and filter events** section (for example, filtering where a derived property is not null)
* The **Select additional properties** section
* The **Map properties to destination** section (if applicable)
* **Select and filter events** - For example, filtering events where a derived property is not null
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code term missing backticks formatting (Bugbot Rules)

Violates the Code and Technical Terms rule requiring backticks for technical terms. The word "null" in "where a derived property is not null" is a programming/code term and needs to be formatted with backticks as null.

Fix in Cursor Fix in Web

* **Lookup properties**: You can stream lookup properties by requesting access from Amplitude. Lookup properties map existing event or user properties to new properties using a CSV file upload, and can enrich already-ingested events at query time.
* Lookup property files with over 1000 rows won't display in the streaming setup.
* After saving a lookup property file, it can take up to 1 hour to populate into the streaming system.
* **Channel classifiers**: Streaming channel classifiers requires requesting access from Amplitude. Channels act like derived properties applied in real-time during queries, and are primarily used by marketers to define acquisition channels based on UTM and referrer data. By default, you can't select channel properties in sync configuration (event filters or additional properties) unless this feature is explicitly enabled for your organization.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Passive voice introduced where active voice existed (Bugbot Rules)

The phrase "unless this feature is explicitly enabled for your organization" uses passive voice. The original text used active voice: "unless you've explicitly enabled this feature". This violates the Active Voice rule (highest priority in style guide). Consider rephrasing to maintain active voice, such as "unless Amplitude enables this feature for your organization" or "unless you have this feature enabled".

Fix in Cursor Fix in Web

* Custom events that don't meet the criteria in the [Supported custom events](#supported-custom-events) section.
* Group properties.
* Cart properties.
* Nested properties (for example, derived properties that rely on other derived properties). Exception: The UI allows selecting nested properties based on merged or cart properties, but these won't work in practice.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Future tense used instead of present tense (Bugbot Rules)

The phrase "but these won't work in practice" uses future tense ("won't work"). The style guide requires present tense and flags "will" and "will not" constructions. This violates the Present Tense rule (high priority). The text can be changed to "but these don't work in practice" to use present tense.

Fix in Cursor Fix in Web

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants