Upload em massa de campanhas de Product Boost

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.

1

Prepare seu arquivo

1. Copie ou baixe este arquivo de modelo para o seu dispositivo:

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

1. 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 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 abaixo.
2. 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.

2

Envie suas campanhas

1. Na barra de navegação à esquerda, selecione [Engage] → Gerenciador de Campanhas → Product Boost.
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.

3

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 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.

4

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.

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 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.

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.
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. 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 grupos de pagamento abaixo para mais informações.

Adicionar várias regras de grupos de pagamento

Você pode adicionar várias regras de grupos de pagamento 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 se ela não validar.

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.

Arquivo de exemplo com uma linha de continuação

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