> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-product-boost-campaigns.md).
# Carregue campanhas de Product Boost em massa
Você pode usar a ferramenta de carregamento em massa para criar várias campanhas de Product Boost de uma vez, em vez de criá-las individualmente. Você usará um arquivo CSV ou Excel para fornecer os detalhes dos campos que, de outra forma, preencheria durante a configuração.
{% stepper %}
{% step %}
## Prepare seu arquivo
1. Copie ou baixe este arquivo de modelo para o seu dispositivo:
{% code overflow="wrap" %}
```
Nome da campanha,ID do fornecedor,ID interno da campanha,Financiamento,Tipo de elegibilidade,IDs de parceiros,IDs de grupos de parceiros,Orçamento,Orçamento imposto,Rascunho,Data de início,Data de término,ID do tipo de evento,Tipo de pagamento,Valor do pagamento,Precedência,Regras
Winter Boot Promo,,EXAMPLE-001,,JOINED_PARTNERS,,,1000.00,no,yes,2026-08-01T00:00:00-07:00,2026-08-31T23:59:59-07:00,17897,FIXED,5.00,10,ITEM_SKU IS BOOT123
```
{% endcode %}
2. Substitua a linha de exemplo pelos detalhes da sua própria campanha e preencha uma linha para cada campanha que deseja criar.
* Compare seus valores com a [referência de formato de arquivo](#file-format-reference) abaixo para garantir que você insira os dados corretos e nos formatos exigidos.
* Para adicionar várias regras de grupos de pagamento a uma única campanha, consulte a [seção de grupos de pagamento](#add-multiple-payout-groups) abaixo.
3. Salve as edições no seu arquivo com um nome apropriado, por exemplo, `Product_Boost_Bulk_Upload`. Certifique-se de que o arquivo seja salvo no `.csv` ou `.xlsx` formato.
{% endstep %}
{% step %}
## Envie suas campanhas
1. Na barra de navegação à esquerda, selecione  **\[Engage]** → **Gerenciador de Campanhas** → [**Product Boost**](https://app.impact.com/secure/advertiser/engage/campaigns/manage-rate-boost-campaigns-flow.ihtml?execution=e3s1#sortBy=dateOfEntry\&sortOrder=ASC).
2. No canto superior direito da tela, selecione **Carregamento em massa**.
3. Selecione **Escolher arquivo** ou arraste e solte o arquivo que você preparou para o envio.
4. Selecione **Próximo**.
{% endstep %}
{% step %}
## Revise quaisquer erros de validação
1. Revise os dados enviados em busca de erros.
* As falhas de validação serão destacadas em vermelho, com os erros listados na primeira coluna para que você os corrija.
* Cada linha representa uma única campanha. Para filtrar as linhas que foram validadas com sucesso, selecione  **\[Caixa de seleção] Mostrar apenas erros**.
2. Se houver erros no seu arquivo, selecione **Voltar** para retornar à etapa de envio. Consulte a [referência de erros de validação](#validation-error-reference) abaixo para orientações sobre como corrigir os erros.
* Quando todas as linhas estiverem corretas e mostrarem *OK* na primeira coluna, suas campanhas estarão prontas para serem criadas.
{% endstep %}
{% step %}
## Aprovar criação da campanha
1. Selecione **Aceitar e criar campanhas**.
* As novas campanhas enviadas aparecerão na sua lista de campanhas.
2. Em seguida, saiba o que significa cada status da campanha Product Boost e como [gerenciá-los](/brand/pt-br/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/manage-product-boost-campaigns.md).
{% endstep %}
{% endstepper %}
## Referências
Referência de formato de arquivo
Use esta referência como guia ao atualizar os dados de exemplo no seu arquivo com os detalhes da sua campanha.
| Nome da Coluna | Tipo | Obrigatório | Descrição |
| -------------------------- | ------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nome da campanha | String | Sim | O nome da campanha |
| ID do fornecedor | Inteiro | Não | O ID do fornecedor, se aplicável. Isso pode ser obtido na sua [*Meus Fornecedores*](/brand/pt-br/what-would-you-like-to-learn-about/beta-product-boost/beta-product-boost-for-retailers/get-started-with-retail-media-as-a-retailer.md#step-2-view-your-listed-vendors) página |
| ID interno da campanha | String | Não | Seu próprio identificador opcional para esta campanha |
| Financiamento | String | Não | Os detalhes de financiamento da campanha |
| Tipo de elegibilidade | String | Sim | Identifique os parceiros elegíveis que serão contratados automaticamente. Para grupos ou parceiros específicos, adicione os IDs e separe-os por vírgulas. Valores permitidos: `JOINED_PARTNERS`, `PARTNER_GROUPS`, `INDIVIDUAL_PARTNERS` |
| IDs dos parceiros | string CSV | Não | IDs de parceiros separados por vírgulas. Obrigatório quando o Tipo de elegibilidade for `INDIVIDUAL_PARTNERS`. |
| IDs de grupos de parceiros | string CSV | Não | IDs de grupos de parceiros separados por vírgulas. Obrigatório quando o Tipo de elegibilidade for `PARTNER_GROUPS`. |
| Orçamento | Decimal(8,2) | Sim | Orçamento total da campanha |
| Orçamento imposto | Booleano | Não | Deixe em branco se não quiser aplicar. Valores aceitos: `sim`, `true` (encerre a campanha automaticamente quando o orçamento for totalmente gasto) ou `no`, `false` (não aplicar). |
| Rascunho | Booleano | Sim | Se a campanha deve ser salva como rascunho. Valores aceitos: `sim`, `true` (salvar como rascunho) ou `no`, `false` (ativo imediatamente). |
| Data de início | Data | Sim | Data ISO8601. Exemplo: `2013-06-30T00:00:00-07:00` |
| Data de término | Data | Sim | Data ISO8601. Exemplo: `2013-06-30T00:00:00-07:00` |
| ID do tipo de evento | Inteiro | Sim | O ID numérico do tipo de evento para o rastreador de pagamento principal desta campanha. |
| Tipo de pagamento | String | Sim | O tipo de pagamento para este evento (por ex. `PERCENTAGE` ou `FIXED`). |
| Valor do pagamento | Decimal(8,2) | Sim | O valor do pagamento para este tipo de evento. Deve ser maior que zero. |
| Precedência | Inteiro | Sim | Prioridade da campanha de 1 (mais alta) a 10 (mais baixa). |
| Regras | String | Sim | Uma condição de elegibilidade no formato `[VARIABLE] [OPERATOR] [VALUE]` por ex., `ITEM_SKU IS HYD-2000`. Saiba mais sobre como [definir regras de grupos de pagamento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/set-payout-rules-using-payout-groups.md). |
Referência de erro de validação
Se os dados enviados contiverem erros de validação, encontre a mensagem de erro abaixo para ver o que provavelmente está causando o problema e como corrigi-lo.
| Mensagem de erro | Como corrigir |
| ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A data de início do tempo limitado é inválida | Verifique se o seu `Data de início` tem um valor, é anterior a `Data de término`, e está no formato ISO8601 (ex.: `2026-08-01T00:00:00-07:00`). |
| A data de término do tempo limitado é inválida | Verifique se o seu `Data de término` tem um valor, é posterior a `Data de início`, e está no formato ISO8601 (ex.: `2026-08-30T00:00:00-07:00`). |
| O rascunho é obrigatório | Enter `sim`/`true` ou `no`/`false` no `Rascunho` coluna para indicar se a campanha deve ser salva como rascunho ou ficar ativa imediatamente. |
| O Tipo de elegibilidade é obrigatório | Insira um dos três valores aceitos na `Tipo de elegibilidade` coluna: `JOINED_PARTNERS`, `PARTNER_GROUPS`, ou `INDIVIDUAL_PARTNERS`. |
| A precedência é obrigatória | Insira um número inteiro de 1 (maior prioridade) a 10 (menor prioridade) na `Precedência` coluna. |
| A data de início não pode estar no passado | Atualizar `Data de início` para uma data no futuro, formatada em ISO8601 (ex.: `2026-08-01T00:00:00-07:00`). |
| O ID do tipo de evento não pertence a este programa | O `ID do tipo de evento` que você inseriu não corresponde a nenhum tipo de evento realmente vinculado ao seu programa. Saiba como [encontrar seu ID do tipo de evento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md). |
| A coluna Regras contém uma expressão de regra inválida. Use o formato \[Variable Operator Value] e encadeie várias regras com AND. |
Use uma condição por linha, no formato VARIÁVEL OPERADOR VALOR por ex., ITEM\_SKU IS HYD-2000.
|
## Adicionar várias regras de grupos de pagamento
Você pode adicionar várias [regras de grupos de pagamento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/set-payout-rules-using-payout-groups.md) a uma única campanha adicionando uma *linha de continuação* ao seu arquivo após a linha da campanha. Na linha de continuação, deixe a *Nome da campanha* em branco. É assim que o envio do seu arquivo apareceria durante a validação:
Repetir o mesmo `ID do tipo de evento` como a linha principal permite que o sistema leia sua linha de continuação como uma regra de pagamento adicional para o mesmo tipo de evento. Para saber quais colunas preencher nas linhas de continuação, consulte a referência abaixo.
Diretrizes da linha da regra de pagamento
Ao adicionar várias regras de grupos de pagamento a uma campanha, aplique estas diretrizes a quaisquer linhas de continuação.
| Nome da Coluna | Tipo | Obrigatório | Descrição |
| -------------------- | ------------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nome da campanha | String | Não | Deixe em branco para marcar esta como uma linha de continuação vinculada à campanha definida imediatamente acima. |
| ID do tipo de evento | Inteiro | Sim | ID do tipo de evento para este grupo de pagamento. |
| Tipo de pagamento | String | Sim | Tipo de pagamento para este tipo de evento adicional (por ex. `PERCENTAGE` ou `FIXED`). |
| Valor do pagamento | Decimal(8,2) | Sim | Valor do pagamento para este tipo de evento adicional. Deve ser maior que zero. |
| Regras | String | Sim | Uma condição de elegibilidade no formato `VARIÁVEL OPERADOR VALOR` — por exemplo, `ITEM_SKU IS HYD-2000`. Veja o [referência de erros de validação](#validation-error-reference) se ela não validar. |
{% hint style="success" %}
**Observação:** Uma única campanha também pode rastrear mais de um tipo de evento. Na linha de continuação, insira um diferente `ID do tipo de evento` da linha principal, em vez de repeti-lo. Para saber quais colunas preencher nas linhas de continuação, consulte a referência acima.
{% endhint %}
### Arquivo de exemplo com uma linha de continuação
{% code overflow="wrap" %}
```
Nome da campanha,ID do fornecedor,ID interno da campanha,Financiamento,Tipo de elegibilidade,IDs de parceiros,IDs de grupos de parceiros,Orçamento,Orçamento imposto,Rascunho,Data de início,Data de término,ID do tipo de evento,Tipo de pagamento,Valor do pagamento,Precedência,Regras
Winter Boot Promo,,EXAMPLE-001,,JOINED_PARTNERS,,,1000.00,no,yes,2026-08-01T00:00:00-07:00,2026-08-31T23:59:59-07:00,17897,FIXED,5.00,10,ITEM_SKU IS BOOT123
,,,,,,,,,,,,17897,FIXED,3.00,,ITEM_SKU IS BOOT456
```
{% endcode %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-product-boost-campaigns.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
