vtexads-api-docs

5.5.1. Recomendação de Nomes de Placements

Ter nomes padronizados e claros para os placements é essencial para medir corretamente o desempenho de cada área de anúncios do site/app, facilitar análises e acelerar diagnósticos.

Modelo recomendado de nomenclatura:

{meio}_{contexto}_{posicao}_{tipo}

Onde:

• meio: canal de acesso, ex.: site, msite (site móvel), app
• contexto: página/região de navegação, ex.: home, category, search, product, brand_page, digital_signage
• posicao: localização do bloco na página, ex.: top-vitrine, middle, bottom-vitrine, filter-bar
• tipo: tipo de criativo, ex.: product, banner, sponsored_brand

Boas práticas:

• Use letras minúsculas e sem espaços (use hífen para compostos, ex.: top-vitrine).
• Evite abreviações obscuras; mantenha consistência entre páginas e canais.
• O nome deve ser estável ao longo do tempo (não inclua datas, campanhas, etc.).

Exemplos:

meio	contexto	posição	tipo	exemplo
site	home	middle	banner	site_home_middle_banner
msite	product	top-vitrine	product	msite_product_top-vitrine_product
app	search	top-vitrine	product	app_search_top-vitrine_product
app	search	top-vitrine	banner	app_search_top-vitrine_banner
site	category	bottom-vitrine	banner	site_category_bottom-vitrine_banner
site	product	filter-bar	product	site_product_filter-bar_product

Observação: utilize os mesmos termos de canal e contexto que você envia na Consulta de Anúncios (5.5) para manter a rastreabilidade entre requisições e relatórios.