> 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/gerenciamento-de-campanhas-de-product-boost/fazer-upload-em-massa-de-campanhas-de-product-boost.md). # Fazer Upload em Massa de Campanhas de Product Boost Você pode usar a ferramenta de envios em massa para criar várias campanhas do 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, você preencheria durante a configuração. {% stepper %} {% step %} ## Prepare seu arquivo 1. Copie ou baixe este arquivo 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 obrigatório,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 você deseja criar. * Verifique seus valores em relação à [referência do formato do arquivo](#file-format-reference) abaixo para garantir que você insira os dados corretos e nos formatos exigidos. * Para adicionar várias regras de grupo de pagamento a uma única campanha, consulte a [seção de grupos de pagamento](#add-multiple-payout-groups) abaixo. 3. Salve as edições do seu arquivo com um nome apropriado, por exemplo, `Product_Boost_Bulk_Upload`. Certifique-se de que o arquivo seja salvo no formato `.csv` ou `.xlsx` . {% endstep %} {% step %} ## Envie suas campanhas 1. Na barra de navegação à esquerda, selecione ![](/files/160944180402269557074f48f2ece20bc35e8b4d) **\[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 **Envio em massa**. 3. Selecione **Escolher arquivo** ou arraste e solte o arquivo que você preparou para 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 validadas com sucesso, selecione ![](/files/27a40f26b5bd84bf51b027f804aa6f07400faa96) **\[Checkbox] 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 que você enviou aparecerão na sua lista de campanhas. 2. Em seguida, descubra o que cada status de campanha do Product Boost significa e como [gerenciá-los](/brand/pt-br/what-would-you-like-to-learn-about/beta-product-boost/gerenciamento-de-campanhas-de-product-boost/manage-product-boost-campaigns.md). {% endstep %} {% endstepper %} ## Referências
Referência do formato do arquivo Use esta referência como guia ao atualizar os dados de espaço reservado no seu arquivo com os detalhes da sua própria campanha. | Nome da coluna | Tipo | Obrigatório | Descrição | | --------------------------- | ------------ | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Nome da campanha | Texto | Sim | O nome da campanha | | ID do fornecedor | Inteiro | Não | O ID do fornecedor, se aplicável. Ele 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 | Texto | Não | Seu próprio identificador opcional para esta campanha | | Financiamento | Texto | Não | Os detalhes de financiamento da campanha | | Tipo de elegibilidade | Texto | 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 dos 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 obrigatório | Booleano | Não | Deixe em branco se não quiser aplicar a validação. Valores aceitos: `yes`, `true` (encerre a campanha automaticamente quando o orçamento estiver totalmente gasto) ou `no`, `false` (não aplicar). | | Rascunho | Booleano | Sim | Se a campanha deve ser salva como rascunho. Valores aceitos: `yes`, `true` (salvar como rascunho) ou `no`, `false` (ativa imediatamente). | | Data de início | Data | Sim | Data no formato ISO8601. Exemplo: `2013-06-30T00:00:00-07:00` | | Data de término | Data | Sim | Data no formato 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 principal de pagamento desta campanha. | | Tipo de pagamento | Texto | Sim | O tipo de pagamento para este evento (por exemplo, `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 | Texto | Sim | Uma condição de elegibilidade no formato `[VARIABLE] [OPERATOR] [VALUE]` por exemplo, `ITEM_SKU IS HYD-2000`. Saiba mais sobre como [definir regras de grupo 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 erros 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 período limitado é inválida | Verifique se o seu `Data de início` tem um valor, vem antes de `Data de término`, e está no formato ISO8601 (por exemplo, `2026-08-01T00:00:00-07:00`). | | A Data de término do período limitado é inválida | Verifique se o seu `Data de término` tem um valor, vem depois de `Data de início`, e está no formato ISO8601 (por exemplo, `2026-08-30T00:00:00-07:00`). | | Rascunho é obrigatório | Insira `yes`/`true` ou `no`/`false` na `Rascunho` coluna para indicar se a campanha deve ser salva como rascunho ou ficar ativa imediatamente. | | Tipo de elegibilidade é obrigatório | Insira um dos três valores aceitos na `Tipo de elegibilidade` coluna: `JOINED_PARTNERS`, `PARTNER_GROUPS`, ou `INDIVIDUAL_PARTNERS`. | | 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 | Atualize `Data de início` para uma data no futuro, formatada em ISO8601 (por exemplo, `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 o ID do seu 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 \[Variável Operador Valor] e encadeie várias regras com AND. |

Use uma condição por linha, no formato VARIÁVEL OPERADOR VALOR por exemplo, ITEM\_SKU IS HYD-2000.

Não use colchetes nem AND. Verifique também se o Valor existe no seu catálogo de produtos. Veja Adicionar várias regras de grupo de pagamento abaixo para mais informações.

|
## Adicionar várias regras de grupo de pagamento Você pode adicionar várias [regras de grupo 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 o *Nome da campanha* em branco. Veja como o envio do seu arquivo apareceria durante a validação:
Repetir o mesmo `ID do tipo de evento` como na 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 para linhas de regras de pagamento Ao adicionar várias regras de grupo 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 | Texto | Não | Deixe em branco para marcar isto 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 | Texto | Sim | Tipo de pagamento para este tipo de evento adicional (por exemplo, `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 | Texto | Sim | Uma condição de elegibilidade no formato `VARIÁVEL OPERADOR VALOR` — por exemplo, `ITEM_SKU IS HYD-2000`. Consulte a [referência de erros de validação](#validation-error-reference) se não for validado. |
{% hint style="success" %} **Observação:** Uma única campanha também pode acompanhar mais de um tipo de evento. Na linha de continuação, insira um `ID do tipo de evento` diferente 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 obrigatório,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/gerenciamento-de-campanhas-de-product-boost/fazer-upload-em-massa-de-campanhas-de-product-boost.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.