Skip to content

EDU-18150: restructure Budget Pacing tutorials and update announcement#753

Open
PedroAntunesCosta wants to merge 6 commits into
mainfrom
feat/budget-pacing-launch
Open

EDU-18150: restructure Budget Pacing tutorials and update announcement#753
PedroAntunesCosta wants to merge 6 commits into
mainfrom
feat/budget-pacing-launch

Conversation

@PedroAntunesCosta
Copy link
Copy Markdown
Contributor

@PedroAntunesCosta PedroAntunesCosta commented May 25, 2026

Summary

Ships Budget Pacing launch content for VTEX Ads: a launch announcement and two tutorials (concept overview and budget consumption report), with EN/ES placeholders for localization.

Content scope

  • Portal: Help Center
  • Mode: New
  • Locale(s) authored: PT (HC)

Files

PT (canonical)

  • docs/pt/announcements/2026/junho/2026-06-22-budget-pacing-disponivel-no-vtex-ads.md
  • docs/pt/tutorials/vtex-ads/budget-pacing-pt.md
  • docs/pt/tutorials/vtex-ads/orcamento-de-campanhas/monitorar-consumo-de-orcamento.md

EN (placeholders)

  • docs/en/announcements/2026/june/2026-06-22-budget-pacing-now-available-in-vtex-ads.md
  • docs/en/tutorials/vtex-ads/budget-pacing.md
  • docs/en/tutorials/vtex-ads/budget-campaigns/monitor-budget-consumption.md

ES (placeholders)

  • docs/es/announcements/2026/junio/2026-06-22-budget-pacing-disponible-en-vtex-ads.md
  • docs/es/tutorials/vtex-ads/budget-pacing-es.md
  • docs/es/tutorials/vtex-ads/presupuesto-de-campanas/monitorear-consumo-de-presupuesto.md

Navigation

  • public/navigation.json

Source material

Localization scope

  • HC: full translation of PT into EN and ES.

Related Task

EDU-18150

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

github-actions Bot commented May 25, 2026

🧭 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 0398b9f)

📊 Generation Details (click to expand)
Commit Date Duration
01660ae4754385543c17484feaf8bad6b63f4aec 2026-06-03 17:49:45 -0300 8s
Metric Value Output Details
Files processed 12351 Path public/navigation.json
Files skipped Size 3.1M
Categories 400 SHA256 1e5f4841485f2811caa342ba3fa16b8fc83025ac8c280e8a69a948224018c4ad
Documents 4121 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


Após a ativação, todas as novas campanhas do publicador operarão automaticamente com Budget Pacing. Campanhas com data de término já ativas permanecem no modelo de orçamento diário fixo até o encerramento. Campanhas always-on já ativas migram automaticamente no início do próximo ciclo de 30 dias.

Para entender em detalhes como o mecanismo funciona, acesse o tutorial [Budget Pacing](https://help.vtex.com/pt/docs/tutorials/budget-pacing-pt).
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.

[link-check] reported by reviewdog 🐶
🚨 Found a broken link in a Markdown Link (Error 404):
https://help.vtex.com/pt/docs/tutorials/budget-pacing-pt

👉 Please review this link before merging your Pull Request.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

These links point to budget-pacing-pt.md, a new article being added in this same PR. They are 404 on production today because the page hasn't been published yet — that's expected pre-merge. The URL format is correct and matches how the repo derives page URLs from filenames. These links will resolve once the PR is deployed.


## Saiba mais

- [Budget Pacing](https://help.vtex.com/pt/docs/tutorials/budget-pacing-pt)
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.

[link-check] reported by reviewdog 🐶
🚨 Found a broken link in a Markdown Link (Error 404):
https://help.vtex.com/pt/docs/tutorials/budget-pacing-pt

👉 Please review this link before merging your Pull Request.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

These links point to budget-pacing-pt.md, a new article being added in this same PR. They are 404 on production today because the page hasn't been published yet — that's expected pre-merge. The URL format is correct and matches how the repo derives page URLs from filenames. These links will resolve once the PR is deployed.

## Saiba mais

- [Budget Pacing](https://help.vtex.com/pt/docs/tutorials/budget-pacing-pt)
- [Monitorar o consumo de orçamento](https://help.vtex.com/pt/docs/tutorials/monitorar-consumo-de-orcamento)
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.

[link-check] reported by reviewdog 🐶
🚨 Found a broken link in a Markdown Link (Error 404):
https://help.vtex.com/pt/docs/tutorials/monitorar-consumo-de-orcamento

👉 Please review this link before merging your Pull Request.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

These links point to monitorar-consumo-de-orcamento.md, a new article added in this same PR. The 404 is expected pre-merge since the page doesn't exist on production yet. URL format is correct. Both links will resolve once deployed.


## Status de pacing

O **Budget Pacing** monitora o ritmo de consumo de cada campanha e atribui um status de pacing, exibido no [relatório de consumo de orçamento](https://help.vtex.com/pt/docs/tutorials/monitorar-consumo-de-orcamento):
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.

[link-check] reported by reviewdog 🐶
🚨 Found a broken link in a Markdown Link (Error 404):
https://help.vtex.com/pt/docs/tutorials/monitorar-consumo-de-orcamento

👉 Please review this link before merging your Pull Request.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

This link points to monitorar-consumo-de-orcamento.md, a new article added in this same PR. The 404 is expected pre-merge since the page doesn't exist on production yet. URL format is correct. This link will resolve once deployed.


Este artigo explica como acessar e interpretar o **relatório de consumo de orçamento** de campanhas com Budget Pacing no VTEX Ads. O relatório permite que operadores de mídia e gerentes de conta acompanhem o ritmo de entrega da campanha e identifiquem rapidamente desvios de consumo.

> ⚠️ O relatório de consumo de orçamento está disponível apenas para campanhas de publicadores com Budget Pacing ativo. Para entender como o mecanismo funciona, veja [Budget Pacing](https://help.vtex.com/pt/docs/tutorials/budget-pacing-pt).
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.

[link-check] reported by reviewdog 🐶
🚨 Found a broken link in a Markdown Link (Error 404):
https://help.vtex.com/pt/docs/tutorials/budget-pacing-pt

👉 Please review this link before merging your Pull Request.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

This link points to budget-pacing-pt.md, a new article being added in this same PR. It is 404 on production today because the page hasn't been published yet — that's expected pre-merge. The URL format is correct and matches how the repo derives page URLs from filenames. This link will resolve once the PR is deployed.

@PedroAntunesCosta PedroAntunesCosta added AI style review Trigger AI style review workflow AI grammar review Trigger AI grammar review workflow labels Jun 3, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 3, 2026

✏️ Grammar review summary

docs/pt/announcements/2026/junho/2026-06-22-budget-pacing-disponivel-no-vtex-ads.md

O texto está gramaticalmente correto e bem estruturado. A única correção realizada foi o ajuste do número de limitações de 'três' para 'duas' na linha 30, para manter a coerência com a lista que apresenta apenas dois itens.

docs/pt/tutorials/vtex-ads/budget-pacing-pt.md

O texto está muito bem escrito. A única correção necessária foi a remoção do hífen na locução 'dia a dia' na linha 39, conforme as regras do Acordo Ortográfico vigente.

docs/pt/tutorials/vtex-ads/orcamento-de-campanhas/monitorar-consumo-de-orcamento.md

O texto apresenta excelente qualidade gramatical e ortográfica. Foram corrigidos apenas dois pequenos desvios tipográficos onde a vírgula estava posicionada incorretamente dentro da formatação de negrito.


Was this feedback useful?

  • Yes
  • No

Review made on commit 01660ae


## Por que fizemos essa mudança?

Antes, campanhas atreladas a Pedidos de Inserção mensais ficavam sujeitas a três limitações:
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.

📝 [Grammar reviewer] reported by reviewdog 🐶
O texto menciona "três limitações", mas apresenta apenas dois itens na lista subsequente.

Suggested change
Antes, campanhas atreladas a Pedidos de Inserção mensais ficavam sujeitas a três limitações:
Antes, campanhas atreladas a Pedidos de Inserção mensais ficavam sujeitas a duas limitações:

- **Nos últimos 30% do ciclo:** o teto diário pode chegar ao dobro da alocação média definida, para recuperar eventual subconsumo.
- **Em qualquer dia do ciclo:** o teto diário nunca ultrapassa três vezes a alocação média, mesmo em cenários de forte aceleração.

> ⚠️ O gasto total do ciclo tende a se manter dentro da estimativa calculada. A variação ocorre na distribuição dia-a-dia, não no total do ciclo.
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.

📝 [Grammar reviewer] reported by reviewdog 🐶
De acordo com o Acordo Ortográfico de 1990, não se utiliza hífen em locuções com elementos repetidos unidos por preposição, como 'dia a dia'.

Suggested change
> ⚠️ O gasto total do ciclo tende a se manter dentro da estimativa calculada. A variação ocorre na distribuição dia-a-dia, não no total do ciclo.
> ⚠️ O gasto total do ciclo tende a se manter dentro da estimativa calculada. A variação ocorre na distribuição dia a dia, não no total do ciclo.


1. No painel Admin do VTEX Ads, role a página até a listagem de campanhas.
2. Localize a campanha desejada e clique na linha correspondente.
3. Na seção **Investimento,** clique em `Ver relatório de consumo`.
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.

📝 [Grammar reviewer] reported by reviewdog 🐶
A vírgula deve ser posicionada fora da formatação em negrito.

Suggested change
3. Na seção **Investimento,** clique em `Ver relatório de consumo`.
3. Na seção **Investimento**, clique em `Ver relatório de consumo`.


### Investigar Critical underpacing

Quando o status é **critical underpacing,** o motor já está tentando recuperar o ritmo. Se a campanha continua com consumo muito abaixo do esperado, verifique se há restrições na configuração:
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.

📝 [Grammar reviewer] reported by reviewdog 🐶
A vírgula deve ser posicionada fora da formatação em negrito.

Suggested change
Quando o status é **critical underpacing,** o motor já está tentando recuperar o ritmo. Se a campanha continua com consumo muito abaixo do esperado, verifique se há restrições na configuração:
Quando o status é **critical underpacing**, o motor já está tentando recuperar o ritmo. Se a campanha continua com consumo muito abaixo do esperado, verifique se há restrições na configuração:

@github-actions github-actions Bot added AI reviewed Check to indicate this PR received an AI-based review and removed AI grammar review Trigger AI grammar review workflow labels Jun 3, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 3, 2026

🔍 Documentation feedback for docs/pt/announcements/2026/junho/2026-06-22-budget-pacing-disponivel-no-vtex-ads.md

Here is the review of your Release Note based on the specified rules.

1. General Feedback

The body of the release note is well-written, clear, and structured correctly according to the required sections. The tone is professional and avoids marketing jargon. However, there are several critical deviations in the frontmatter metadata. The document uses non-standard fields instead of the mandatory ones, and the title does not follow the required format.


2. Actionable Feedback

  • Title Format: The title 'Budget Pacing disponível no VTEX Ads' does not follow the mandatory <Product/Feature name>: <Summary> template. It should be changed to VTEX Ads: Budget Pacing disponível.
  • Missing type Field: The mandatory type field is missing. Since this release introduces a new feature, you must add type: added and remove the non-standard contentType: updates.
  • Incorrect Slug Field: The frontmatter uses slugEN instead of the mandatory slug. This must be renamed to slug and formatted as YYYY-MM-DD-title (e.g., 2026-06-22-vtex-ads-budget-pacing).
  • Incorrect Excerpt Field: The frontmatter uses announcementSynopsisPT instead of the mandatory excerpt field. Rename this field to excerpt.
  • Unnecessary Frontmatter Fields: Fields like productTeam and locale are not defined in the release note rules and should be removed to keep the metadata clean and compliant.

3. Suggested Revision

---
title: 'VTEX Ads: Budget Pacing disponível'
createdAt: '2026-06-22T00:00:00.000Z'
updatedAt: '2026-06-22T00:00:00.000Z'
type: added
slug: 2026-06-22-vtex-ads-budget-pacing
excerpt: 'O Budget Pacing permite que campanhas do VTEX Ads redistribuam o orçamento automaticamente ao longo do ciclo, eliminando a necessidade de ajustes manuais diários de orçamento.'
tags:
  - Nova funcionalidade
  - VTEX Ads
---

O **Budget Pacing** está disponível em open beta no **VTEX Ads.** Com essa funcionalidade, o sistema redistribui automaticamente o orçamento de uma campanha ao longo do ciclo, garantindo a entrega do investimento total sem a necessidade de ajustes manuais diários.

## O que mudou?

Antes, campanhas no VTEX Ads operavam exclusivamente com orçamento diário fixo. Quando uma campanha atrelada a um Pedido de Inserção mensal não gastava o esperado nos primeiros dias, era necessário recalcular e ajustar o orçamento manualmente para recuperar o ritmo de entrega.

Com o **Budget Pacing**, você define uma única informação: a **alocação média diária**. A partir desse valor, o sistema redistribui automaticamente o consumo ao longo do ciclo, acelerando nos dias de subconsumo e desacelerando quando a campanha está acima do ritmo esperado.

As principais mudanças na interface são:

- Campo **Alocação média diária** na tela de criação e edição de campanhas, com a estimativa de gasto total do ciclo calculada automaticamente a partir dela.
- Acesso ao **relatório de consumo de orçamento** no detalhamento da campanha, com status de pacing, gráficos por dia e análise horária. O relatório oferece visibilidade do ritmo de entrega para gerentes de conta reportarem ao cliente de forma proativa.

## Por que fizemos essa mudança?

Antes, campanhas atreladas a Pedidos de Inserção mensais ficavam sujeitas a duas limitações principais:

- **Risco de underdelivery:** quando o consumo ficava abaixo do esperado nos primeiros dias do ciclo, a campanha podia não entregar 100% do valor contratado até o fim do período.
- **Falta de visibilidade:** gerentes de conta não tinham um relatório dedicado para acompanhar o ritmo de consumo e reportar ao cliente de forma proativa.

## O que precisa ser feito?

O Budget Pacing é ativado pela equipe interna da VTEX por publicador. Para solicitar a ativação, entre em contato com o time de operações de anúncios (AdOps) da VTEX.

Após a ativação, todas as novas campanhas do publicador operarão automaticamente com Budget Pacing. Campanhas com data de término já ativas permanecem no modelo de orçamento diário fixo até o encerramento. Campanhas always-on já ativas migram automaticamente no início do próximo ciclo de 30 dias.

Para entender em detalhes como o mecanismo funciona, acesse o tutorial [Budget Pacing](https://help.vtex.com/pt/docs/tutorials/budget-pacing-pt).

## Saiba mais

- [Budget Pacing](https://help.vtex.com/pt/docs/tutorials/budget-pacing-pt)
- [Monitorar o consumo de orçamento](https://help.vtex.com/pt/docs/tutorials/monitorar-consumo-de-orcamento)

Was this feedback useful?

  • Yes
  • No

Review made on commit 01660ae

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 3, 2026

🔍 Documentation feedback for docs/pt/tutorials/vtex-ads/orcamento-de-campanhas/monitorar-consumo-de-orcamento.md

Here is the review of your Guide based on the VTEX Developer Portal guidelines.


1. General Feedback

The document is highly informative and well-written. However, it currently reads more like a conceptual reference article than a task-focused Guide. To align with the VTEX Developer Portal standards, the document needs structural adjustments, including adding missing mandatory frontmatter fields, creating a dedicated prerequisites section, and organizing the content into a structured step-by-step instructions format using the mandatory ### Step N - Imperative title headings.


2. Actionable Feedback

  • Frontmatter:
    • Add the mandatory slug field (hyphenated, lowercase, without special characters).
    • Add the mandatory excerpt field (a concise, one-sentence summary of the guide's goal).
  • Structure:
    • Before you begin: Create an ## Antes de começar section to house the prerequisite regarding the active Budget Pacing mechanism (currently presented as a warning note at the beginning).
    • Instructions: Create a main ## Instruções section.
    • Step Headings: Group the content into sequential steps using the mandatory format ### Step N - Imperative title (e.g., ### Step 1 - Acesse o relatório de consumo, ### Step 2 - Analise as informações de consumo, etc.).
  • Style and Tone:
    • Imperative Verbs: Ensure all numbered list items in the instructions start with an imperative verb. For example, in the original Step 1:
      • Change "1. No painel Admin do VTEX Ads, role a página..." to "1. Acesse o painel Admin do VTEX Ads." and "2. Role a página...".
      • Change "3. Na seção Investimento, clique em..." to "3. Clique em Ver relatório de consumo na seção Investimento."

3. Suggested Revision

---
title: 'Monitorar o consumo de orçamento'
slug: 'monitorar-consumo-orcamento'
excerpt: 'Saiba como acessar e interpretar o relatório de consumo de orçamento de campanhas com Budget Pacing no VTEX Ads.'
createdAt: '2026-06-22T00:00:00.000Z'
updatedAt: '2026-06-22T00:00:00.000Z'
contentType: tutorial
productTeam: Others
slugEN: monitor-budget-consumption
locale: pt
---

Monitore o ritmo de entrega de suas campanhas e identifique desvios de consumo de forma rápida. Este guia mostra como acessar e interpretar o relatório de consumo de orçamento de campanhas com Budget Pacing no VTEX Ads.

## Antes de começar

Para visualizar o relatório, certifique-se de que a sua campanha possui o mecanismo de **Budget Pacing** ativo. Para entender como esse mecanismo funciona, consulte o artigo [Budget Pacing](https://help.vtex.com/pt/docs/tutorials/budget-pacing-pt).

## Instruções

Siga os passos abaixo para acessar e analisar o relatório de consumo de orçamento da sua campanha.

### Step 1 - Acesse o relatório de consumo

1. Acesse o painel Admin do VTEX Ads.
2. Role a página até a listagem de campanhas.
3. Clique sobre a linha da campanha que você deseja monitorar.
4. Clique em `Ver relatório de consumo` na seção **Investimento**.

> ℹ️ Você pode compartilhar o link do relatório diretamente com o gerente de conta ou com o cliente.

### Step 2 - Analise as informações de consumo

Após abrir o relatório, analise os dados distribuídos nas seguintes seções:

#### Cards de visão geral
Os cards exibem os dados do ciclo atual da campanha:

| Card | Informação exibida |
| --- | --- |
| **Consumo do dia** | Total gasto no dia atual até o momento da consulta. |
| **Consumo da semana** | Total gasto nos últimos 7 dias. |
| **Consumo total do ciclo** | Total acumulado no ciclo atual. |
| **Previsão de fechamento** | Projeção de gasto total ao final do ciclo com base no ritmo atual de consumo. |

O **badge de status de pacing** é exibido dentro do card de consumo e indica o ritmo atual de entrega da campanha.

#### Gráficos de consumo
Acompanhe a evolução do orçamento por meio de três gráficos principais:

- **Gasto total da campanha:** exibe a evolução do gasto acumulado no ciclo com três curvas (Realizado, Meta e Previsão).
- **Gasto diário:** exibe barras por dia, indicando se o consumo ficou acima ou abaixo da meta.
- **Gasto acumulado do dia com projeção de fechamento:** mostra o ritmo de consumo no dia atual e a projeção para as horas restantes.

#### Gráfico de calor horário
Monitore o consumo hora a hora da campanha. As colunas representam as horas do dia (0h–23h) e as linhas representam os dias do período selecionado.

| Elemento | Significado |
| --- | --- |
| **Intensidade de cor da célula** | Proporcional ao valor gasto naquela hora. Quanto mais intensa a cor, maior o gasto. |
| **Marcação visual distinta** | Indica períodos em que o orçamento diário foi esgotado, diferenciando de células com zero gasto por falta de inventário. |
| **Tooltip** | Exibido ao passar o cursor sobre a célula. Mostra hora, data, valor gasto e status da campanha naquele momento. |

O componente também exibe uma **projeção de consumo diário** calculada com base no ritmo das horas já decorridas.

> ℹ️ A projeção de consumo diário assume ritmo constante ao longo do dia. Variações de inventário no decorrer do dia não são consideradas na projeção.

### Step 3 - Interprete o status de pacing

Verifique o badge de status para entender o ritmo de consumo da campanha em relação ao esperado para o período:

| Badge | Faixa de consumo | O que está acontecendo |
| --- | --- | --- |
| **On track** (verde) | Entre 90% e 110% do esperado | A campanha está consumindo dentro do ritmo esperado. Nenhuma ação é necessária. |
| **Underpacing** (amarelo) | Abaixo de 90% do esperado | O consumo está abaixo do ritmo esperado. O motor já está com ramp-up ativo, acelerando a entrega automaticamente. |
| **Overpacing** (laranja) | Acima de 120% do esperado | O consumo está acima do ritmo esperado. O motor reduziu o teto diário automaticamente. |
| **Critical underpacing** (vermelho) | Abaixo de 60% nos últimos 3 dias | O consumo está muito abaixo do esperado por 3 dias consecutivos. O motor está com ramp-up ativo, mas pode haver um problema na configuração da campanha que o Budget Pacing não consegue resolver sozinho. |

Se o status for **Critical underpacing**, investige possíveis restrições na configuração da campanha:

- **Segmentação muito restrita:** verifique se há poucos produtos ou categorias elegíveis para exibição.
- **CPM abaixo do valor competitivo:** avalie se a campanha está perdendo leilões por lance insuficiente.
- **Baixo inventário no publicador:** verifique se o publicador possui volume de tráfego suficiente para o período.

> ⚠️ Evite fazer ajustes manuais no valor de alocação enquanto investiga o problema. Uma intervenção manual durante o ciclo reinicia o cálculo do motor e pode dificultar o diagnóstico.

### Step 4 - Navegue entre os ciclos de veiculação

Utilize o seletor de ciclo no cabeçalho do relatório para consultar períodos anteriores:

- **Campanhas com data de término:** selecione as datas dentro do período de duração da campanha.
- **Campanhas always-on:** navegue entre os ciclos de 30 dias da campanha, do ciclo atual até os ciclos concluídos anteriormente.

> ℹ️ O ciclo exibido no relatório é calculado a partir do início do ciclo definido pelo motor, não pelo mês civil.

Was this feedback useful?

  • Yes
  • No

Review made on commit 01660ae

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 3, 2026

🔍 Documentation feedback for docs/pt/tutorials/vtex-ads/budget-pacing-pt.md

Here is the review of your Explanation document based on the VTEX Rules for Explanation.


1. General Feedback

The document is well-structured, clear, and highly informative. It successfully avoids step-by-step instructions (R1.2), starts with strong context and relevance (R1.3), and uses tables effectively to present complex relationships like campaign types and pacing statuses (R1.4).

However, there are a few areas where the document deviates from the rules:

  • Metadata Mismatch: The contentType is set to tutorial, but this is a conceptual Explanation article.
  • Tone and Voice (R2.1): There is a repetitive use of the adverb "automaticamente" (automatically) and other unnecessary adverbs/fillers like "significativamente" (significantly) and "apenas" (just/only). Removing these makes the text more direct and professional.

2. Actionable Feedback

  • Metadata: Change contentType: tutorial to contentType: conceptual to align with the VTEX taxonomy for explanation/conceptual articles.
  • Tone and Voice (R2.1 - Adverbs & Directness):
    • In the first paragraph, change "redistribui automaticamente" to "redistribui". The automation is already implied by "mecanismo".
    • In the Variação do gasto diário section, change "significativamente maior" to "maior".
    • In the Campanhas já ativas section, change "migram automaticamente" to "migram".
    • In the Status de pacing section, simplify "aceleração automática do orçamento, acelerando automaticamente o ritmo" to "aceleração do orçamento, acelerando o ritmo".
    • In the same section, change "é apenas informativo e não leva a nenhuma ação" to "é informativo e não gera ações".

3. Suggested Revision

---
title: 'Budget Pacing'
createdAt: '2026-06-22T00:00:00.000Z'
updatedAt: '2026-06-22T00:00:00.000Z'
contentType: conceptual
productTeam: Others
slugEN: budget-pacing
locale: pt
---

> ⚠️ O Budget Pacing está disponível somente para publicadores habilitados pela equipe VTEX. Para solicitar a ativação, entre em contato com o time de operações de anúncios (AdOps) da VTEX.

**Budget Pacing** é o mecanismo do [VTEX Ads](https://help.vtex.com/pt/tracks/retail-media/vtex-ads-primeiros-passos) que redistribui o consumo de orçamento de uma campanha ao longo de um ciclo. Em vez de exigir um valor fixo de gasto diário, o VTEX Ads monitora o ritmo de consumo e ajusta o teto diário para garantir a entrega do orçamento total do ciclo.

O objetivo é eliminar a necessidade de ajustes manuais diários por parte do operador de mídia quando uma campanha não gasta o esperado nos primeiros dias, especialmente as atreladas a Pedidos de Inserção mensais.

## Como funciona

Ao criar uma nova campanha, você define um único valor: a **alocação média diária.** A partir dessa informação, o sistema calcula a estimativa de gasto total do ciclo como dado derivado e passa a acompanhar o ritmo de entrega.

Uma vez ativo, o **Budget Pacing:**

- Monitora o consumo real da campanha em relação ao esperado para o período.
- Recalcula o teto diário de consumo na virada de cada dia, com base no saldo restante do ciclo.
- Acelera o ritmo de entrega nos dias seguintes a uma queda no consumo.
- Reduz o teto diário quando o consumo está acima do esperado.

> ℹ️ O mecanismo de redistribuição funciona nos bastidores. O que o operador vê e configura é a alocação média diária. O ajuste automático do teto diário não é exibido diretamente na interface de criação ou edição de campanhas.

### Variação do gasto diário

O gasto real de uma campanha com **Budget Pacing** varia ao longo do ciclo. Em alguns dias este gasto ficará abaixo da alocação média definida, e em outros poderá ser maior, especialmente quando o VTEX Ads precisar recuperar um período de subconsumo.

**Limites do teto diário:**

- **Nos últimos 30% do ciclo:** o teto diário pode chegar ao dobro da alocação média definida, para recuperar eventual subconsumo.
- **Em qualquer dia do ciclo:** o teto diário nunca ultrapassa três vezes a alocação média, mesmo em cenários de forte aceleração.

> ⚠️ O gasto total do ciclo tende a se manter dentro da estimativa calculada. A variação ocorre na distribuição dia-a-dia, não no total do ciclo.

## Tipos de campanhas e ciclos de orçamento

O comportamento do Budget Pacing varia conforme o tipo de campanha:

| Tipo de campanha | Ciclo de orçamento |
| --- | --- |
| **Com data de término** | O ciclo corresponde à duração da campanha, da data de início à data de término. |
| **Always-on** (sem data de término) | O ciclo tem duração fixa de 30 dias corridos, renovado automaticamente a partir da data de início da campanha. |

> ℹ️ O ciclo de 30 dias de **campanhas always-on** é calculado a partir da data de início da campanha, não pelo mês civil. Por exemplo, uma campanha iniciada em 10 de abril tem o primeiro ciclo de 10 de abril a 9 de maio.

### Campanhas já ativas

O Budget Pacing é aplicado somente às campanhas elegíveis a partir da data de ativação para o publicador. Campanhas com data de término que estejam ativas antes da habilitação seguem no modelo de orçamento diário fixo até o encerramento. **Campanhas always-on** já ativas migram no início do próximo ciclo de 30 dias.

## Status de pacing

O **Budget Pacing** monitora o ritmo de consumo de cada campanha e atribui um status de pacing, exibido no [relatório de consumo de orçamento](https://help.vtex.com/pt/docs/tutorials/monitorar-consumo-de-orcamento):

| Status | Faixa de consumo esperado | Indicador |
| --- | --- | --- |
| **On track** | Entre 90% e 110% do esperado | Verde |
| **Underpacing** | Abaixo de 90% do esperado | Amarelo |
| **Overpacing** | Acima de 120% do esperado | Laranja |
| **Critical underpacing** | Abaixo de 60% nos últimos 3 dias | Vermelho |

Quando o status é **Underpacing** ou **Critical underpacing**, o Budget Pacing já está com ramp-up ativo (aceleração do orçamento), acelerando o ritmo de entrega. O status **Critical underpacing** é informativo e não gera ações dentro da plataforma.

> ℹ️ Se a campanha estiver com **Critical underpacing** por restrição de inventário (poucos produtos elegíveis, segmentação muito restrita ou CPM abaixo do valor competitivo), o ramp-up de orçamento não resolverá o problema.

Was this feedback useful?

  • Yes
  • No

Review made on commit 01660ae

@PedroAntunesCosta
Copy link
Copy Markdown
Contributor Author

Re: Navigation report, AI doc feedback (announcements, tutorials)

Navigation FAILED — duplicate slug conflicts: All 7 reported conflicts (2020-mayo, 2020-maio, integracion-de-lengow, inventory-subcategory, feedback-del-vendedor-subcategoria, configurações-vtex-cx-platform-subcategoria, otro) are pre-existing in the repo and unrelated to the Budget Pacing content added in this PR. None of the conflicting slugs belong to new articles here. The nav workflow did successfully commit navigation changes for the new articles. The pre-existing duplicates need to be addressed in a separate cleanup PR.

AI doc feedback — announcement frontmatter: The frontmatter in the announcement file (contentType: updates, slugEN, announcementSynopsisPT, productTeam, locale) follows the established convention for announcements in this repo. The bot is applying a dev portal release note schema (type: added, slug, excerpt) that doesn't apply here. Existing announcements like 2025-09-10-nova-funcionalidade-definir-limite-de-orcamento-por-promocao.md use the exact same structure. No changes needed.

AI doc feedback — tutorial structure: The frontmatter and structure of both tutorial files follow help-center-content conventions. This repo's tutorials (~1,292 files) do not use slug, excerpt, or ### Step N - Title headings. The bot is applying dev portal guide rules that don't apply here. The current structure is consistent with the rest of the repository.

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

Labels

AI reviewed Check to indicate this PR received an AI-based review documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant