Skip to content

Add attribute group templates documentation#1737

Open
John Reid (johnmicahreid) wants to merge 2 commits into
mainfrom
templated-attribute-groups
Open

Add attribute group templates documentation#1737
John Reid (johnmicahreid) wants to merge 2 commits into
mainfrom
templated-attribute-groups

Conversation

@johnmicahreid

Copy link
Copy Markdown
Contributor

This PR was generated automatically by Claude.

What changed?

  • New page at docs/signals/attributes/templated-attribute-groups/index.md documenting the five prebuilt attribute group templates available in Signals: Basic Web, User Agent, Campaign Attribution, Product Views, and Transactions
  • Each template section lists the included attributes with descriptions and aggregation types
  • Added a cross-reference from the attribute groups page to the new templates page
  • Includes a screenshot of the template selection UI

Why?

Templated attribute groups shipped in Q4 2025 and need documentation so customers can discover and use them. The templates reduce time-to-value by providing pre-configured attributes for common use cases.

AI reviews

Claude will automatically review this PR against the docs style guide.

If you have questions or want it to look again at something specific, tag @claude in a comment.

Co-Authored-By: Claude <noreply@anthropic.com>
@netlify

netlify Bot commented Apr 16, 2026

Copy link
Copy Markdown

Deploy Preview for snowplow-docs ready!

Name Link
🔨 Latest commit c280274
🔍 Latest deploy log https://app.netlify.com/projects/snowplow-docs/deploys/69e0b344e135b9000801de31
😎 Deploy Preview https://deploy-preview-1737--snowplow-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 16 (🔴 down 6 from production)
Accessibility: 93 (no change from production)
Best Practices: 92 (no change from production)
SEO: 95 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@claude

claude Bot commented Apr 16, 2026

Copy link
Copy Markdown

Style guide feedback

Overall this is well-structured and follows the page conventions. A few things to address:

Active voice

templated-attribute-groups/index.md, intro paragraph:

Templates are available for three categories of use case:

This uses a passive/stative construction. Rewrite to active voice:

Signals provides templates for three categories of use case:

Link text should match the target page title

attribute-groups/index.md:

You can also start from a prebuilt template for common use cases...

The style guide says to use the target page name where possible. The target page is titled "Attribute group templates", so prefer:

You can also start from an attribute group template for common use cases...

Ecommerce requirement — passive voice and inconsistent pattern

In the Product views and Transactions sections, the requirement is stated inline in a sentence fragment using passive voice:

Requires ecommerce tracking to be configured in your tracker.

Two issues here:

  1. Passive voice — prefer: "You must have ecommerce tracking configured in your tracker."
  2. Inconsistency — the User agent section correctly uses a :::note admonition for its requirement. Apply the same pattern to both ecommerce sections:
:::note[Ecommerce tracking required]
You must have ecommerce tracking configured in your tracker to use this template. See [ecommerce tracking](/docs/sources/web-trackers/tracking-events/ecommerce/index.md).
:::

Single-digit numbers in the overview table

The style guide requires single-digit numbers to be spelled out as words. The Attributes column in the overview table uses 4 and 5:

Template Attributes
Basic web 4 → four
Transactions 5 → five

The other values (7, 10, 12) are multi-digit and don't need changing.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Apr 16, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
documentation c280274 Commit Preview URL

Branch Preview URL
Apr 16 2026, 10:03 AM

- Use active voice in intro paragraph
- Match link text to target page title
- Use admonitions for ecommerce tracking requirements

Co-Authored-By: Claude <noreply@anthropic.com>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

good so far, needs clarification about supported trackers


## Available templates

Each template pre-fills a set of attributes with appropriate event selections, property mappings, and aggregation types. The sections below list the attributes included in each template.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

the first three templates here are based on page views. are they only suitable for js trackers or others too? https://docs.snowplow.io/docs/events/ootb-data/page-and-screen-view-events/

Tracks product browsing behavior using Snowplow [ecommerce](/docs/sources/web-trackers/tracking-events/ecommerce/index.md) events.

:::note[Ecommerce tracking required]
You must have [ecommerce tracking](/docs/sources/web-trackers/tracking-events/ecommerce/index.md) configured in your tracker to use this template.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

are these templates only for web? native mobile have the same ecommerce API https://docs.snowplow.io/docs/events/ootb-data/ecommerce-events/

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