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.
EmarsysCanal · Ferramentas de marketingA 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.
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.
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.
A Emarsys usa os dados do seu catálogo para alimentar vários gatilhos e módulos documentados, orientados por dados de produtos, incluindo:
available de um item que estava indisponível volta a ser verdadeiro.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.
A Emarsys descreve o Predict como um mecanismo de recomendação autodidata que combina duas fontes de dados: o rastreamento comportamental coletado pela API JavaScript do Web Extend (web) e pelo SDK da Emarsys (mobile), e o catálogo estruturado de produtos que você envia. A navegação anônima cria modelos gerais de afinidade em todo o seu catálogo; o comportamento vinculado a um contato identificado (alguém que fez login ou clicou a partir de uma campanha da Emarsys) cria um perfil pessoal para aquele comprador.
Isso é importante para a qualidade do feed porque o Predict só consegue recomendar o que está representado corretamente no catálogo: os produtos precisam de um identificador item estável e único com o qual os eventos comportamentais possam ser associados, de caminhos de category precisos para que os modelos de afinidade sejam construídos de forma canônica e de um indicador available atualizado para que itens esgotados deixem de ser recomendados.
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:
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.
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).
| Campo | Obrigatório | Formato | Exemplo | Observações |
|---|---|---|---|---|
item | Sim | Texto único | SKU-12345 | Identificador do produto; associado aos dados do Web Extend e de vendas; não pode ser localizado. |
title | Campo padrão | Texto | Tênis de corrida masculino | Localizável via title_[lang]. |
link | Campo padrão | URL absoluta | https://shop.example.com/p/12345 | URL da página de detalhes do produto. |
image | Campo padrão | URL absoluta | https://cdn.example.com/img/12345.jpg | Links WebP são suportados em geral, mas o widget de e-mail do Predict não suporta o formato WebP. |
zoom_image | Campo padrão | URL absoluta | https://cdn.example.com/img/12345_zoom.jpg | Imagem secundária, em resolução maior. |
category | Campo padrão | Caminho hierárquico, separado por > | Men > Shoes > Running | Vários caminhos de categoria são separados por pipe; usado para construir modelos estatísticos/de afinidade, então mantenha-o canônico. |
price | Campo padrão | Decimal, separador ponto | 89.99 | O separador decimal deve ser ponto, independentemente da localidade. |
msrp | Campo padrão | Decimal, separador ponto | 109.99 | Usado como preço de comparação nas campanhas de queda de preço. |
available | Campo padrão | Valor do tipo booleano | true | Itens 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. |
brand | Campo padrão | Texto (aceita vários valores) | Nike | Vários valores de marca são separados por pipe. |
description | Campo padrão | Texto | Tênis de corrida leve com cabedal em mesh respirável. | Localizável via description_[lang]. |
item_group_id | Obrigatório para Parent/Child no GPF | Texto compartilhado entre variantes | SHOE-STYLE-100 | Agrupa 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.
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.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.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.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.
| Erro / sintoma | Causa provável | Soluçã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 encerrada | O 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 linhas | O 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 History | Um 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/busca | available 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. |
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.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.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.
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.
Conecte seu feed de produtos e o GA4. Mostraremos Product Score, 4T, Price War e Broken Size no seu próprio catálogo.