Premium
Consulte o que está incluído no Target Premium.

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.

Página de feeds

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.

IMPORTANT
As entidades e os atributos de entidade carregados expiram após 61 dias. Isso significa o seguinte:
  • 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.

IMPORTANT
Não coloque os valores entre aspas duplas ( " ) no arquivo .csv, a menos que seja intencional. Se colocar os valores entre aspas duplas, você poderá removê-los ao incluí-los em outro conjunto de aspas duplas. As aspas duplas que não forem removidas evitarão que o feed do Recommendations carregue corretamente.

Por exemplo, a sintaxe a seguir está incorreta:

"Apples "Bananas" Grapes"",

A sintaxe a seguir está correta:

"Apples ""Bananas"" Grapes""",
NOTE
Não é possível substituir um valor existente por um valor em branco. Passe outro valor em seu lugar para substituí-lo. No caso de um preço de venda, uma solução comum é transmitir uma mensagem "NULA" real ou alguma outra mensagem. Você poderá escrever uma regra do modelo para excluir itens com esse valor.

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.

NOTE
Não é necessário utilizar dados do Google. Recommendations O usa o mesmo formato que o Google. Você pode usar este método para atualizar qualquer dado que possua e usar os recursos de programação disponíveis. No entanto, você dever manter os nomes predefinidos dos atributos do Google ao configurar o arquivo.

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.

NOTE
O método POST deve ser permitido no servidor que está hospedando o conteúdo de feed 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 &amp; 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 &amp; 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.

IMPORTANT
Antes de importar dados de entidade para Recommendations usar Analytics classificações do produto, esteja ciente de que esse não é o método preferido.
Esteja ciente dos seguintes avisos:
  • 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.

  1. Na interface do Target, clique em Recomendações > Feeds > Criar feed.

    Caixa de diálogo Criar feed

  2. Especifique um nome descritivo para o feed.

  3. 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.

  4. (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.

  5. (Condicional) Se você selecionou Classificações do Analytics, escolha o conjunto de relatórios na lista suspensa.

  6. Clique na seta Avançar para exibir as opções de Agendar.

    Resultado da etapa

  7. 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.
  8. 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.

  9. 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.

    Resultado da etapa

  10. (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.

  11. 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:

Status
Descrição
Sincronização
Os detalhes de configuração do feed são salvos no Target.
Falha na sincronização
Os detalhes de configuração do feed não foram salvos no Target. Tente novamente.
Nenhuma execução do feed
Você criou um feed, mas ele não foi agendado (a frequência está definida como Nunca).
Agendado na data e hora
O feed não foi executado, mas está agendado para execução na data e hora especificada.
Aguardando o download
Target O está se preparando para baixar o arquivo de feed.
Download do arquivo de feed
Target O está baixando o arquivo de feed.
Importar itens
TargetO está importando itens do arquivo de Feed.
Feed importado com êxito no momento

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.
Falha ao indexar
Ocorreu uma falha na operação de índice. Tente novamente.
Servidor não encontrado
Locais de FTP ou URL inválidos ou não acessíveis.

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.

IMPORTANT
As entidades carregadas expiram após 61 dias. Isso significa que o seu arquivo de feed deve ser carregado pelo menos a cada 60 dias para evitar uma interrupção nas atividades de recomendações. Se um item não estiver incluído em um arquivo de feed (ou em outro método de atualização de entidade) pelo menos uma vez a cada 60 dias, Target infere que o item não é mais relevante e o remove do catálogo.

Indicadores de status do feed section_3C8A236C5CB84C769A9E9E36B8BFABA4

O indicadores de status do feed a seguir são exibidos na coluna Status:

Indicador de status
Descrição
Indicador de status verde
Quando um feed acaba de indexar de modo bem-sucedido, um ponto de status verde indica que o feed está em um estado bem-sucedido.
Indicador de status amarelo
Quando um feed ou índice de feed é atrasado em 25% da frequência de feed, um ponto de status amarelo é exibido. Por exemplo, um ponto de status amarelo é exibido para um feed definido para execução diária, se o índice ainda não concluiu seis horas após o tempo agendado. Observação: assim que o status do feed for "Aguardando para fila de índice" os novos valores atualizados estarão disponíveis no processamento de entrega e critérios.
Indicador de status branco
Quando um feed não está agendado, um ponto de status branco indica que o feed ainda não foi executado.
Indicador de status vermelho
Se o feed não carregar dados no servidor, um indicador de status vermelho será mostrado.

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) Selo de visão geral

Este vídeo contém as seguintes informações:

  • Entender a finalidade dos feeds
  • Entender o valor dos feeds

Criar um feed (6:44) Selo do tutorial

Este vídeo contém as seguintes informações:

  • Configurar um feed
  • Saber qual tipo de feed usar
recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654