{"section":"tutorials","requestedLocale":"pt","requestedSlug":"promocoes-data-pipeline-beta","locale":"pt","slug":"promocoes-data-pipeline-beta","path":"docs/pt/tutorials/beta/vtex-data-pipeline-beta/promocoes-data-pipeline-beta.md","branch":"main","content":"O conjunto de dados de Promoções é constituído por quatro tabelas: `promotions_latest` e  `promotions_historical`. Essas tabelas abrange todo o ciclo de vida das campanhas promocionais.\n\nNesta seção você encontra as seguintes informações:\n\n- [Características dos dados de promoções](#caracteristicas-dos-dados-de-promocoes)  \n- [Tabela promotions_latest](#promotions-latest)  \n- [Tabela promotions_historical](#promotions-historical)\n- [Análise com dados de promoções](#analise-com-dados-de-promocoes)\n- [Correlações com outros dados](#correlacoes-com-outros-dados)\n\n## Características dos dados de promoções\n\n| **Característica** | **Descrição** |\n|:---:|:---:|\n| **Origem do dado** | São originadas do [módulo de Promoções](/pt/tracks/promocoes--6asfF1vFYiZgTQtOzwJchR) do Admin VTEX. |\n| **Disponibilidade** | Os dados de Promoções podem ser acessados através do Admin da VTEX e também por [APIs de Promotions](https://developers.vtex.com/docs/guides/promotions-overview). |\n| **Histórico** | Os dados são mantidos por dois anos, a partir de 2024 para clientes que já utilizam a plataforma VTEX. |\n| **Menor intervalo de atualização possível** | Uma hora. |  \n\n## Tabela promotions_latest\n\n| Nome da coluna | Tipo de coluna | Descrição da coluna |\n| ----- | ----- | ----- |\n| batch\\_id | character varying(256) | Identificador único do lote de dados, utilizado para rastrear e gerenciar a ingestão de dados. |\n| account | character varying(256) | Conta a qual está vinculada a promoção. |\n| id\\_calculator\\_configuration | character varying(256) | O ID da promoção. |\n| calculator\\_name | character varying(65535) | Nome da promoção. |\n| calculator\\_description | character varying(65535) | Descrição interna da promoção. |\n| begin\\_date\\_utc | timestamp without time zone | Data de início da promoção (UTC). |\n| end\\_date\\_utc | timestamp without time zone | Data de término da promoção (UTC). |\n| last\\_modified | timestamp without time zone | A última vez que a promoção foi alterada (UTC). |\n| days\\_ago\\_of\\_purchases | integer | Número de dias considerados para adicionar ao histórico de pedidos. |\n| is\\_active | boolean | Verdadeiro se a promoção estiver ativa no momento. |\n| is\\_archived | boolean | Verdadeiro se a promoção estiver arquivada no momento. |\n| is\\_featured | boolean | Verdadeiro se a promoção estiver em destaque no momento. |\n| disable\\_deal | boolean | Deprecado. Indica se uma oferta está desativada (true) ou não (false). |\n| offset | numeric(18,0) | O intervalo de tempo a ser aplicado às datas de início e término da promoção. |\n| activate\\_gifts\\_multiplier | boolean | Se configurado como verdadeiro, ativa o multiplicador de brindes. |\n| new\\_offset | numeric(18,0) | Novo intervalo de tempo em relação ao UTC em segundos. |\n| max\\_prices\\_per\\_items | super | Lista de preço máximo por itens. |\n| cumulative | boolean | Determina se a promoção pode ser acumulada com outras promoções de mesmo tipo de desconto. |\n| effect\\_type | character varying(256) | O tipo de efeito de uma promoção. |\n| discount\\_type | character varying(256) | O tipo de desconto que será aplicado à promoção. |\n| nominal\\_shipping\\_discount\\_value | numeric(18,0) | Desconto exato a ser aplicado ao valor do frete. |\n| absolute\\_shipping\\_discount\\_value | numeric(18,0) | Valor máximo do frete. |\n| nominal\\_discount\\_value | numeric(18,0) | Desconto exato a ser aplicado ao valor total do pedido. |\n| nominal\\_discount\\_type | character varying(256) | Controla o comportamento do efeito NominalDiscount. Este campo só aceita dois valores de string: \\-item: aplica o desconto nominal pretendido em cada item no carrinho. \\-cart: mantém o comportamento atual, no qual todo pedido/carrinho recebe um desconto nominal que é distribuído entre os itens. |\n| maximum\\_unit\\_price\\_discount | numeric(18,0) | O preço máximo para cada item do pedido será o preço configurado. |\n| percentual\\_discount\\_value | numeric(18,0) | Desconto percentual a ser aplicado sobre o valor total do pedido. |\n| rebate\\_percentual\\_discount\\_value | numeric(18,0) | Valor do desconto percentual do frete. |\n| percentual\\_shipping\\_discount\\_value | numeric(18,0) | Valor de desconto percentual que será aplicado ao valor do frete. |\n| percentual\\_tax | numeric(18,0) | Taxa percentual sobre o valor total do pedido. |\n| shipping\\_percentual\\_tax | numeric(18,0) | Taxa percentual de frete sobre o valor total do pedido. |\n| percentual\\_discount\\_value\\_list1 | numeric(18,0) | Descontos válidos para os SKUs na listSku1BuyTogether, lista de descontos usada para promoções de Compre Junto. |\n| percentual\\_discount\\_value\\_list2 | numeric(18,0) | Equivalente a percentualDiscountValueList1. |\n| skus\\_gift | super | Objeto do SKU de brinde. Desconto total sobre o valor do produto definido como brinde. quantitySelectable: quantidade de SKUs de brinde. gifts: array com IDs de SKU de brinde.   |\n| nominal\\_reward\\_value | numeric(18,0) | Valor nominal para programas de fidelidade. |\n| percentual\\_reward\\_value | numeric(18,0) | Valor percentual para programas de fidelidade. |\n| order\\_status\\_reward\\_value | character varying(256) | Valor do benefício do status do pedido. |\n| apply\\_to\\_all\\_shippings | boolean | Especifica se a promoção se aplica a todos os tipos de envio ou apenas ao mais barato. |\n| nominal\\_tax | numeric(18,0) | Taxa nominal. |\n| max\\_pack\\_value | numeric(18,0) | Valor máximo do pacote. |\n| origin | character varying(256) | Origem da promoção: marketplace ou fulfillment.    |\n| id\\_seller\\_is\\_inclusive | boolean | Se estiver definido como verdadeiro, esta promoção será aplicada a qualquer seller no campo idSeller. Se estiver definido como falso, os sellers presentes neste campo não aplicarão a promoção. |\n| ids\\_sales\\_channel | super | Lista de políticas comerciais que ativam uma promoção. |\n| are\\_sales\\_channel\\_ids\\_exclusive | boolean | Se estiver definido como falso, esta promoção será aplicada a qualquer política comercial no campo idsSalesChannel. Se estiver definido como verdadeiro, as políticas comerciais presentes neste campo não aplicarão a promoção. |\n| marketing\\_tags | super | Tags de marketing da promoção. |\n| marketing\\_tags\\_are\\_not\\_inclusive | boolean | Se estiver definido como falso, esta promoção será aplicada a qualquer tag de marketing no campo marketingTags. Se estiver definido como verdadeiro, as tags de marketing presentes neste campo não aplicarão a promoção. |\n| payments\\_methods | super | Array composto por todos os meios de pagamento. id: ID do meio de pagamento.  name: nome do meio de pagamento. |\n| stores | super | Lista de lojas. |\n| campaigns | super | Audiência de campanhas que ativam uma promoção. |\n| stores\\_are\\_inclusive | boolean | Deprecado. Se estiver definido como verdadeiro, esta promoção será aplicada a qualquer loja no campo stores. Se estiver definido como falso, as lojas presentes neste campo não aplicarão a promoção. |\n| categories | super | Objeto composto pelas categorias que irão ativar ou desativar a promoção. id: ID da categoria name: nome da categoria. |\n| categories\\_are\\_inclusive | boolean | Se estiver definido como verdadeiro, esta promoção será aplicada a todas categorias presentes no campo categories. Se estiver definido como falso, as categorias presentes neste campo não aplicarão a promoção. |\n| brands | super | Objeto composto pelas marcas que irão ativar ou desativar a promoção. |\n| brands\\_are\\_inclusive | boolean | Se estiver definido como verdadeiro, esta promoção será aplicada às marcas presentes no campo brands. Se estiver definido como falso, as marcas presentes neste campo não aplicarão a promoção. |\n| products | super | Objeto composto pelos produtos que irão ativar ou desativar a promoção. |\n| products\\_are\\_inclusive | boolean | Se estiver definido como verdadeiro, esta promoção será aplicada a qualquer produto presente no campo products. Se estiver definido como falso, os produtos presentes neste campo não aplicarão a promoção. |\n| skus | super | Objeto composto pelos SKUs que irão ativar ou desativar a promoção. |\n| skus\\_are\\_inclusive | boolean | Se estiver definido como verdadeiro, esta promoção será aplicada aos SKUs presentes no campo SKUs. Se estiver definido como falso, os SKUs presentes neste campo não aplicarão a promoção. |\n| collections1\\_buy\\_together | super | Coleções que irão gerar a promoção do tipo Compre Junto, Leve Mais por Menos, Desconto Progressivo, Compre e Ganhe. |\n| collections2\\_buy\\_together | super | Coleções que irão gerar a promoção do tipo Compre Junto, Leve Mais por Menos, Desconto Progressivo ou Compre e Ganhe. |\n| minimum\\_quantity\\_buy\\_together | integer | Quantidade mínima para promoção Compre Junto. |\n| quantity\\_to\\_affect\\_buy\\_together | integer | Quantidade que vai afetar a promoção Compre Junto. |\n| enable\\_buy\\_together\\_per\\_sku | boolean | Ativar Compre Junto por SKU. |\n| list\\_sku1\\_buy\\_together | super | Array de objetos, cada unidade contendo ID e nome de um SKU para ser adicionado à primeira lista da promoção **Compre Junto**. Saiba mais sobre este tipo de promoção na documentação [Criar promoção Compre Junto](/pt/docs/tutorials/compre-junto).  ⮕  Objeto contendo o ID e o nome do SKU a ser adicionado à primeira lista da promoção **Compre Junto**.  Saiba mais sobre este tipo de promoção na documentação de [Criar promoção Compre Junto](/pt/docs/tutorials/compre-junto).  |\n| list\\_sku2\\_buy\\_together | super | Array de objetos, cada unidade contendo ID e nome de um SKU para ser adicionado à segunda lista da promoção **Compre Junto**. Saiba mais sobre este tipo de promoção na documentação [Criar promoção Compre Junto](/pt/docs/tutorials/compre-junto).  ⮕ Objeto contendo o ID e o nome do SKU a ser adicionado à segunda lista da promoção **Compre Junto**. Saiba mais sobre este tipo de promoção na documentação de [Criar promoção Compre Junto](/pt/docs/tutorials/compre-junto).  |\n| coupon | super | Deprecado. Lista de cupons. |\n| total\\_value\\_floor | numeric(18,0) | Valor mínimo do carrinho para ativar a promoção. |\n| total\\_value\\_ceiling | numeric(18,0) | Valor máximo do carrinho para ativar a promoção. |\n| total\\_value\\_include\\_all\\_items | boolean | Deprecado. Valor total incluindo todos os itens. |\n| total\\_value\\_mode | character varying(256) | Define quais itens são considerados para calcular o valor total do carrinho. |\n| collections | super | Array composto pelas coleções que irão ativar ou desativar a promoção. |\n| collections\\_is\\_inclusive | boolean | Se estiver definido como verdadeiro, esta promoção será aplicada a qualquer coleção presente no campo collections. Se estiver definido como falso, as coleções presentes neste campo não aplicarão a promoção. |\n| restrictions\\_bins | super | O desconto será concedido se o BIN do cartão for fornecido. |\n| card\\_issuers | super | Lista de emissores de cartão. |\n| total\\_value\\_purchase | numeric(18,0) | Valor total que um cliente deve ter em pedidos anteriores para ativar a promoção. |\n| slas\\_ids | super | O desconto será concedido se o método de envio for o mesmo que o indicado. |\n| is\\_sla\\_selected | boolean | Aplica o desconto selecionado somente quando um dos métodos de envio definidos for selecionado pelo cliente. |\n| is\\_first\\_buy | boolean | Indica se a promoção é válida apenas para o primeiro pedido do usuário. |\n| first\\_buy\\_is\\_profile\\_optimistic | boolean | Aplica o desconto mesmo se o usuário não estiver logado. |\n| compare\\_list\\_price\\_and\\_price | boolean | Indica se o **preço de lista** e o **preço** são iguais. |\n| is\\_different\\_list\\_price\\_and\\_price | boolean | Aplica a promoção apenas se o preço de lista e o preço forem diferentes. |\n| zip\\_code\\_ranges | super | Faixa de CEP em que se aplica a promoção. |\n| item\\_max\\_price | numeric(18,0) | A configuração do preço máximo para um item ativar a promoção. |\n| item\\_min\\_price | numeric(18,0) | A configuração do preço mínimo para um item ativar a promoção. |\n| installment | integer | Deprecado. Parcelas. |\n| is\\_min\\_max\\_installments | boolean | Define se a promoção será aplicada considerando valores mínimos e máximos para as parcelas. |\n| min\\_installment | integer | Valor mínimo da parcela. |\n| max\\_installment | integer | Valor máximo da parcela. |\n| merchants | super | Lista de lojistas. |\n| cluster\\_expressions | super | Critérios para selecionar um cluster de clientes. Cada item neste array deve seguir o formato de uma função de igualdade (\\{propertyname\\}=\\{value\\}) ou de uma função contains (\\{propertyname\\} contains \\{value\\}). Em ambas as opções, \\{propertyname\\} deve ser substituído pelo nome do campo na entidade de dados, e \\{value\\} deve ser substituído pelo valor definido no Master Data.  Saiba mais sobre esses critérios em [Como preencher o campo Cluster de clientes](/pt/docs/tutorials/criando-promocao-para-um-cluster-de-clientes#filling-in-the-customer-cluster-field). |\n| pii\\_cluster\\_expressions | super | Expressões de cluster relacionadas às informações de identificação pessoal (PII) dos clientes. |\n| payments\\_rules | super | Lista de regras de pagamento. |\n| gift\\_list\\_types | super | Tipo de brindes da lista. |\n| products\\_specifications | super | Lista de especificações de produtos. |\n| affiliates | super | Identificador de pedidos do marketplace. O desconto será aplicado aos afiliados selecionados. |\n| max\\_usage | integer | Define quantas vezes a promoção pode ser usada. |\n| max\\_usage\\_per\\_client | integer | Define se a promoção pode ser usada várias vezes pelo cliente. |\n| should\\_distribute\\_discount\\_among\\_matched\\_items | boolean | Distribui o desconto entre os items correspondentes. |\n| multiple\\_use\\_per\\_client | boolean | Define se a promoção pode ser usada várias vezes pelo cliente. |\n| type | character varying(256) | Define qual é o tipo da promoção ou indica se é uma taxa. Valores possíveis: regular [Promoção Regular](/pt/docs/tutorials/promocao-regular-pt), combo [Compre Junto](/pt/docs/tutorials/compre-junto), forThePriceOf [Leve Mais por Menos](/pt/docs/tutorials/leve-mais-por-menos), progressive [Desconto Progressivo](/pt/docs/tutorials/desconto-progressivo), buyAndWin [Compre e Ganhe](/pt/docs/tutorials/compre-e-ganhe), maxPricePerItem (deprecado), campaign [Promoção de campanha](/pt/docs/tutorials/promocao-de-campanha), tax (taxa), multipleEffects (efeitos múltiplos). |\n| use\\_new\\_progressive\\_algorithm | boolean | Indica se é usado um algoritmo progressivo. |\n| percentual\\_discount\\_value\\_list | super | Lista de valores de desconto percentual |\n| max\\_number\\_of\\_affected\\_items | integer | Número máximo de itens afetados por uma promoção. |\n| max\\_number\\_of\\_affected\\_items\\_group\\_key | character varying(256) | Número máximo de itens afetados por chave de grupo de uma promoção. |  \n\n## Tabela promotions_historical\n\n| Nome da coluna | Tipo de coluna | Descrição da coluna |\n| ----- | ----- | ----- |\n| operation | character varying(256) | A operação executada pelo autor. |\n| batch\\_id | character varying(256) | Identificador único do lote de dados, utilizado para rastrear e gerenciar a ingestão de dados. |\n| account | character varying(256) | Conta a qual está vinculada a promoção. |\n| author | character varying(512) | O autor da operação fornecida. |\n| id\\_calculator\\_configuration | character varying(256) | O ID da promoção. |\n| calculator\\_name | character varying(1024)         | Nome da promoção. |\n| calculator\\_description | character varying(65535)         | Descrição interna da promoção. |\n| begin\\_date\\_utc | timestamp without time zone | Data de início da promoção (UTC). |\n| end\\_date\\_utc | timestamp without time zone | Data de término da promoção (UTC). |\n| last\\_modified | timestamp without time zone | A última vez que a promoção foi alterada (UTC). |\n| days\\_ago\\_of\\_purchases | integer | Número de dias considerados para adicionar ao histórico de pedidos. |\n| is\\_active | boolean | Verdadeiro se a promoção estiver ativa no momento. |\n| is\\_archived | boolean | Verdadeiro se a promoção estiver arquivada no momento. |\n| is\\_featured | boolean | Verdadeiro se a promoção estiver em destaque no momento. |\n| disable\\_deal | boolean | Deprecado. Indica se uma oferta está desativada (true) ou não (false). |\n| offset | numeric(18,0) | O intervalo de tempo a ser aplicado às datas de início e término da promoção. |\n| activate\\_gifts\\_multiplier | boolean | Se configurado como verdadeiro, ativa o multiplicador de brindes. |\n| new\\_offset | numeric(18,0) | Novo intervalo de tempo em relação ao UTC em segundos. |\n| max\\_prices\\_per\\_items | super | Lista de preço máximo por itens. |\n| cumulative | boolean | Determina se a promoção pode ser acumulada com outras promoções de mesmo tipo de desconto. |\n| effect\\_type | character varying(256) | O tipo de efeito de determinada promoção. |\n| discount\\_type | character varying(256) | O tipo de desconto que será aplicado à promoção. |\n| nominal\\_shipping\\_discount\\_value | numeric(18,0) | Desconto exato a ser aplicado ao valor do frete. |\n| absolute\\_shipping\\_discount\\_value | numeric(18,0) | Valor máximo do frete. |\n| nominal\\_discount\\_value | numeric(18,0) | Desconto exato a ser aplicado ao valor total do pedido. |\n| nominal\\_discount\\_type | character varying(256) | Controla o comportamento do efeito NominalDiscount. Este campo só aceita dois valores de string: <ul>item: aplica o desconto nominal pretendido em cada item no carrinho. cart: mantém o comportamento atual, no qual todo pedido recebe um desconto nominal que é distribuído entre os itens.</ul> |\n| maximum\\_unit\\_price\\_discount | numeric(18,0) | O preço máximo para cada item do pedido será o preço configurado. |\n| percentual\\_discount\\_value | numeric(18,0) | Desconto percentual a ser aplicado sobre o valor total do pedido. |\n| rebate\\_percentual\\_discount\\_value | numeric(18,0) | Valor do desconto percentual do frete. |\n| percentual\\_shipping\\_discount\\_value | numeric(18,0) | Valor de desconto percentual que será aplicado ao valor do frete. |\n| percentual\\_tax | numeric(18,0) | Taxa percentual sobre o valor total do pedido. |\n| shipping\\_percentual\\_tax | numeric(18,0) | Taxa percentual sobre o valor total do pedido. |\n| percentual\\_discount\\_value\\_list1 | numeric(18,0) | Descontos válidos para os SKUs na listSku1BuyTogether, lista de descontos usada para promoções de Compre Junto. |\n| percentual\\_discount\\_value\\_list2 | numeric(18,0) | Equivalente a percentualDiscountValueList1. |\n| skus\\_gift | super | Objeto do SKU de brinde. Desconto total sobre o valor do produto definido como brinde. <ul> quantitySelectable: quantidade de SKUs de brinde. gifts: array com IDs de SKU de brinde. </ul>   |\n| nominal\\_reward\\_value | numeric(18,0) | Valor nominal para programas de fidelidade. |\n| percentual\\_reward\\_value | numeric(18,0) | Valor percentual para programas de fidelidade. |\n| order\\_status\\_reward\\_value | character varying(256) | Valor do benefício do status do pedido. |\n| apply\\_to\\_all\\_shippings | boolean | Especifica se a promoção se aplica a todos os tipos de envio ou apenas ao mais barato. |\n| nominal\\_tax | numeric(18,0) | Taxa nominal. |\n| max\\_pack\\_value | numeric(18,0) | Valor máximo do pacote. |\n| origin | character varying(256) | Origem da promoção: marketplace ou fulfillment.    |\n| id\\_seller\\_is\\_inclusive | boolean | Se estiver definido como verdadeiro, esta promoção será aplicada a qualquer seller no campo idSeller. Se estiver definido como falso, os sellers presentes neste campo não aplicarão a promoção. |\n| ids\\_sales\\_channel | super | Lista de políticas comerciais que ativam uma promoção. |\n| are\\_sales\\_channel\\_ids\\_exclusive | boolean | Se estiver definido como falso, esta promoção será aplicada a qualquer política comercial no campo idsSalesChannel. Se estiver definido como verdadeiro, as políticas comerciais presentes neste campo não aplicarão a promoção. |\n| marketing\\_tags | super | Tags de marketing da promoção. |\n| marketing\\_tags\\_are\\_not\\_inclusive | boolean | Se estiver definido como falso, esta promoção será aplicada a qualquer tag de marketing no campo marketingTags. Se estiver definido como verdadeiro, as tags de marketing presentes neste campo não aplicarão a promoção. |\n| payments\\_methods | super | Array composto por todos os meios de pagamento. <ul>id: ID do meio de pagamento. name: nome do meio de pagamento.</ul> |\n| stores | super | Lista de lojas. |\n| campaigns | super | Audiência de campanhas que ativam uma promoção. |\n| stores\\_are\\_inclusive | boolean | Deprecado. Se estiver definido como verdadeiro, esta promoção será aplicada a qualquer loja no campo stores. Se estiver definido como falso, as lojas presentes neste campo não aplicarão a promoção. |\n| categories | super | Objeto composto pelas categorias que irão ativar ou desativar a promoção. <ul>id: ID da categoria. name: nome da categoria.</ul> |\n| categories\\_are\\_inclusive | boolean | Se estiver definido como verdadeiro, esta promoção será aplicada a qualquer categoria no campo categories. Se estiver definido como falso, as categorias presentes neste campo não aplicarão a promoção. |\n| brands | super | Objeto composto pelas marcas que irão ativar ou desativar a promoção. |\n| brands\\_are\\_inclusive | boolean | Se estiver definido como verdadeiro, esta promoção será aplicada às marcas presentes no campo brands. Se estiver definido como falso, as marcas presentes neste campo não aplicarão a promoção. |\n| products | super | Objeto composto pelos produtos que irão ativar ou desativar a promoção. |\n| products\\_are\\_inclusive | boolean | Se estiver definido como verdadeiro, esta promoção será aplicada aos produtos presentes no campo products. Se estiver definido como falso, os produtos presentes neste campo não aplicarão a promoção. |\n| skus | super | Objeto composto pelos SKUs que irão ativar ou desativar a promoção. |\n| skus\\_are\\_inclusive | boolean | Se estiver definido como verdadeiro, esta promoção será aplicada aos SKUs presentes no campo SKUs. Se estiver definido como falso, os SKUs presentes neste campo não aplicarão a promoção. |\n| collections1\\_buy\\_together | super | Coleções que irão gerar a promoção do tipo Compre Junto, Leve Mais por Menos, Desconto Progressivo, Compre e Ganhe. |\n| collections2\\_buy\\_together | super | Coleções que irão gerar a promoção do tipo Compre Junto, Leve Mais por Menos, Desconto Progressivo ou Compre e Ganhe. |\n| minimum\\_quantity\\_buy\\_together | integer | Quantidade mínima para promoção Compre Junto. |\n| quantity\\_to\\_affect\\_buy\\_together | integer | Quantidade para a promoção Compre Junto. |\n| enable\\_buy\\_together\\_per\\_sku | boolean | Ativar Compre Junto por SKU. |\n| list\\_sku1\\_buy\\_together | super | Array de objetos, cada unidade contendo ID e nome de um SKU para ser adicionado à primeira lista da promoção **Compre Junto**.  Saiba mais sobre este tipo de promoção na documentação [Criar promoção Compre Junto](/pt/docs/tutorials/compre-junto). ⮕ Objeto contendo o ID e o nome do SKU a ser adicionado à primeira lista da promoção **Compre Junto**. Saiba mais sobre este tipo de promoção na documentação de [Criar promoção Compre Junto](/pt/docs/tutorials/compre-junto).  |\n| list\\_sku2\\_buy\\_together | super | Array de objetos, cada unidade contendo ID e nome de um SKU para ser adicionado à segunda lista da promoção **Compre Junto**.  Saiba mais sobre este tipo de promoção na documentação [Criar promoção Compre Junto](/pt/docs/tutorials/compre-junto).  ⮕ Objeto contendo o ID e o nome do SKU a ser adicionado à segunda lista da promoção **Compre Junto**. Saiba mais sobre este tipo de promoção na documentação de [Criar promoção Compre Junto](/pt/docs/tutorials/compre-junto).   |\n| coupon | super | Deprecado. Lista de cupons. |\n| total\\_value\\_floor | numeric(18,0) | Valor mínimo do carrinho para ativar a promoção. |\n| total\\_value\\_ceiling | numeric(18,0) | Valor máximo do carrinho para ativar a promoção. |\n| total\\_value\\_include\\_all\\_items | boolean | Deprecado. Valor total incluindo todos os itens. |\n| total\\_value\\_mode | character varying(256) | Define quais itens são considerados para calcular o valor total do carrinho. |\n| collections | super | Array composto pelas coleções que irão ativar ou desativar a promoção. |\n| collections\\_is\\_inclusive | boolean | Se estiver definido como verdadeiro, esta promoção será aplicada a qualquer coleção presente no campo collections. Se estiver definido como falso, as coleções presentes neste campo não aplicarão a promoção. |\n| restrictions\\_bins | super | O desconto será concedido se o BIN do cartão for fornecido. |\n| card\\_issuers | super | Lista de emissores de cartão. |\n| total\\_value\\_purchase | numeric(18,0) | Valor total que um cliente deve ter em pedidos anteriores para ativar a promoção. |\n| slas\\_ids | super | O desconto será concedido se o método de envio for o mesmo que o indicado. |\n| is\\_sla\\_selected | boolean | Aplica o desconto selecionado somente quando um dos métodos de envio definidos for selecionado pelo cliente. |\n| is\\_first\\_buy | boolean | Indica se a promoção é válida apenas para o primeiro pedido do usuário. |\n| first\\_buy\\_is\\_profile\\_optimistic | boolean | Aplica o desconto mesmo se o usuário não estiver logado. |\n| compare\\_list\\_price\\_and\\_price | boolean | Indica se o **preço de lista** e o **preço** são iguais. |\n| is\\_different\\_list\\_price\\_and\\_price | boolean | Aplica a promoção apenas se o preço de lista e o preço forem diferentes. |\n| zip\\_code\\_ranges | super | Faixa de CEP em que se aplica a promoção. |\n| item\\_max\\_price | numeric(18,0) | A configuração do preço máximo para um item ativar a promoção. |\n| item\\_min\\_price | numeric(18,0) | A configuração do preço mínimo para um item ativar a promoção. |\n| installment | integer | Deprecado. Parcelas. |\n| is\\_min\\_max\\_installments | boolean | Define se a promoção será aplicada considerando valores mínimos e máximos para parcelas. |\n| min\\_installment | integer | Valor mínimo da parcela. |\n| max\\_installment | integer | Valor máximo da parcela. |\n| merchants | super | Lista de lojistas. |\n| cluster\\_expressions | super | Critérios para selecionar um cluster de clientes. Cada item neste array deve seguir o formato de uma função de igualdade (\\{propertyname\\}=\\{value\\}) ou de uma função contains (\\{propertyname\\} contains \\{value\\}). Em ambas as opções, \\{propertyname\\} deve ser substituído pelo nome do campo na entidade de dados, e \\{value\\} deve ser substituído pelo valor definido no Master Data.  Saiba mais sobre esses critérios em [Como preencher o campo Cluster de clientes](/pt/docs/tutorials/criando-promocao-para-um-cluster-de-clientes#filling-in-the-customer-cluster-field).  |\n| pii\\_cluster\\_expressions | super | Expressões de cluster relacionadas às informações de identificação pessoal (PII) dos clientes. |\n| payments\\_rules | super | Lista de regras de pagamento. |\n| gift\\_list\\_types | super | Tipo de brindes da lista. |\n| products\\_specifications | super | Lista de especificações de produtos. |\n| affiliates | super | Identificador de pedidos do marketplace. O desconto será aplicado aos afiliados selecionados. |\n| max\\_usage | integer | Define quantas vezes a promoção pode ser usada. |\n| max\\_usage\\_per\\_client | integer | Define se a promoção pode ser usada várias vezes pelo cliente. |\n| should\\_distribute\\_discount\\_among\\_matched\\_items | boolean | Distribui o desconto entre os items correspondentes. |\n| multiple\\_use\\_per\\_client | boolean | Define se a promoção pode ser usada várias vezes pelo cliente. |\n| type | character varying(256) | Define qual é o tipo da promoção ou indica se é uma taxa. Valores possíveis: regular [Promoção Regular](/pt/docs/tutorials/promocao-regular-pt), combo [Compre Junto](/pt/docs/tutorials/compre-junto), forThePriceOf [Leve Mais por Menos](/pt/docs/tutorials/leve-mais-por-menos), progressive [Desconto Progressivo](/pt/docs/tutorials/desconto-progressivo), buyAndWin [Compre e Ganhe](/pt/docs/tutorials/compre-e-ganhe), maxPricePerItem (deprecado), campaign [Promoção de campanha](/pt/docs/tutorials/promocao-de-campanha), tax (taxa), multipleEffects (efeitos múltiplos). |\n| use\\_new\\_progressive\\_algorithm | boolean | Indica se é usado um algoritmo progressivo. |\n| percentual\\_discount\\_value\\_list | super | Lista de valores de desconto percentual. |\n| max\\_number\\_of\\_affected\\_items | integer | Número máximo de itens afetados por uma promoção. |\n| max\\_number\\_of\\_affected\\_items\\_group\\_key | character varying(256) | Número máximo de itens afetados por chave de grupo de uma promoção. |\n\n## Análise com dados de Promoções\n\nVeja a seguir alguns exemplos de análises com o conjunto de sados de promoções:\n\n**- Análise de ciclo de vida da promoção:** compare a frequência e duração das promoções para avaliar a longevidade e o sucesso das campanhas.  \n**- Taxa de reativação de promoções:** analise quantas promoções são reativadas para determinar a eficácia de reutilizar ou revisar campanhas anteriores.  \n**- Tendências de remoção de promoções:** rastreie o número e os tipos de promoções descontinuadas para entender os motivos da remoção e ajustar futuras estratégias.  \n**- Impacto de novas promoções:** compare os lançamentos de promoções com as vendas e o tráfego para avaliar seu impacto imediato.  \n\n## Correlações com outros dados\n\nVeja a seguir a correlação do conjunto de dados de promoções, com alguns outros conjuntos de dados:\n\n**- Dados de [pedidos](/pt/docs/tutorials/pedidos-data-pipeline-beta):** a análise da influência das promoções nos pedidos ajuda a compreender seu impacto nas vendas.  \n**- Dados de [inventário](/pt/docs/tutorials/inventario-data-pipeline-beta):** a correlação com o inventário é crucial para garantir a disponibilidade de produtos promovidos.  \n**- Análises de marketing e publicidade:** a integração com esses dados permite medir a efetividade das promoções em atrair tráfego e engajamento.\n**- Dados de [navegação no Site](/pt/docs/tutorials/navegacao-data-pipeline-beta):** analisar o efeito das promoções na navegação fornece insights sobre o comportamento do cliente e a eficácia da colocação das promoções. \n\n### Conheça outros Conjuntos de dados\n\n- [Catálogo](/pt/docs/tutorials/catalogo-data-pipeline)\n- [Inventário](/pt/docs/tutorials/inventario-data-pipeline-beta)\n- [Navegação](/pt/docs/tutorials/navegacao-data-pipeline-beta) \n- [Pedidos](/pt/docs/tutorials/pedidos-data-pipeline-beta) \n- [Pagamentos](/pt/docs/tutorials/pagamentos-data-pipeline-beta)  \n- [Preços](/pt/docs/tutorials/precos-data-pipeline-beta)   \n- [Vale-presente](/pt/docs/tutorials/vale-presente-data-pipeline)\n[Logs do Bridge](/pt/docs/tutorials/logs-do-bridge-data-pipeline)"}