Feeds
Use os feeds para importar entidades no Adobe Target Recommendations. As entidades podem ser enviadas usando arquivos CSV, o formato de feed do Google Product Search e Adobe Analytics classificações do produto.
Visão geral dos feeds concept_D1E9C7347C5D4583AA69B02E79607890
Os feeds permitem que você passe Entidades ou aumente seus dados da mbox com informações que ou não estão disponíveis na página, ou não são seguras para serem enviadas diretamente da página, como margem, COGS e outros.
Os feeds permitem passar informações detalhadas do item para o Recommendations, como ID do produto, categoria, nome, mensagem e outros atributos.
Você pode escolher quais colunas do seu arquivo de classificações do produto Target ou do arquivo do Google Product Search você deseja enviar para o servidor Recommendations.
Esses dados sobre cada item podem ser usados para:
- Exibir valores em designs
- Definir regras de inclusão de critérios
- Classificar itens em diferentes coleções
- Aplicar exclusões às recomendações
As descrições de item podem ser passadas para Target usando feeds ou mboxes. Se dados forem coletados tanto por feeds de entidade como por uma mbox, os dados mais recentes vencem. Normalmente, os dados mais recentes vêm de uma mbox, porque ela é vista com mais frequência. Se, por coincidência, dados do feed de entidade e da mbox cheguem ao mesmo tempo, os dados da mbox serão usados.
A variável Feeds lista ( Recommendations > Feeds) fornece informações sobre quaisquer feeds criados.
A variável Feeds contém as seguintes colunas:
- Nome: o nome do feed especificado durante a criação. Para editar o nome de um feed, edite o próprio feed. Quando você salva o feed com o novo nome, ele é atualizado.
- Tipo: os tipos incluem CSV, Feed do produto Google e Classificações do Analytics.
- Status: o status atual do feed.
- Agendar: exibe o agendamento de atualização do feed: Diariamente, Semanalmente, Every 2 Weeksou Nunca.
- Itens: exibe o número de itens no feed.
- Última atualização: exibe a data e a hora em que o feed foi atualizado pela última vez e o nome da pessoa que atualizou o feed. Se a Última atualização do feed indicar “indefinido”, o feed será recebido da Recommendations Classic e não poderá ser alterado em Target Premium Recommendations.
Clique no ícone de Informações para exibir um cartão que exibe a data do último upload e o URL do feed.
Clique no ícone de reticências para acessar as seguintes ações: Desativar, Edit, Copiar, e Excluir.
- O feed deve ser executado pelo menos uma vez por mês para garantir que o conteúdo do catálogo não expire.
- Remover um item do seu arquivo de feed não remove esse item do catálogo. Para remover o item do catálogo, exclua manualmente o item por meio da Target Interface do usuário ou API. Ou modifique os atributos do item (como inventário) para garantir que o item seja excluído da consideração.
Tipos de origem
As entidades podem ser enviadas usando arquivos CSV, o formato de feed do Google Product Search e Adobe Analytics classificações do produto.
CSV section_65CC1148C7DD448FB213FDF499D35FCA
É possível criar um arquivo .csv usando o Adobe formato de upload CSV proprietário. O arquivo contém as informações de exibição sobre os atributos reservados e personalizados para os seus produtos. Para fazer o upload dos atributos específicos à sua implementação, substitua CustomN
na linha de cabeçalho pelo nome do atributo que deseja usar. No exemplo abaixo, entity.Custom1
foi substituído por: entity.availability
. Em seguida, você pode fazer o upload em massa do arquivo para o servidor Recommendations.
Usar o formato .csv tem as seguintes vantagens em relação ao formato do Google Feed:
- O formato .csv não requer mapeamentos de campo.
- O formato .csv suporta atributos de vários valores (veja o exemplo abaixo).
- O formato .csv suporta até 100 atributos personalizados. Se você precisar de mais de 100 atributos personalizados, pode criar um segundo arquivo de feed com um conjunto diferentes de atributos personalizados.
Use o método de upload em massa para enviar informações de exibição se não houver mboxes na página ou se desejar complementar as informações de exibição com itens que não estejam disponíveis no site. Por exemplo, talvez você queira enviar informações sobre o inventário que podem não estar publicadas no seu site.
Quaisquer dados carregados por meio do arquivo .csv, feed de produto do Google ou Analytics O feed de classificação de produto substitui o valor do atributo da entidade existente no banco de dados. Se você enviar informações de preço via solicitações de mbox e depois enviar valores de preço diferentes no arquivo, os valores no arquivo substituem os valores enviados na solicitação de mbox. Uma exceção a essa regra é o atributo de entidade categoryId
no qual os valores de categoria são anexados em vez de substituídos até o limite de 250 caracteres.
Por exemplo, a sintaxe a seguir está incorreta:
"Apples "Bananas" Grapes"",
A sintaxe a seguir está correta:
"Apples ""Bananas"" Grapes""",
O produto estará disponível na interface de Admin aproximadamente duas horas depois de ter carregado a entidade com sucesso.
A seguir, encontra-se um código de exemplo para um arquivo .csv:
## RECSRecommendations Upload File
## RECS''## RECS'' indicates a Recommendations pre-process header. Please do not remove these lines.
## RECS
## RECSUse this file to upload product display information to Recommendations. Each product has its own row. Each line must contain 19 values and if not all are filled a space should be left.
## RECSThe last 100 columns (entity.custom1 - entity.custom100) are custom. The name 'customN' can be replaced with a custom name such as 'onSale' or 'brand'.
## RECSIf the products already exist in Recommendations then changes uploaded here will override the data in Recommendations. Any new attributes entered here will be added to the product''s entry in Recommendations.
## RECSentity.id,entity.name,entity.categoryId,entity.message,entity.thumbnailUrl,entity.value,entity.pageUrl,entity.inventory,entity.margin,entity.last_updated_by,entity.multi_english,entity.availability,entity.tax_country,entity.tax_region,entity.tax_rate,entity.product_type,entity.item_group_id,entity.color,entity.size,entity.brand,entity.gtin
na3456,RipCurl Watch with Titanium Dial,Watches & Sport,Cutting edge titanium with round case,https://example.com/s7/na3456_Viewer,425,https://example.com/shop/en-us/na3456_RipCurl,24,0.25,csv,"[""New"",""Web"",""Sales"",""[1,2,34,5]""]",in stock,US,CA,9.25,Shop by Category > Watches,dz1,Titanium,44mm,RipCurl,"075380 01050 5"
na3457,RipCurl Watch with Black Dial,Watches & Sport,Cutting edge matte black with round case,https://example.com/s7/na3457_Viewer,275,https://example.com/shop/en-us/na3457_RipCurl,24,0.27,csv,"[""New"",""Web"",""Sales"",""[1,2,34,5]""]",in stock,US,CA,9.25,Shop by Category > Watches,dz1,Black,44mm,RipCurl,"075340 01060 7"
Google section_8EFA98B5BC064140B3F74534AA93AFFF
O tipo de feed de pesquisa do produto do Google usa o formato do Google. Isso é diferente do Adobe formato de upload CSV proprietário.
Se você tiver um feed do produto Google existente, poderá usá-lo como arquivo de importação.
A maioria dos varejistas faz upload de produtos para o Google; portanto, quando um visitante usa a pesquisa de produto do Google, seus produtos são exibidos. O Recommendations segue as especificações do Google de forma precisa para feeds de entidade. Os feeds de entidade podem ser enviados para Recommendations via .xml, .txt ou .tsv e podem usar o atributos definidos pelo Google. Os resultados podem ser pesquisáveis nas páginas de compra do Google.
Como os usuários do Recommendations já configuram os feeds .xml e .txt para enviar ao Google, tanto via URL quanto via FTP, os feeds de entidade aceitam esses dados do produto e os usam para criar o catálogo de recomendações. Especifique onde esse feed existe, e o servidor de recomendações recuperará os dados.
Se você usar a Pesquisa de produto do Google para o upload do feed de entidade, ainda deverá ter uma mbox de página de produto na página se desejar mostrar recomendações lá ou rastrear as exibições de produto para entrega de algoritmo com base nas exibições.
Os feeds do Google não suportam vários valores para um atributo personalizado.
O feed é executado no momento em que você o salva e ativa. Ela é executada no momento em que você salva o feed e, em seguida, todos os dias uma hora depois.
A seguir, está um código de exemplo para um arquivo .xml do Google Product Search:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<feed xmlns="https://www.w3.org/2005/Atom" xmlns:ns2="https://base.google.com/ns/1.0" xmlns:ns3="https://base.google.com/cns/1.0">
<title>Product Feed</title>
<link href="https://example.com"/>
<updated>2017-12-13T08:45:04.918-08:00</updated>
<author>
<name>Product Feed Author</name>
</author>
<id>https://example.com</id>
<entry>
<title>RipCurl Watch with Titanium Dial</title>
<description>Cutting edge Titanium with Round case</description>
<ns2:id>na3452</ns2:id>
<ns2:link>https://example.com/shop/en-us/na3452_RipCurl</ns2:link>
<ns2:availability>in stock</ns2:availability>
<ns2:condition>NEW</ns2:condition>
<ns2:google_product_category>Watches & Sport</ns2:google_product_category>
<ns2:gtin>075380 01050 5</ns2:gtin>
<ns2:image_link>https://example.com/s7/na3452_Viewer</ns2:image_link>
<ns2:mobile_link>https://m.example.com/s7/na3452_Viewer</ns2:mobile_link>
<ns2:mpn>71050</ns2:mpn>
<ns2:price>425</ns2:price>
<ns2:product_review_average>5.0</ns2:product_review_average>
<ns2:product_review_count>30</ns2:product_review_count>
<ns2:product_type>Shop by Category > Watches </ns2:product_type>
<ns2:brand>RipCurl</ns2:brand>
<ns2:sale_price>375</ns2:sale_price>
<ns2:tax>
<ns2:country>US</ns2:country>
<ns2:region>CA</ns2:region>
<ns2:rate>9.25</ns2:rate>
<ns2:tax_ship>y</ns2:tax_ship>
</ns2:tax>
<ns2:is_bundle>N</ns2:is_bundle>
</entry>
<entry>
<title>RipCurl Watch with Black Dial</title>
<description>Cutting edge matte black with Round case</description>
<ns2:id>na3453</ns2:id>
<ns2:link>https://example.com/shop/en-us/na3453_RipCurl</ns2:link>
<ns2:availability>in stock</ns2:availability>
<ns2:condition>NEW</ns2:condition>
<ns2:google_product_category>Watches & Sport</ns2:google_product_category>
<ns2:gtin>075380 013450 5</ns2:gtin>
<ns2:image_link>https://example.com/s7/na3453_Viewer</ns2:image_link>
<ns2:mobile_link>https://m.example.com/s7/na3453_Viewer</ns2:mobile_link>
<ns2:mpn>71050</ns2:mpn>
<ns2:price>275</ns2:price>
<ns2:product_review_average>4.8</ns2:product_review_average>
<ns2:product_review_count>23</ns2:product_review_count>
<ns2:product_type>Shop by Category > Watches </ns2:product_type>
<ns2:brand>RipCurl</ns2:brand>
<ns2:sale_price>249</ns2:sale_price>
<ns2:tax>
<ns2:country>US</ns2:country>
<ns2:region>CA</ns2:region>
<ns2:rate>9.25</ns2:rate>
<ns2:tax_ship>y</ns2:tax_ship>
</ns2:tax>
<ns2:is_bundle>N</ns2:is_bundle>
</entry>
</feed>
A seguir, está um código de exemplo para um arquivo .tsv do Google Product Search:
id title description link price condition availability image_link tax shipping_weight shipping google_product_category product_type item_group_id color size gender age_group pattern brand gtin mpn
na3454 RipCurl Watch with Titanium Dial Cutting edge titanium with round case https://example.com/shop/en-us/na3454_RipCurl 425 new in stock https://example.com/s7/na3452_Viewer US:CA:9.25:y 1.5 oz US:::0.00 USD Watches & Sport Shop by Category > Watches dz1 Black 44mm male adult Solid RipCurl 075380 01050 5 DZ1437
na3455 RipCurl Watch with Black Dial Cutting edge matte black with round case https://example.com/shop/en-us/na3455_RipCurl 275 new in stock https://example.com/s7/na3452_Viewer US:CA:9.25:y 1.5 oz US:::0.00 USD Watches & Sport Shop by Category > Watches dz1 Black 44mm male adult Solid RipCurl 075340 01060 7 DZ1446
Analytics Classificações do produto section_79E430D2C75443BEBC9AA0916A337E0A
A variável Analytics A classificação do produto é a única classificação disponível para recomendações. Para obter mais informações sobre esse arquivo de classificação, consulte Sobre as classificações no Componentes do Analytics guia. É possível que nem todas as informações que você precisa para as recomendações estejam disponíveis em sua implementação atual do, portanto, siga este guia do usuário se desejar adicioná-las ao arquivo de classificações.
- As atualizações para os atributos da entidade têm um atraso adicional de até 24 horas.
- Target suporta Classificações do produto somente. A variável Analytics O SKU do produto deve mapear no mesmo nível que a variável Recommendations
entity.id
. Personalizado Analytics As classificações podem ser projetadas usando Serviços de consultoria Adobe. Entre em contato com o Gerente de contas se tiver dúvidas.
Criar feed steps
Crie um feed para inserir informações sobre os produtos ou serviços no Recommendations.
-
Na interface do Target, clique em Recomendações > Feeds > Criar feed.
-
Especifique um nome descritivo para o feed.
-
Selecione um Tipo de Fonte.
- CSV
- Feed do produto Google
- Classificações do Analytics
Para obter informações sobre o CSV e Feed do produto Google tipos de feed, consulte Visão geral dos feeds. Também é possível baixar um guia CSV de modelo para ajudar a formatar o feed corretamente.
-
(Condicional) Se você selecionou CSV ou Feed do produto Google, especifique o local em que o feed pode ser acessado.
-
FTP: se você selecionar FTP, forneça as informações do servidor FTP, as credenciais de logon, o nome do arquivo e o diretório do FTP. Você pode usar o FTP com SSL (FTPS) para uploads mais seguros.
Configurações compatíveis do servidor FTP:
- FTP e FTPS devem ser definidos para usar FTP passivo.
- Para FTPS, configure o servidor para aceitar as conexões FTPS explícitas.
- SFTP não é compatível.
- Você pode especificar manualmente uma porta em que a conexão será iniciada (por exemplo,
ftp://ftp.yoursite.com:2121
). Se você não especificar uma porta, a porta FTP ou FTPS padrão será usada.
-
URL: Se você selecionar URL, especifique o URL.
-
-
(Condicional) Se você selecionou Classificações do Analytics, escolha o conjunto de relatórios na lista suspensa.
-
Clique na seta Avançar para exibir as opções de Agendar.
-
Selecione uma opção de atualização:
- Diariamente
- Semanalmente
- A cada 2 semanas
- Nunca: não programe uma atualização. Escolha essa opção se você não quiser que esse feed seja executado.
-
Especifique o tempo em que deseja que o feed seja executado.
Essa opção é baseada no fuso horário usado no seu navegador. Se desejar usar uma hora em um fuso horário diferente, deve calcular esse tempo de acordo com o seu fuso horário.
-
Clique na seta Avançar para exibir as opções de Mapeamento, em seguida, especifique como deseja mapear seus dados para as definições do Target.
-
(Opcional) se você deseja que o feed pertença a um ambiente (grupo de hosts), selecione o grupo de hosts.
Por padrão, o feed pertence a todos os grupos de hosts. Isso garante que esses itens neste feed estejam disponíveis em qualquer ambiente. Para obter mais informações, consulte Hosts.
-
Clique em Salvar.
Depois de criar ou editar um feed, ele é executado imediatamente. O feed é atualizado de acordo com os parâmetros definidos. Leva algum tempo para as informações estarem disponíveis. Em primeiro lugar, o feed deve sincronizar, em seguida, ele deve ser processado e indexados antes que possa ser publicado e disponibilizado. O status atual aparece em Status do feed na lista de Feeds. Você pode fechar o Target antes que o processo esteja completo e o mesmo continuará.
Enquanto a indexação estiver em andamento, os produtos e cabeçalhos de feed serão exibidos antes que os valores individuais sejam indexados. Isso permite pesquisar e visualizar produtos para que você possa criar coleções, exclusões, designs e atividades antes da conclusão da indexação.
Quando o Status apresentar a mensagem de "Sucesso", isso significa que o arquivo foi encontrado e analisado corretamente. A informação não está disponível para o uso no Recommendations até que o arquivo seja indexado, o que pode levar algum tempo, dependendo do tamanho do seu arquivo. Se o processo falhar, significa que o arquivo não foi encontrado. Por exemplo, você usou um URL incorreto, suas informações de FTP estavam incorretas ou havia um erro de análise.
Status do feed e indicadores concept_E475986720D1400999868B3DFD14A7A0
Informações sobre os status possíveis do feed e seus indicadores.
Status do feed status
A seguir, estão os possíveis status de um feed:
TargetO importou o arquivo de feed para o sistema de entrega de conteúdo. Os atributos do item foram alterados no sistema de entrega de conteúdo e serão refletidos em breve nas recomendações entregues. Se você não vir as alterações esperadas, tente novamente e atualize a página que contém as recomendações.
Notas:
- Se as alterações nos atributos de um item resultarem na exclusão de um item das recomendações, a exclusão será refletida imediatamente. Se um item for recém-adicionado ou se as alterações nos atributos resultarem na criação de um item não está mais excluído das recomendações, não é refletido até a atualização do próximo algoritmo, que ocorre em 24 horas.
- Quando esse status é exibido, as atualizações podem não ser refletidas ainda no Pesquisa no catálogo IU. Um status separado é listado em Pesquisa no catálogo indicando a última vez que o catálogo pesquisável foi atualizado.
Para atualizar um feed (por exemplo, para fazer alterações na sua configuração de feed ou arquivo de feed), abra o feed, faça qualquer alteração desejada e clique em Salvar.
Indicadores de status do feed section_3C8A236C5CB84C769A9E9E36B8BFABA4
O indicadores de status do feed a seguir são exibidos na coluna Status:
Considere os exemplos a seguir:
Exemplo 1:
- Dia um: processos de feed diários às 9h PST.
- Dia dois: são 15:30 e o feed aina não executou desde 9h.
O status deve ser amarelo, pois o índice deveria ter sido executado há aproximadamente 6,5 horas. 6,5 horas +24 é 127% da janela de feed.
Exemplo 2:
- Primeiro de janeiro: processos de feed mensais às 9h PST.
- 03 de fevereiro: são 10h e o feed não executou há um mês, um dia e uma hora.
O status deve ser amarelo, pois o índice deveria ter sido executado há aproximadamente um dia e uma hora. Embora isso seja somente (31+(1/25))/30 = 1,03% da configuração de frequência, ultrapassou o máximo de atraso de um dia.
Vídeos de treinamento
Os vídeos a seguir contêm mais informações sobre os conceitos discutidos neste artigo.
Noções básicas sobre feeds no Recommendations (3:01)
Este vídeo contém as seguintes informações:
- Entender a finalidade dos feeds
- Entender o valor dos feeds
Criar um feed (6:44)
Este vídeo contém as seguintes informações:
- Configurar um feed
- Saber qual tipo de feed usar