NovoProduct Score, 4T Segmentation, Price War e Broken Size já estão disponíveis.Veja as novidades
Feedance
Logotipo EmarsysEmarsysCanal · Ferramentas de marketing
Integração com Emarsys

Envie para Emarsys os produtos que valem a pena mostrar.

A Feedance cria seu feed para Emarsys e adiciona labels por produto para score, segmento 4T, posição de preço e tamanhos quebrados, para que cada produto carregue seu próprio sinal de desempenho.

Feed de produtos para Emarsys
Gerado pela Feedance
Exportação em XML, CSV ou JSONAtualizado a cada sincronização
<item>
  <id>TS-1042</id>
  <title>Camiseta gola careca</title>
  <price>49.90 USD</price>
  <availability>in stock</availability>
  <custom_label_0>score_86</custom_label_0>
  <custom_label_1>top</custom_label_1>
  <custom_label_2>best_price</custom_label_2>
  <custom_label_3>size_ok</custom_label_3>
</item>
Labels da Feedance, gravados como custom labels
O que a Feedance envia para Emarsys

Um catálogo com um sinal de desempenho em cada produto.

Emarsys lê seus produtos a partir do feed. A Feedance envia um feed completo e válido, além dos sinais que Emarsys não tem por conta própria.

Product Scorecustom_label_0Uma pontuação de 0 a 100 com base em visualizações, adições ao carrinho e compras em 1, 7 e 30 dias.
Segmento 4Tcustom_label_1Top, Tolerable, Tranquil ou Toxic, com base no tráfego e no retorno de cada produto.
Price Warcustom_label_2Mais barato, igual ou mais caro que concorrentes nomeados.
Broken Sizecustom_label_3Sinaliza modelos cuja grade de tamanhos está quase toda esgotada.
Criativosimage_linkImagens com a sua marca, do Creative Suite, com preço e detalhes de campanha vindos do feed.
Como usar: divida campanhas, grupos de produtos ou conjuntos de produtos por esses labels, por exemplo apenas produtos Top, ou tudo exceto Toxic e grades de tamanhos quebradas. Os slots de labels são configuráveis. A Feedance não altera seus lances nem seus orçamentos.

O que é a Emarsys?

A Emarsys, hoje comercializada como SAP Emarsys Customer Engagement dentro do SAP Engagement Cloud, é uma plataforma de automação de marketing omnichannel usada para rodar campanhas personalizadas de e-mail, SMS, push mobile e web. Ao contrário de um canal puramente de publicidade, a Emarsys importa um catálogo de produtos para alimentar principalmente dois mecanismos internos: o Web Extend, que rastreia o comportamento de navegação e de compra no site, e o Predict, seu mecanismo de recomendação baseado em machine learning. Ambos dependem de uma cópia sincronizada e atualizada dos dados dos seus produtos, e não de um único feed de anúncios.

Como a Emarsys faz parte do stack de retenção e marketing de ciclo de vida, e não do stack de aquisição/anúncios, seus requisitos de feed se parecem mais com os de uma fonte de dados de CRM do que com os de um feed de anúncios de Shopping: ela precisa de identificadores de produto estáveis, estrutura de categorias, preços e disponibilidade para acionar coisas como alertas de volta ao estoque, e-mails de queda de preço e recomendações de produtos entre canais.

Por que conectar seu feed de produtos à Emarsys?

A Emarsys usa os dados do seu catálogo para alimentar vários gatilhos e módulos documentados, orientados por dados de produtos, incluindo:

  1. Recomendações personalizadas em e-mail, web e mobile, geradas pelo mecanismo Predict a partir do comportamento de navegação e de compra associado ao seu catálogo.
  2. Alertas de volta ao estoque, acionados quando o campo available de um item que estava indisponível volta a ser verdadeiro.
  3. Avisos de estoque baixo e campanhas de queda de preço, ambos orientados pela comparação entre os novos valores do catálogo (price, msrp, disponibilidade) e os valores armazenados anteriormente.
  4. Consistência entre canais, já que o mesmo catálogo alimenta os blocos de produtos dos e-mails, as recomendações no site e os cards de produtos em push/in-app mobile a partir de uma única fonte.

Um feed incompleto, desatualizado ou com formatação inconsistente quebra esses gatilhos silenciosamente — as recomendações pioram, os alertas de estoque param de disparar e os e-mails de queda de preço saem com valores errados.

Qual formato de feed a Emarsys exige?

A Emarsys aceita dados de catálogo de produtos em um de dois formatos documentados, selecionado na tela de configurações de dados de produtos:

  1. Formato CSV da Emarsys — um arquivo .csv proprietário, codificado em UTF-8, que usa os nomes de campo da própria Emarsys.
  2. Formato Google Product Feed (GPF) — se você já gera um feed no estilo do Google Shopping, a Emarsys muitas vezes consegue reaproveitá-lo como está, desde que ele contenha todos os campos que a própria Emarsys exige. O suporte a GPF precisa ser ativado para a sua conta pelo suporte da Emarsys antes que você possa selecioná-lo.

Especificamente para o formato CSV, a Emarsys documenta regras de sintaxe rígidas: os campos são delimitados por vírgula, campos com vários valores (como categoria ou marca) usam o separador pipe |, os caminhos de categoria usam o separador hierárquico > (por exemplo, Men > Shoes > Running), números decimais devem sempre usar ponto como separador, independentemente da sua localidade, datas devem estar no formato YYYY-MM-DD e timestamps devem estar no formato YYYY-MM-DD T HH:MM:SS Z, em UTC. A primeira linha do arquivo deve ser a linha de cabeçalho, e a Emarsys exige um caractere de nova linha nos primeiros 265 KB do arquivo especificamente para detectar e rejeitar envios acidentais de arquivos binários. Os arquivos podem, opcionalmente, ser enviados compactados em .gz para economizar banda em catálogos grandes. O envio é documentado via FTP ou FTPS; o suporte a SFTP é documentado de forma inconsistente nas próprias páginas de ajuda da Emarsys — uma página o lista como suportado para envios de catálogo de produtos, e outra afirma explicitamente que o SFTP não é suportado para entrega de feeds/coleta de dados, então confirme diretamente com o suporte da Emarsys antes de depender dele.

Quais atributos de produto a Emarsys exige?

A Emarsys documenta um conjunto de campos padrão para o catálogo de produtos. item é o único campo explicitamente indicado como obrigatório e não localizável, já que é o identificador associado aos dados comportamentais e de vendas; os demais campos abaixo são os campos padrão dos quais dependem a documentação da Emarsys e os recursos de atualização do catálogo de produtos (volta ao estoque, estoque baixo, queda de preço). A maioria desses campos pode ser localizada com o sufixo [field]_[language] (por exemplo, title_it para um título em italiano); item não pode ser localizado. Qualquer atributo personalizado que você adicionar deve ter o prefixo c_ (por exemplo, c_color ou c_size).

CampoObrigatórioFormatoExemploObservações
itemSimTexto únicoSKU-12345Identificador do produto; associado aos dados do Web Extend e de vendas; não pode ser localizado.
titleCampo padrãoTextoTênis de corrida masculinoLocalizável via title_[lang].
linkCampo padrãoURL absolutahttps://shop.example.com/p/12345URL da página de detalhes do produto.
imageCampo padrãoURL absolutahttps://cdn.example.com/img/12345.jpgLinks WebP são suportados em geral, mas o widget de e-mail do Predict não suporta o formato WebP.
zoom_imageCampo padrãoURL absolutahttps://cdn.example.com/img/12345_zoom.jpgImagem secundária, em resolução maior.
categoryCampo padrãoCaminho hierárquico, separado por >Men > Shoes > RunningVários caminhos de categoria são separados por pipe; usado para construir modelos estatísticos/de afinidade, então mantenha-o canônico.
priceCampo padrãoDecimal, separador ponto89.99O separador decimal deve ser ponto, independentemente da localidade.
msrpCampo padrãoDecimal, separador ponto109.99Usado como preço de comparação nas campanhas de queda de preço.
availableCampo padrãoValor do tipo booleanotrueItens marcados como indisponíveis são excluídos das recomendações e da busca, e acionam alertas de volta ao estoque quando mudam para true.
brandCampo padrãoTexto (aceita vários valores)NikeVários valores de marca são separados por pipe.
descriptionCampo padrãoTextoTênis de corrida leve com cabedal em mesh respirável.Localizável via description_[lang].
item_group_idObrigatório para Parent/Child no GPFTexto compartilhado entre variantesSHOE-STYLE-100Agrupa variantes de tamanho/cor sob um produto pai para o recurso de catálogo Parent/Child; não pode coincidir com nenhum valor de item, ou a Emarsys gera um erro de conflito de namespace.

A documentação da Emarsys não publica limites rígidos de caracteres para campos como title ou description, como fazem algumas plataformas de anúncios, por isso nenhum limite específico é informado aqui.

Como conectar a Emarsys à Feedance

  1. Na Feedance, crie ou selecione o feed de produtos que você quer enviar para a Emarsys e escolha Emarsys como destino. Escolha se a saída será no formato CSV proprietário da Emarsys ou em um formato no estilo Google Product Feed — lembre-se de que o GPF precisa ser ativado antes na sua conta da Emarsys pelo suporte da Emarsys.
  2. Mapeie os dados de produtos de origem para os campos padrão da Emarsys (item, title, link, image, category, price, msrp, available, brand, description) e adicione o prefixo c_ a qualquer atributo extra que você queira levar, para que a Emarsys o aceite como campo personalizado.
  3. Se você vende produtos com variantes (tamanho, cor etc.), mapeie um valor de item_group_id compartilhado entre as linhas dessas variantes para que o recurso de catálogo Parent/Child da Emarsys possa agrupá-las — mantenha os valores de item e de item_group_id separados, já que uma duplicata entre os dois gera um erro de leitura por conflito de namespace.
  4. Defina a entrega via FTP ou FTPS (o protocolo que a Emarsys documenta de forma mais consistente para a entrega do catálogo) e, opcionalmente, ative a compactação .gz se o seu catálogo for grande.
  5. Confirme que o delimitador de campos, o separador decimal e a formatação de datas/timestamps do feed seguem as regras de CSV da Emarsys (delimitado por vírgula, decimal com ponto, datas YYYY-MM-DD) antes da primeira sincronização, já que a Emarsys espera que o formato combinado se mantenha igual em todos os envios seguintes.

Com que frequência seu feed da Emarsys deve ser atualizado?

A Emarsys documenta que os envios de catálogo feitos por arquivo (FTP/FTPS) são processados em lote — lidos a cada hora, ou com menos frequência, se a conta estiver configurada assim —, enquanto os dados enviados pela API da Emarsys podem ser gravados quase em tempo real, normalmente em segundos. Cada envio deve conter o estado completo e atual de cada item; a Emarsys não suporta atualizações parciais/delta, então os campos que não mudaram ainda precisam ser reenviados a cada ciclo.

A orientação da própria Emarsys é enviar os dados dos produtos pelo menos uma vez por dia, e com mais frequência se campos que podem mudar ao longo do dia — principalmente preço ou disponibilidade — forem importantes para as suas campanhas, já que dados de preço ou estoque desatualizados quebram diretamente os gatilhos de queda de preço e de volta ao estoque.

Erros comuns no feed da Emarsys e como corrigi-los

Erro / sintomaCausa provávelSolução
Parse error: Namespace clash, same id is used for both variants and groups.Um valor de item e um valor de item_group_id são idênticos — a Emarsys trata os IDs de itens e de grupos como um único conjunto compartilhado.Garanta que cada valor de item e de item_group_id seja único considerando os dois campos, e não apenas dentro da própria coluna.
"More than 1,000 errors were found" (mais de 1.000 erros encontrados) / verificação encerradaO arquivo CSV está muito malformado — por exemplo, aspas quebradas, colunas inconsistentes ou um problema de codificação em muitas linhas.Corrija os problemas estruturais na origem (codificação, delimitador, cabeçalho/número de colunas), em vez de linha por linha; a Emarsys para de validar após 1.000 erros porque considera o arquivo corrompido demais para continuar a verificação.
Erros de codificação ao ler as linhasO arquivo contém caracteres que não são UTF-8 válido.Exporte o arquivo novamente em UTF-8 e confirme que nenhuma codificação antiga (por exemplo, Latin-1/Windows-1252) passou do sistema de origem.
Envio marcado como "missing" (ausente) no Update HistoryUm envio programado não chegou — a Emarsys observa que isso geralmente é causado por um problema temporário de rede do lado de quem envia.Confirme se a tarefa programada realmente foi executada e concluída do lado da entrega (FTP/FTPS/API) e, em seguida, acione a sincronização novamente.
Produto ausente das recomendações/buscaavailable está definido como false (ou ausente/ilegível) para esse item.Verifique se o valor de available está presente e formatado corretamente para todos os itens em estoque.

Dicas de otimização do feed da Emarsys

  1. Mantenha os valores de category canônicos e consistentes em todo o catálogo — a Emarsys observa explicitamente que campos como categoria, marca e autor são usados para construir modelos estatísticos/de afinidade, então rótulos inconsistentes (por exemplo, misturar "Running Shoes" e "running-shoes") prejudicam a qualidade das recomendações.
  2. Nunca envie atualizações delta/parciais — sempre reenvie o estado completo e atual de todos os itens, já que a Emarsys não suporta atualizações parciais do catálogo.
  3. Mantenha os valores de item e de item_group_id em espaços de ID estritamente separados para evitar erros de conflito de namespace ao usar o recurso de variantes Parent/Child.
  4. Envie as mudanças de preço e disponibilidade com mais frequência (a cada hora, ou pela API, quase em tempo real) do que o restante do catálogo, já que esses dois campos acionam diretamente os gatilhos de queda de preço e de volta ao estoque.
  5. Evite o formato de imagem WebP especificamente para produtos que aparecem no widget de recomendação por e-mail do Predict, já que esse widget não exibe WebP — use links JPEG/PNG para essas imagens, mesmo que o WebP seja usado em outras partes da loja.

Perguntas frequentes

O feed da Emarsys é o mesmo que o feed do meu catálogo do Google Merchant Center ou da Meta?
Não exatamente — a Emarsys importa seu próprio catálogo de produtos para alimentar as recomendações do Predict e o rastreamento comportamental do Web Extend, e não anúncios pagos. Dito isso, a Emarsys muitas vezes consegue reaproveitar diretamente um arquivo existente no formato Google Product Feed, desde que ele contenha todos os campos exigidos pela Emarsys.

A Emarsys exige CSV ou posso enviar GPF?
Os dois são suportados. O CSV é o formato nativo da Emarsys; o GPF precisa ser ativado explicitamente para a sua conta pelo suporte da Emarsys antes que você possa selecioná-lo.

Qual é o único campo realmente obrigatório?
item — o identificador de produto único e não localizável ao qual os dados comportamentais e de vendas são associados. Os outros campos padrão (title, link, image, category, price, msrp, available, brand, description) não são documentados com uma indicação explícita de "obrigatório", mas as recomendações e os gatilhos de atualização do catálogo dependem de eles estarem presentes e corretos.

Como represento variantes de produtos, como tamanho ou cor?
Use o recurso de catálogo Parent/Child da Emarsys, preenchendo um item_group_id compartilhado entre as linhas das variantes. Mantenha o namespace desse valor separado dos seus valores de item para evitar um erro de leitura por conflito de namespace.

Com que frequência a Emarsys espera que o feed seja atualizado?
Pelo menos uma vez por dia, segundo a própria orientação da Emarsys, e com mais frequência — de preferência a cada hora ou pela API quase em tempo real — se os preços ou os níveis de estoque mudam ao longo do dia.

A Emarsys suporta entrega via SFTP?
Isso é documentado de forma inconsistente nas próprias páginas de ajuda da Emarsys: uma página lista o SFTP como suportado para envios do catálogo de produtos, enquanto outra afirma que o SFTP não é suportado para entrega de feeds/coleta de dados e que FTP/FTPS devem ser usados no lugar. Confirme diretamente com o suporte da Emarsys para a sua conta antes de depender do SFTP.

Posso adicionar meus próprios atributos personalizados ao feed?
Sim — qualquer nome de campo personalizado deve ter o prefixo c_ (por exemplo, c_color ou c_size) para que a Emarsys o aceite junto com os campos padrão.

Sobre Emarsys

A Emarsys é uma plataforma global de automação de marketing que oferece às empresas soluções de engajamento personalizado com os clientes. Ela foi fundada em 2000 por Josef Ahorner e Peter Olsen em Viena, na Áustria. A Emarsys oferece uma série de ferramentas e serviços de marketing para ajudar as empresas a engajar e reter seus clientes de forma mais eficaz.

A plataforma foi lançada em 2000 com o objetivo de revolucionar o engajamento com os clientes por meio da personalização e da automação orientadas por dados. Inicialmente, a Emarsys se concentrava em e-mail marketing, mas, ao longo dos anos, ampliou seus recursos para incluir outros canais, como mobile, redes sociais, web e outros.

A Emarsys permite que as empresas coletem dados de clientes em vários pontos de contato e usa inteligência artificial para criar campanhas de marketing personalizadas. Os recursos de IA da plataforma ajudam a entender comportamentos, preferências e tendências dos clientes, permitindo que as empresas entreguem conteúdo segmentado e relevante ao seu público.

A empresa cresceu muito ao longo dos anos e se tornou uma provedora global de soluções para mais de 2.500 marcas no mundo todo. A Emarsys atende a uma grande variedade de setores, incluindo varejo, e-commerce, turismo, automotivo e outros.

Com sede ainda em Viena, a Emarsys abriu escritórios em vários países, incluindo Estados Unidos, Reino Unido, Alemanha, Hungria, Austrália e Emirados Árabes Unidos. A plataforma suporta vários idiomas, o que a torna acessível a empresas do mundo todo.

A Emarsys oferece uma ampla variedade de recursos para ajudar as empresas a otimizar suas estratégias de marketing. Entre eles estão automação de e-mail marketing, segmentação de clientes, análise preditiva, rastreamento do comportamento dos clientes, marketing omnichannel, gestão do ciclo de vida do cliente e muito mais.

Em resumo, a Emarsys se posicionou como uma plataforma líder de automação de marketing que permite às empresas criar campanhas de marketing personalizadas e orientadas por dados. Com sua presença global e seu conjunto completo de soluções, a Emarsys permite que as empresas aumentem o engajamento dos clientes e impulsionem o crescimento da receita.

Descubra quais dos seus produtos dão retorno.

Conecte seu feed de produtos e o GA4. Mostraremos Product Score, 4T, Price War e Broken Size no seu próprio catálogo.