docs: Add Cost per Reported Conversion metric to Marketing Analytics docs#15346
Merged
jabahamondes merged 5 commits intomasterfrom Feb 27, 2026
Merged
Conversation
…n breakdown Reflects the new metric added in PostHog/posthog#48858 which calculates total cost ÷ reported conversions for the campaign breakdown table.
Contributor
Deploy preview
|
Contributor
|
Vale prose linter → found 0 errors, 13 warnings, 0 suggestions in your markdown Full report → Copy the linter results into an LLM to batch-fix issues. Linter being weird? Update the rules!
|
| Line | Severity | Message | Rule |
|---|---|---|---|
| 2:8 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'Marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
contents/docs/web-analytics/marketing-analytics.mdx — 0 errors, 12 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 2:8 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'Marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 19:3 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'Marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 19:135 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 29:27 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 32:79 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 92:50 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 96:138 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 201:6 | warning | 'UTM campaign manual mappings' heading should be in sentence case, and product names should be capitalized. | PostHogBase.SentenceCase |
| 231:5 | warning | 'Allowlist' is a possible misspelling. | PostHogBase.Spelling |
| 239:59 | warning | 'Allowlist' is a possible misspelling. | PostHogBase.Spelling |
| 240:63 | warning | 'Allowlist' is a possible misspelling. | PostHogBase.Spelling |
| 241:55 | warning | 'Allowlist' is a possible misspelling. | PostHogBase.Spelling |
Contributor
|
This is awesome @PostHog/team-docs-wizard ❤️ ! |
jabahamondes
approved these changes
Feb 26, 2026
Contributor
|
@inkeep can you review this comment: Vale prose linter → found 5 errors, 28 warnings, 4 suggestions in your markdown Full report → Copy the linter results into an LLM to batch-fix issues. Linter being weird? Update the rules!
|
| Line | Severity | Message | Rule |
|---|---|---|---|
| 2:8 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'Marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 13:53 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 15:4 | warning | 'Understanding "Reported" vs PostHog conversions' heading should be in sentence case, and product names should be capitalized. | PostHogBase.SentenceCase |
| 17:1 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'Marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 19:1 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 21:1 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 21:95 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 39:54 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 63:42 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 64:61 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 65:75 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 200:114 | warning | 'microcurrency' is a possible misspelling. | PostHogBase.Spelling |
| 225:4 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'Marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
contents/docs/web-analytics/marketing-analytics.mdx — 0 errors, 20 warnings, 4 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 2:8 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'Marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 19:3 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'Marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 19:135 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 29:27 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 32:79 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 76:12 | warning | 'Clickthrough' is a possible misspelling. | PostHogBase.Spelling |
| 92:50 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 96:138 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 119:6 | warning | 'Data warehouse sources' heading should be in sentence case, and product names should be capitalized. | PostHogBase.SentenceCase |
| 119:6 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'Data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 121:39 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 121:94 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 136:85 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 140:85 | warning | Avoid trivializing words. 'simply' can sound dismissive to the reader. | PostHogDocs.Trivializers |
| 155:58 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 155:148 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 162:20 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 163:24 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 165:5 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 201:6 | warning | 'UTM campaign manual mappings' heading should be in sentence case, and product names should be capitalized. | PostHogBase.SentenceCase |
| 231:5 | suggestion | Prefer 'allowlist' over 'Whitelist'. | PostHogBase.Inclusivity |
| 239:59 | suggestion | Prefer 'allowlist' over 'Whitelist'. | PostHogBase.Inclusivity |
| 240:63 | suggestion | Prefer 'allowlist' over 'Whitelist'. | PostHogBase.Inclusivity |
| 241:55 | suggestion | Prefer 'allowlist' over 'Whitelist'. | PostHogBase.Inclusivity |
…chema.mdx - Replace hyphens with en dashes (–) on lines 19, 21, 63, 64, 65 - Capitalize 'Marketing Analytics' as PostHog product name - Capitalize 'Data Warehouse' as PostHog product name - Fix heading to sentence case
- Fix spelling: 'Clickthrough' → 'Click-through' - Remove trivializing word 'simply' - Capitalize 'Data Warehouse' and 'Marketing Analytics' as PostHog product names - Replace 'Whitelist/whitelisted' with 'Allowlist/allowlisted' for inclusivity
Contributor
Author
|
I've fixed all the Vale linter issues. Here's a summary of the changes:
|
Contributor
|
@inkeep what about these new warnings: Vale prose linter → found 0 errors, 14 warnings, 0 suggestions in your markdown Full report → Copy the linter results into an LLM to batch-fix issues. Linter being weird? Update the rules!
|
| Line | Severity | Message | Rule |
|---|---|---|---|
| 2:8 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'Marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 200:114 | warning | 'microcurrency' is a possible misspelling. | PostHogBase.Spelling |
contents/docs/web-analytics/marketing-analytics.mdx — 0 errors, 12 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 2:8 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'Marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 19:3 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'Marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 19:135 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 29:27 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 32:79 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 92:50 | warning | Capitalize 'Marketing Analytics' for PostHog's product. Use 'marketing analytics' for the general industry concept. | PostHogBase.ProductNames |
| 96:138 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 201:6 | warning | 'UTM campaign manual mappings' heading should be in sentence case, and product names should be capitalized. | PostHogBase.SentenceCase |
| 231:5 | warning | 'Allowlist' is a possible misspelling. | PostHogBase.Spelling |
| 239:59 | warning | 'Allowlist' is a possible misspelling. | PostHogBase.Spelling |
| 240:63 | warning | 'Allowlist' is a possible misspelling. | PostHogBase.Spelling |
| 241:55 | warning | 'Allowlist' is a possible misspelling. | PostHogBase.Spelling |
Contributor
Author
|
I've addressed the one actionable warning from the Vale linter: Fixed:
Regarding the remaining 13 warnings: These are all pre-existing issues in the files that were not introduced by this PR:
If you'd like these pre-existing issues addressed, I'd recommend a separate cleanup PR to avoid mixing concerns. Let me know if you'd like me to create one! 🙂 |
Contributor
|
@inkeep yes do it in a separated PR and please add me as a reviewer |
Contributor
Author
|
I've created a separate PR to fix the pre-existing Vale lint warnings: #15348 The new PR addresses:
I've added you as a reviewer on that PR as requested! 🎉 |
jabahamondes
deleted the
docs-writer-ai-update-2026-02-26T19-43-29-400Z-g3k28p
branch
Contributor
|
How was the Inkeep-generated draft?
|
sarahxsanders
pushed a commit
that referenced
this pull request
Feb 27, 2026
…docs (#15346) * Add Cost per Reported Conversion to marketing analytics column definitions * docs: add Cost per Reported Conversion to marketing analytics campaign breakdown Reflects the new metric added in PostHog/posthog#48858 which calculates total cost ÷ reported conversions for the campaign breakdown table. * fix: resolve Vale linter errors and warnings in marketing-analytics-schema.mdx - Replace hyphens with en dashes (–) on lines 19, 21, 63, 64, 65 - Capitalize 'Marketing Analytics' as PostHog product name - Capitalize 'Data Warehouse' as PostHog product name - Fix heading to sentence case * fix: resolve Vale linter warnings in marketing-analytics.mdx - Fix spelling: 'Clickthrough' → 'Click-through' - Remove trivializing word 'simply' - Capitalize 'Data Warehouse' and 'Marketing Analytics' as PostHog product names - Replace 'Whitelist/whitelisted' with 'Allowlist/allowlisted' for inclusivity * fix: replace 'microcurrency' with 'micro-units of' to resolve Vale linter warning --------- Co-authored-by: inkeep[bot] <257615677+inkeep[bot]@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR updates the Marketing Analytics documentation to include the new Cost per Reported Conversion metric added in PostHog/posthog#48858.
Changes
contents/docs/web-analytics/marketing-analytics-schema.mdxCost per Reported Conversionto the Calculated metrics table with:Cost / Reported ConversionsisIncreaseBad: truein the backend)contents/docs/web-analytics/marketing-analytics.mdxContext
The new metric calculates
Cost / Reported Conversionsand appears in:This is a standard marketing metric that complements existing calculated metrics like CPC, CTR, and ROAS.
This PR was created by the Inkeep Content Writer agent, which is maintained by the Docs and Wizard team. Please reach out on Slack for help if needed.