Feeds de Conteúdo

Um feed de conteúdo é um arquivo que contém o catálogo de conteúdo do seu site de mídia (todos os seus artigos, com metadados de artigo). Ele alimenta recomendações de conteúdo, segmentação comportamental com base nas propriedades do artigo e muito mais.

Você só pode ter um feed de conteúdo para cada site de mídia na Dynamic Yield. Use os passos a seguir para criar, carregar e sincronizar um feed de conteúdo na Dynamic Yield. 

Criando um arquivo de feed de conteúdo

Antes de carregar e sincronizar um Feed de Conteúdo com Dynamic Yield, você precisa garantir que seu arquivo de feed esteja em conformidade com os requisitos de tamanho, formato e conteúdo.

Os feeds de conteúdo podem estar nos formatos CSV, JSON ou XML. No entanto, se ele possuir mais de 200.000 itens, deve estar em formato CSV. Elem podem ser armazenados em qualquer URL ou pasta local.

Estrutura do feed de conteúdo

O feed de conteúdo deve incluir as informações básicas sobre seus artigos (ID, título, URL, horário de publicação, tipo de postagem e suas categorias). Você pode ver a lista de atributos obrigatórios na tabela a seguir, com instruções detalhadas (formato,). limitações, e assim por diante):

Colunas personalizadas

Você também pode adicionar até mais 30 colunas que descrevam seus artigos. Essas colunas podem ser usadas posteriormente para segmentação (exemplo, se você adicionar "assunto", você pode usá-la para segmentar usuários que gostam de ler sobre um assunto específico, como basquete), pontuação de afinidade (por exemplo, incluir afinidade do sujeito no algoritmo de recomendação de afinidade) ou definir valores diferentes para localidades diferentes (digamos, mostre um nome traduzido para clientes que visitam o site a partir da França).

Diretrizes:

• Os valores de colunas personalizadas devem ser strings de até 1.000 caracteres, sem caracteres especiais.
• Os nomes das colunas personalizadas não podem começar com '_id'.
• Você não pode ter um nome de coluna personalizado 'sku'. Se você incluir uma coluna com esse nome, o feed será considerado inválido.
• Depois que adiciona uma coluna, você não pode removê-la. Você pode parar de usá-la ou retornar valores em branco, mas a coluna deverá ser incluída em todas as sincronizações futuras. 

Suporte multilíngue

Para detalhes técnicos, consulte Suporte Multilíngue em nossas documentações para desenvolvedores.

Para suportar vários idiomas, você pode especificar valores diferentes para diferentes idiomas e qualquer campo. Use o formato “lng:<código do idioma>:<nome da coluna>”: “<valor>”. Por exemplo, se você quiser ter uma tradução para um nome de produto, você pode criar duas linhas para o produto da seguinte forma:

"lng:en_EN:name":"Calça brança"
"lng:de_DE:name":"weiße Hosen"

O código do idioma deve corresponder ao nome que você usa no contexto da página. Para mais detalhes, consulte Contexto da Página. O código do idioma pode ter até dois símbolos (_) ou (-) entre os valores. Por exemplo: "lng:en_EN_X".

Como essas colunas são opcionais, os valores em branco não acionam erros ou avisos.

Você pode criar um total de até 300 colunas ao trabalhar com vários idiomas (incluindo todas as colunas obrigatórias, personalizadas e traduzidas).

Para saber como segmentar campanhas com base na localidade do usuário (usando o atributo "lng"), consulte o artigo Suporte Multilíngue .

Sincronizando um feed de conteúdo 

1. Se o seu arquivo de feed possuir mais de 20.000 itens, entre em contato com seu Gerente de Sucesso do Cliente para habilitar o upload do seu feed.
2. Acesse Assets › Data Feeds. Observe que você pode criar apenas um feed de conteúdo para cada conta.
3. Se você não tiver feeds de dados, comece aqui e acesse New Feed:
   
   Em seguida, selecione Content Feed:
   
   Se você já tiver outros feeds, na página Data Feeds, clique em Create New e selecione Content Feed no menu suspenso.
4. Especifique um nome de feed e adicione anotações ou rótulos, se desejar.
5. Especifique a fonte do feed carregando seu arquivo ou especificando uma URL que redirecione até um local em que o arquivo está armazenado. Se você estiver usando autenticação HTTP, adicione o nome de usuário e a senha da URL do feed da seguinte forma http://user:password@url.

   Você pode combinar vários arquivos ou fontes em um único feed. Clique em Add Another Source para especificar mais de um arquivo. 

   

   Você pode usar uma função analisadora para controlar como os dois arquivos de feed são combinados, como mostrado no exemplo a seguir:

   function parse(feed1, feed2) {
     var combinedFeeds =  feed1.concat(feed2);
     return combinedFeeds;
   } 

6. Você pode especificar com que frequência o arquivo é sincronizado com a Dynamic Yield expandindo a seção Advanced Settings. Quanto maior o feed, menos frequentemente você tem permissão para sincronizá-lo.    
   
   Você também pode usar uma API para atualizar o feed sob demanda. Essa opção permite que você adicione, exclua ou modifique linhas ou valores inteiros em seu feed de dados e sincronize mais rápido para a Dynamic Yield. No entanto, esse método requer configurações avançadas e suporte técnico. Para obter mais detalhes, contate o seu Gerente de Sucesso do Cliente.

7. Modifique o arquivo do feed usando uma função analisadora

   Se as colunas e valores em seu arquivo de feed não atenderem aos requisitos acima, 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 analisadora criada no JavaScript. Funções analisadoras só funções são compatíveis com feeds de dados de até 200.000 itens.

   As funções analisadoras são necessárias para que os feeds em XML possam ser convertidos em uma matriz dentro de um JSON.
   
   Para adicionar uma função analisadora, acesse Advanced Settings › Parser Function e insira seu código.

   Exemplo - analisar um feed XML 

   As funções analisadoras são necessárias para que os feeds em XML possam ser convertidos em uma matriz dentro de um JSON.

   function parser(data){
    var products = data.items[0].item;
    return products.map(function(item){
    var newFeedRow = {};
    for(var column in item){
    newFeedRow[column] = item[column][0];
    }
    return newFeedRow;
    });
   }

   Exemplo - combinar dois feeds 

   Você pode usar uma função analisadora para combinar dois feeds de conteúdo em um só.

   function parse(feed1, feed2) {
     var combinedFeeds =  feed1.concat(feed2);
     return combinedFeeds;
   }  

8. Você pode ver uma pré-visualização de até 100 entradas do seu feed, incluindo quaisquer erros ou avisos, clicando em Preview. Clique em Save and Activate para prosseguir, ou em Cancel para voltar. 
   
   
9. A duração do processo de sincronização depende de quantos itens estão no seu feed. A sincronização geralmente leva apenas alguns minutos, desde que você tenha menos de 250.000 itens no feed.  À medida que os feeds aumentam, eles normalmente levam cerca de 30 minutos para cada 500.000 itens. Se o tempo de sincronização for um problema, considere entrar em contato com o Gerente de Sucesso do Cliente para aprender a usar uma API para atualizar o feed sob demanda ao invés de sincronizações periódicas. 

Validando o status da sincronização

Você pode verificar se o seu feed está sendo sincronizado com sucesso a qualquer momento.  

1. Acesse Assets › Data Feeds.
2. Na coluna Last Sync Attempt, você deverá ver um ícone de Date Feed Synced  e uma data recente. Se o ícone indicar um erro ou aviso, baixe o registro para obter mais detalhes.
3. Na coluna Actions, Clique no ícone View . Valide se todas as colunas necessárias e todas as colunas personalizadas que você adicionou existem e estão com os dados corretos.