Skip to content

docs: add the rokt ads source page - #19824

Open
jakesciotto wants to merge 3 commits into
masterfrom
posthog/rokt-ads-docs
Open

docs: add the rokt ads source page#19824
jakesciotto wants to merge 3 commits into
masterfrom
posthog/rokt-ads-docs

Conversation

@jakesciotto

@jakesciotto jakesciotto commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

Executive summary

The Rokt Ads warehouse source shipped in PostHog/posthog#82608. Its source config sets docsUrl to /docs/cdp/sources/rokt-ads, but no page existed at that path, so the "Read the docs" link in the connect wizard returned a 404. This adds the page.

The page follows the structure of the other advertising source pages, such as Amazon Ads: what the connector pulls, how to connect it, which tables it offers, then the <SourceParameters /> and <SourceTables /> blocks.

Two parts of the page describe behavior a person will otherwise be surprised by:

  • Numbers for a given day keep moving for about a week. Rokt attributes acquisitions and conversions by conversion time and restates recent days, so each incremental sync re-reads a trailing seven-day window.
  • Available columns differ per account. Rokt reports which dimensions and metrics an account may request. A metric the account cannot serve is dropped from the report, but a missing dimension fails the sync with an error naming it, because a dimension sets the row grain.

The alpha callout matches releaseStatus=ReleaseStatus.ALPHA on the source config, so the page states the status the product already ships.

Before you open a PR

  • pnpm format globs {html,js,ts,tsx,json,yml,css,scss} and does not cover .md, so it is a no-op for this diff.
  • I could not start the dev server locally, because node_modules is absent in my environment. Instead I checked the page on the Cloudflare deploy preview this PR builds, which renders the real page.

The preview confirms the page renders correctly:

  • The alpha callout, the intro, the connect steps, and the "Available tables" table all render.
  • Configuration renders the five fields from the source config: App ID, App secret, and Account ID as required, with Time zone and Currency code optional.
  • Supported tables renders all six tables with their descriptions, sync methods, and incremental fields.

Rendering it found one error that reading the file did not. The generated table reports "Incremental, Full refresh" for the five report tables, but the hand-written table above it named incremental only. That is fixed, and the note underneath now says why incremental is the better choice.

An earlier preview showed an empty Configuration heading, because the source had not deployed yet and the build reads source metadata from /api/public_source_configs. The source is now live, so the section fills in. No navigation change, because source pages are not listed in src/navs/index.js. No page moved or was renamed, so vercel.json needs no redirect.

Vale

The first run reported 15 warnings. Both causes are fixed in this PR, which is why it also touches one file outside contents/:

  • Fourteen were 'Rokt' is a possible misspelling. Rokt is a brand name, so it now sits in the BrandsAndTechnologies vocabulary alongside HubSpot, Klaviyo, and the other vendors. Without this, every future page that names Rokt repeats the same 14 warnings.
  • One was real. ProductNames asks for "Data Warehouse" when the phrase names PostHog's product rather than the general industry concept, and that sentence names the product.

Worth flagging for the reviewer: the lowercase form appears in about 106 pages under contents/docs/ against roughly 12 capitalized, so the corpus has drifted from the rule the linter encodes. I followed the linter here rather than the neighboring pages. Say the word if you would rather match the neighbors, and I will revert that one word.

Notes

The source logo is a separate PR on the main repo, PostHog/posthog#91320. This page reads icon_url from the same source config, so that PR also supplies the icon shown here.

The Rokt Ads warehouse source sets docsUrl to /docs/cdp/sources/rokt-ads, which
had no page behind it, so the link from the connect wizard returned a 404.

Adds the page, following the structure of the other advertising source pages.

Generated-By: PostHog Desktop
Task-Id: d8766944-e16c-41ae-b2e9-8eccfb718a96
@jakesciotto jakesciotto self-assigned this Aug 29, 2026
@github-actions github-actions Bot added docs Improvements or additions to product documentation, "Docs" content PR only touches files under contents/ labels Aug 29, 2026
@github-actions

github-actions Bot commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Aug 29, 2026 10:42PM

Vale reported 15 warnings on the new page.

Fourteen were the vendor name. Rokt is a brand, so it goes in the
BrandsAndTechnologies vocabulary next to the other vendor names.

The last one was real: ProductNames asks for "Data Warehouse" when the phrase
names PostHog's product rather than the industry concept, and this sentence
names the product.

Generated-By: PostHog Desktop
Task-Id: d8766944-e16c-41ae-b2e9-8eccfb718a96
@github-actions github-actions Bot removed the content PR only touches files under contents/ label Aug 29, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

8.15 MiB (no change)

Eager graph (modules shipped in each entrypoint's initial chunks)

Entrypoint Eager size Budget Modules
app 16.91 MiB (no change) report-only 2036
Largest modules in the app closure
Module Size
./src/data/mcp-tools.json 1053.9 KiB
css ./node_modules/.pnpm/css-loader@5.2.7_webpack@5.101.3/node_modules/css-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[1]!./node_modules/.pnpm/postcss-loader@4.3.0_postcss@8.5.6_webpack@5.101.3/node_modules/postcss-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[2]!./src/styles/global.css 754.5 KiB
./src/components/Stickers/Stickers.tsx 696.4 KiB
./node_modules/.pnpm/@radix-ui+react-icons@1.3.2_react@18.3.1/node_modules/@radix-ui/react-icons/dist/react-icons.esm.js 481.4 KiB
./node_modules/.pnpm/rehype-raw@7.0.0/node_modules/rehype-raw/lib/index.js + 29 modules 395.1 KiB
./src/hooks/useCustomers.tsx + 55 modules 370.0 KiB
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js 354.8 KiB
./node_modules/.pnpm/react-markdown@8.0.7_@types+react@16.14.66_react@18.3.1/node_modules/react-markdown/lib/react-markdown.js + 88 modules 351.4 KiB
./src/components/ProductComparisonTable/index.tsx + 126 modules 301.7 KiB
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js 281.9 KiB
./src/components/SearchUI/index.tsx + 87 modules 273.0 KiB
./node_modules/.pnpm/@posthog+brand@0.8.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/magnifying-glass.mjs 254.7 KiB
./node_modules/.pnpm/framer-motion@10.18.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/dom/motion.mjs + 109 modules 253.9 KiB
./node_modules/.pnpm/d3@7.9.0/node_modules/d3/src/index.js + 208 modules 247.4 KiB
./src/components/Pricing/PricingSlider/Slider.tsx + 87 modules 240.1 KiB

Eager-graph budgets are report-only until a baseline is established. Sizes are gzip of public/**/*.js; eager size is webpack module source bytes for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).

Rendering the page against the deployed source showed the generated table
reporting "Incremental, Full refresh" for the five report tables, while the
hand-written table above it named incremental only.

The five report tables offer both methods, so the table now says so, and the
note underneath says why incremental is the better choice.

Generated-By: PostHog Desktop
Task-Id: d8766944-e16c-41ae-b2e9-8eccfb718a96
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to product documentation, "Docs"

Projects

Status: Backlog

Development

Successfully merging this pull request may close these issues.

1 participant