Um feed de produtos é um arquivo que contém seu catálogo de produtos (todos os seus produtos, com metadados do produto). Ele alimenta a personalização baseada em afinidades, recomendações de produtos, mensagens de prova social e muito mais.
A seguir está a estrutura para criar e sincronizar seu feed de produtos com a Dynamic Yield. O planejamento é crítico do ponto de vista comercial porque as colunas do feed determinam quais informações você pode usar para personalizar suas campanhas. Trabalhe com sua equipe de desenvolvimento para criar o arquivo de feed e determinar como e com que frequência ele deve ser sincronizado.
Você pode criar e sincronizar feeds de produtos usando arquivos de dados ou via API.
Sincronize seu feed de produtos usando um arquivo de dados
- Crie o arquivo com todos os metadados necessários do produto (por exemplo, preço ou SKU).
- Sincronize o arquivo com o Experience OS por qualquer um dos métodos listados.
- Analise o arquivo de origem (opcional). Use o código JavaScript para manipular o arquivo de origem para ajustá-lo ao formato exigido pelo Experience OS (como alterar nomes de atributos).
- Veja uma prévia e salve.
- Valide o status de sincronização.
Confira nossas melhores práticas de design de feeds de produtos para aproveitar ao máximo o seu feed de produtos
Passo 1: crie o arquivo
Para os detalhes técnicos, consulte a nossa documentação para desenvolvedores.
Antes de poder carregar e sincronizar um feed de produtos com o Experience OS, certifique-se de que o seu arquivo de feed está em conformidade com os requisitos de tamanho, formato e conteúdo.
| Tamanho do feed | Tipo de arquivo |
| Até 20.000 itens | CSV, JSON, XML |
| De 20.000 a 200.000 | CSV, JSON |
| Mais de 200.000 | CSV |
Observação: se o seu feed inclui mais de 20.000 itens, entre em contato com seu Gerente Técnico de Contas para ajudar com a sincronização (passos 2-4). O tamanho total do feed é limitado a 5 milhões de itens.
O arquivo pode ser armazenado em qualquer URL ou pasta local, ou em um bucket do Amazon S3 que fornecemos. Você também pode transferir os feeds para o Amazon S3 usando o SFTP. Se você usar um arquivo CSV, os itens devem ser separados por vírgulas. Veja o passo 2 para mais informações sobre esses métodos.
Estrutura do feed de produtos
O feed de produtos deve incluir as informações básicas sobre o seu produto (SKU, ID do grupo, preço, imagem, URL, em estoque ou não, e suas categorias).
| Coluna (diferencia maiúsculas de minúsculas) |
Descrição |
| sku | Identificador único do produto. Observação: SKUs não podem conter espaços ou a string "//" |
|
product_type Opcional, mas fortemente recomendado |
O tipo de item: Offer, Product ou Article (respectivamente, oferta, produto ou artigo) Somente instituições financeiras. |
| group_id |
Identifica um grupo de produtos que diferem em alguns atributos. Observação: se você alterar a estrutura do ID do grupo ou da categoria entre sincronizações, o feed pode ser redefinido, fazendo com que todos os dados de recomendações anteriores sejam perdidos |
| name | Nome do produto |
| url | URL para a página de detalhes do produto (deve ser um URL válido, começando com HTTP/HTTPS) |
| preço | Preço do produto (deve ser um número) |
| in_stock | Indicação se o produto está em estoque (indicado por "true/false") |
| image_url | O URL para a imagem do produto (deve ser um URL válido, começando com HTTP/HTTPS) |
| categories | As categorias associadas ao produto, do geral ao específico |
|
keywords Opcional, mas fortemente recomendado |
Quaisquer informações adicionais que descrevam o produto, separadas por pipes. Usadas para os nossos algoritmos de aprendizado de máquina e afinidade. Como essa coluna é opcional, valores em branco não acionarão erros ou avisos. |
Se um produto não tiver um valor em uma coluna obrigatória, ele será ignorado. Se mais de 10% dos produtos tiverem um valor em branco em uma das colunas, toda a sincronização falhará.
Colunas personalizadas
Você também pode adicionar mais colunas que descrevam seu produto. Elas podem mais tarde ser usadas para segmentação (por exemplo, adicionar "cor" e segmentar usuários que compraram itens azuis), pontuações de afinidade (por exemplo, incluir afinidade de cor no algoritmo de recomendação por afinidade) ou para definir regras de merchandising em seus widgets do Recommendations (por exemplo, nunca recomendar produtos de uma marca específica). Veja nossa documentação para desenvolvedores para mais detalhes.
Suporte multilíngue
Para oferecer suporte multilíngue, você pode adicionar uma coluna para cada versão traduzida de uma propriedade que deseja incluir. Saiba mais sobre o suporte multilíngue em sua seção.
Passo 2: sincronize o arquivo com o Experience OS
Acesse Assets › Data Feeds (recursos › feeds de dados) e crie um novo feed de produtos.
Depois de dar um nome ao feed, você poderá selecionar uma das seguintes opções de sincronização:
- Sincronizar um URL ou carregar um arquivo: carregue um arquivo de feed (até 25 MB) ou indique um local de URL onde um arquivo de feed esteja armazenado. Se estiver usando autenticação HTTP, adicione o nome de usuário e a senha ao URL do feed da seguinte forma: http://usuario:senha@url.
- Sincronizar com segurança pelo Amazon S3
- Sincronizar com segurança por SFTP
Veja nossa documentação para desenvolvedores para obter informações detalhadas.
Frequência de sincronização
Por padrão, o feed é sincronizado com o arquivo de origem a cada 24 horas. Você pode alterar isso em Advanced Settings (configurações avançadas) se o seu catálogo de produtos for atualizado com mais frequência. Se você sincronizar o arquivo via S3 ou SFTP, o Experience OS verificará se há um novo arquivo no bucket seis vezes por dia. Se acabou de enviar seu arquivo para o bucket, você pode clicar em Sync Now (sincronizar agora) para forçar a sincronização inicial.
Passo 3: analise o arquivo de origem (opcional)
Se as colunas e valores em seu arquivo de feed não atenderem aos requisitos descrito no passo 1 ou você deseja mesclar arquivos, ou se alguma outra manipulação for necessária para duplicar, mover ou renomear valores e campos, você pode modificar o feed usando uma função parser criada em JavaScript. Por exemplo, arquivos XML que não são "simples" (flat) podem ser "simplificados" usando uma função parser.
Observação: isso está disponível para feeds com menos de 200.000 itens e menores que 180 MB.
Para os detalhes técnicos, consulte a nossa documentação para desenvolvedores.
Passo 4: visualize e salve
Se a sua fonte de feed for um arquivo carregado ou URL, você poderá ver uma prévia de até 100 entradas do seu feed, incluindo quaisquer erros ou avisos clicando em Preview (prévia). Clique em Save and Activate (salvar e ativar) para prosseguir ou Cancel (cancelar) para voltar.
A duração da sincronização depende do número de itens no seu feed. Para feeds com 250.000 itens, geralmente leva alguns minutos, e 30 minutos para cada 500.000 itens adicionais em seu feed. Se você precisar de uma sincronização mais rápida, considere atualizar seu feed por API para atualizar alterações incrementais em vez da atualização de feed completa padrão.
Observação: para feeds com mais de 2 milhões de produtos, os produtos sem eventos associados são filtrados da prévia dos feeds de dados. Produtos ativos são produtos que têm uma ou mais atividades (visualização do produto/adição ao carrinho/compra) nos últimos 6 meses. Então, quando você vê o feed de produtos na prévia, o número de produtos na parte inferior da página é o número atualizado com esse filtro.
Passo 5: valide o status da sincronização
Você pode verificar se o seu feed está sendo sincronizado com sucesso a qualquer momento:
- Acesse Assets › Data Feeds (recursos › feeds de dados).
- Na coluna Last Sync Attempt (última tentativa de sincronização) , você deve ver um ícone de sincronização do feed de dados
e uma data recente. Se o ícone indicar um erro ou aviso, baixe o log para obter mais detalhes.
- Na coluna Actions (ações), clique no ícone de visualização
. Valide se todas as colunas necessárias e todas as colunas personalizadas que você adicionou existem e estão com os dados corretos.
Opcional: baixe os arquivos localmente via Terminal
Veja nossa documentação para desenvolvedores para mais detalhes.
Sincronize seu feed de produtos via API
Se você tiver um feed grande, poderá optar por usar uma API para atualizar apenas as alterações no seu feed (remover ou adicionar um item, alterar as propriedades do item e assim por diante), para atualizações mais rápidas.
Este método requer know-how de desenvolvedor. Os detalhes estão em nosso website para desenvolvedores.
Sincronizar seu catálogo de produtos via API com a Dynamic Yield inclui os seguintes passos:
- Criar o feed de produtos no Experience OS. Consulte a seguinte seção.
- Gerar uma chave de API para incluir em cada chamada de API. Veja os detalhes para desenvolvedores.
- Implementar as chamadas da API para enviar dados para a Dynamic Yield. Veja os detalhes para desenvolvedores.
Crie o feed de produtos
- Acesse Assets › Data Feeds e crie um novo feed de produtos.
- Em Feed Source (fonte do feed), selecione Sync via API (sincronizar via API).
- Adicione quaisquer propriedades opcionais que serão incluídas em cada item do feed de produtos clicando em New Property (nova propriedade). Elas podem ser usadas mais tarde para segmentação (por exemplo, se você adicionar "cor", poderá usá-la para segmentar usuários que compraram itens azuis), pontuação de afinidade (por exemplo, incluir afinidade de cor no algoritmo de recomendação por afinidade), definir regras de merchandising em seus widgets do Recommendations (por exemplo, nunca recomendar produtos de uma marca específica).
- Os valores de propriedades personalizadas devem ser strings de até 1.000 caracteres, sem caracteres especiais.
- Os nomes das propriedades personalizadas não devem começar com "_id".
- Depois de adicionar uma coluna de propriedade, você não poderá removê-la. Você pode parar de usá-la ou retornar valores vazios, mas a propriedade deve estar presente em quaisquer itens futuros.
- Para oferecer suporte multilíngue, você pode adicionar uma propriedade para cada versão traduzida de uma propriedade que deseja incluir. Saiba mais sobre o suporte multilíngue em sua seção.
- Clique em Save and Activate para concluir o processo.