Skip to content

EDU-18338: announce new ROAS calculation methodology for Sponsored Products#733

Open
PedroAntunesCosta wants to merge 2 commits into
mainfrom
docs/announce-roas-methodology-sponsored-products
Open

EDU-18338: announce new ROAS calculation methodology for Sponsored Products#733
PedroAntunesCosta wants to merge 2 commits into
mainfrom
docs/announce-roas-methodology-sponsored-products

Conversation

@PedroAntunesCosta
Copy link
Copy Markdown
Contributor

Summary

Adds the Help Center announcement for the new ROAS calculation methodology applied to Sponsored Products in VTEX Ads, scheduled to go live on June 20, 2026. The metric changes from click-only to consolidated click + view attribution (14-day window), aligning Sponsored Products with the methodology already used for Banners, Videos, and Sponsored Brands.

Changes

  • PT canonical announcement: docs/pt/announcements/2026/junho/2026-06-20-nova-metodologia-calculo-roas-produtos-patrocinados.md
  • EN placeholder for Localization: docs/en/announcements/2026/june/2026-06-20-new-roas-calculation-methodology-for-sponsored-products.md
  • ES placeholder for Localization: docs/es/announcements/2026/junio/2026-06-20-nueva-metodologia-calculo-roas-productos-patrocinados.md
  • New month folders (junho, june, junio) with metadata.json

Why

Standardizing the ROAS calculation across all ad formats eliminates methodological inconsistency between Sponsored Products and the other formats, and gives advertisers a more complete view of the real return on their ad spend. The announcement also flags transparency around the expected ROAS uplift, so it is not misread as a performance improvement.

Pending product confirmations before LOC hand-off

  1. Deploy date — 2026-06-20 is a Saturday. Confirm or move to Fri 19/06.
  2. UI label for the breakdown column (drafted as ROAS por clique).
  3. Confirm that roas_click / roas_view breakdowns become available to all users (not only superAdmin) at this deploy.
  4. Whether the Conversion Rate fix mentioned in the PRD ships in the same deploy.

Related Task

EDU-18338

Relates to:

  • EDU-18147 — Assisted Sales & ROAS attribution
  • EDU-18149 — Dashboard attribution windows & conversion models doc
  • EDU-18231 — Objective Campaign - Target ROAS

@PedroAntunesCosta PedroAntunesCosta added the documentation Improvements or additions to documentation label May 18, 2026
@PedroAntunesCosta PedroAntunesCosta self-assigned this May 18, 2026
@PedroAntunesCosta PedroAntunesCosta added the documentation Improvements or additions to documentation label May 18, 2026
@github-actions
Copy link
Copy Markdown
Contributor

🧭 Navigation Generation Report

❌ Validation Status: FAILED

Parse errors: files could not be processed • Duplicate conflicts: 7 slug conflicts found

📝 Auto-commit: Navigation changes committed by workflow (commit 1c97ad2)

📊 Generation Details (click to expand)
Commit Date Duration
2b5ab75ab52e87a6202ba85908ffae3f463c579e 2026-05-18 15:29:58 -0300 7s
Metric Value Output Details
Files processed 12568 Path public/navigation.json
Files skipped Size 3.1M
Categories 396 SHA256 4e727a337d853b0fe4f2f7716f632b9ce7ff5e5ed07fd2f36af85f1890de08a0
Documents 4120 Duplicate conflicts 7
🔗 Duplicate Slug Conflicts (7 conflicts)
  • Duplicate slug '2020-mayo' found 2 times in section 'announcements' (es): category:'Mayo' at '2020 > Mayo' [en:'May', en-slug:'2020-may'], category:'Mayo' at '2020 > Mayo' [en-slug:'mayo']
  • Duplicate slug '2020-maio' found 2 times in section 'announcements' (pt): category:'Maio' at '2020 > Maio' [en:'May', en-slug:'2020-may'], category:'Maio' at '2020 > Maio' [en:'Mayo', en-slug:'mayo']
  • Duplicate slug 'integracion-de-lengow' found 2 times in section 'tracks' (es): category:'Integración de Lengow' at 'Marketplace > Integración de Lengow' [en:'Lengow integration', en-slug:'lengow-integration'], category:'Integración de Lengow' at 'Marketplace > Integración de Lengow'
  • Duplicate slug 'inventory-subcategory' found 2 times in section 'tutorials' (en): category:'Inventory' at 'Integrations > Inventory', category:'Inventory' at 'Shipping > Inventory'
  • Duplicate slug 'feedback-del-vendedor-subcategoria' found 2 times in section 'tutorials' (es): category:'Feedback del vendedor' at 'Indeva by VTEX > Feedback del vendedor' [en-slug:'feedback-del-vendedor'], category:'Feedback del vendedor' at 'Indeva by VTEX > Feedback del vendedor' [en:'Seller feedback', en-slug:'seller-feedback-subcategory']
  • Duplicate slug 'configurações-vtex-cx-platform-subcategoria' found 2 times in section 'tutorials' (pt): category:'Configurações VTEX CX Platform' at 'VTEX CX Platform > Configurações VTEX CX Platform' [en-slug:'configuracoes-vtex-cx-platform'], category:'Configurações VTEX CX Platform' at 'VTEX CX Platform > Configurações VTEX CX Platform' [en:'VTEX CX Platform Settings', en-slug:'vtex-cx-platform-settings-subcategory']
  • Duplicate slug 'otro' found 2 times in section 'known-issues' (es): category:'Otro' at 'Otro' [en:'Other', en-slug:'other'], category:'Otros' at 'Otros' [en:'Others', en-slug:'others']

📋 Generation Log: - Full log: Download navgen.log


Generated by nav-generation workflow

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

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant