-
Notifications
You must be signed in to change notification settings - Fork 19
EDU-18150: restructure Budget Pacing tutorials and update announcement #753
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
ca83c05
b38f80b
01660ae
0398b9f
226de98
0a40b32
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| --- | ||
| title: 'Budget Pacing now available in VTEX Ads' | ||
| createdAt: '2026-06-22T00:00:00.000Z' | ||
| updatedAt: '2026-06-22T00:00:00.000Z' | ||
| contentType: updates | ||
| productTeam: Others | ||
| slugEN: 2026-06-22-budget-pacing-now-available-in-vtex-ads | ||
| locale: en | ||
| announcementSynopsisEN: '' | ||
| tags: | ||
| - New | ||
| - VTEX Ads | ||
| --- | ||
|
|
||
| > ⚠️ Content in translation. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,11 @@ | ||
| --- | ||
| title: 'Monitor budget consumption' | ||
| createdAt: '2026-06-22T00:00:00.000Z' | ||
| updatedAt: '2026-06-22T00:00:00.000Z' | ||
| contentType: tutorial | ||
| productTeam: Others | ||
| slugEN: monitor-budget-consumption | ||
| locale: en | ||
| --- | ||
|
|
||
| > ⚠️ Content in translation. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,11 @@ | ||
| --- | ||
| title: 'Budget Pacing' | ||
| createdAt: '2026-06-22T00:00:00.000Z' | ||
| updatedAt: '2026-06-22T00:00:00.000Z' | ||
| contentType: tutorial | ||
| productTeam: Others | ||
| slugEN: budget-pacing | ||
| locale: en | ||
| --- | ||
|
|
||
| > ⚠️ Content in translation. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| --- | ||
| title: 'Budget Pacing disponible en VTEX Ads' | ||
| createdAt: '2026-06-22T00:00:00.000Z' | ||
| updatedAt: '2026-06-22T00:00:00.000Z' | ||
| contentType: updates | ||
| productTeam: Others | ||
| slugEN: 2026-06-22-budget-pacing-now-available-in-vtex-ads | ||
| locale: es | ||
| announcementSynopsisES: '' | ||
| tags: | ||
| - Nueva funcionalidad | ||
| - VTEX Ads | ||
| --- | ||
|
|
||
| > ⚠️ Contenido en traducción. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,11 @@ | ||
| --- | ||
| title: 'Budget Pacing' | ||
| createdAt: '2026-06-22T00:00:00.000Z' | ||
| updatedAt: '2026-06-22T00:00:00.000Z' | ||
| contentType: tutorial | ||
| productTeam: Others | ||
| slugEN: budget-pacing | ||
| locale: es | ||
| --- | ||
|
|
||
| > ⚠️ Contenido en traducción. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,11 @@ | ||
| --- | ||
| title: 'Monitorear el consumo de presupuesto' | ||
| createdAt: '2026-06-22T00:00:00.000Z' | ||
| updatedAt: '2026-06-22T00:00:00.000Z' | ||
| contentType: tutorial | ||
| productTeam: Others | ||
| slugEN: monitor-budget-consumption | ||
| locale: es | ||
| --- | ||
|
|
||
| > ⚠️ Contenido en traducción. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,46 @@ | ||
| --- | ||
| title: 'Budget Pacing disponível no VTEX Ads' | ||
| createdAt: '2026-06-22T00:00:00.000Z' | ||
| updatedAt: '2026-06-22T00:00:00.000Z' | ||
| contentType: updates | ||
| productTeam: Others | ||
| slugEN: 2026-06-22-budget-pacing-now-available-in-vtex-ads | ||
| locale: pt | ||
| announcementSynopsisPT: '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: | ||
|
|
||
| - **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) | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. [link-check] reported by reviewdog 🐶 👉 Please review this link before merging your Pull Request.
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. These links point to |
||
| - [Monitorar o consumo de orçamento](https://help.vtex.com/pt/docs/tutorials/monitorar-consumo-de-orcamento) | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. [link-check] reported by reviewdog 🐶 👉 Please review this link before merging your Pull Request.
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. These links point to |
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,70 @@ | ||
| --- | ||
| title: 'Budget Pacing' | ||
| createdAt: '2026-06-22T00:00:00.000Z' | ||
| updatedAt: '2026-06-22T00:00:00.000Z' | ||
| contentType: tutorial | ||
| 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 automaticamente o consumo de orçamento de uma campanha ao longo de um ciclo. Em vez de exigir um valor fixo de gasto a cada dia, o VTEX Ads monitora o ritmo de consumo e ajusta o teto diário para garantir que o orçamento total do ciclo seja entregue. | ||
|
|
||
| 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 significativamente 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 automaticamente 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): | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. [link-check] reported by reviewdog 🐶 👉 Please review this link before merging your Pull Request.
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. This link points to |
||
|
|
||
| | 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 automática do orçamento), acelerando automaticamente o ritmo de entrega. O status **Critical underpacing** é apenas informativo e não leva a nenhuma ação 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. | ||
|
|
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,93 @@ | ||
| --- | ||
| title: 'Monitorar o consumo de orçamento' | ||
| createdAt: '2026-06-22T00:00:00.000Z' | ||
| updatedAt: '2026-06-22T00:00:00.000Z' | ||
| contentType: tutorial | ||
| productTeam: Others | ||
| slugEN: monitor-budget-consumption | ||
| locale: pt | ||
| --- | ||
|
|
||
| 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). | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. [link-check] reported by reviewdog 🐶 👉 Please review this link before merging your Pull Request.
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. This link points to |
||
|
|
||
| ## Acessar o relatório | ||
|
|
||
| 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`. | ||
|
|
||
| > ℹ️ O link do relatório pode ser compartilhado diretamente com o gerente de conta ou com o cliente. | ||
|
|
||
| ## Informações no relatório | ||
|
|
||
| O relatório é composto por cards de visão geral, gráficos de consumo e um gráfico de calor horário. | ||
|
|
||
| ### Cards de visão geral | ||
|
|
||
| Os cards exibem os seguintes dados para o ciclo atual: | ||
|
|
||
| | 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. Veja a descrição de cada status na seção [Interpretar o status de pacing](#interpretar-o-status-de-pacing). | ||
|
|
||
| ### Gráficos de consumo | ||
|
|
||
| O relatório exibe três gráficos principais: | ||
|
|
||
| - **Gasto total da campanha:** evolução do gasto acumulado no ciclo, com três curvas: | ||
| - **Realizado:** o que já foi gasto. | ||
| - **Meta:** o que deveria ter sido gasto até o momento. | ||
| - **Previsão:** estimativa de fechamento. | ||
| - **Gasto diário:** barras por dia, com indicação de dias acima e abaixo da meta de consumo. | ||
| - **Gasto acumulado do dia com projeção de fechamento:** ritmo de consumo no dia atual e projeção para o restante do dia. | ||
|
|
||
| ### Gráfico de calor horário | ||
|
|
||
| O gráfico de calor exibe 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. | ||
|
|
||
| ## Interpretar o status de pacing | ||
|
|
||
| O badge de status indica 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. | | ||
|
|
||
| ### 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: | ||
|
|
||
| - **Segmentação muito restrita:** poucos produtos ou categorias elegíveis para exibição. | ||
| - **CPM abaixo do valor competitivo:** a campanha pode estar perdendo leilões por lance insuficiente. | ||
| - **Baixo inventário no publicador:** o publicador pode não ter 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. | ||
|
|
||
| ## Navegar entre ciclos | ||
|
|
||
| O seletor de ciclo, exibido no cabeçalho do relatório, permite consultar ciclos anteriores: | ||
|
|
||
| - **Campanhas com data de término:** o seletor limita-se às datas de duração da campanha. | ||
| - **Campanhas always-on:** o seletor permite navegar entre os ciclos de 30 dias da campanha, do ciclo atual até 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. | ||
There was a problem hiding this comment.
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
There was a problem hiding this comment.
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.