Use os feeds para importar entidades em Adobe Target Recommendations. As entidades podem ser enviadas usando arquivos CSV, o formato de feed Google Product Search e as classificações de produto Adobe Analytics.
Visão geral dos feeds concept_D1E9C7347C5D4583AA69B02E79607890
Os feeds permitem passar Entidades ou aumentar seus dados de 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. Por exemplo, margem, Custo de Mercadorias Vendidas (COGS) e assim por diante.
Os feeds também permitem passar informações detalhadas do item para 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 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 Target coletar dados usando um feed de entidade e uma mbox, os dados mais recentes prevalecerão. 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 chegarem ao mesmo tempo, os dados da mbox serão usados.
A lista Feeds ( Recommendations > Feeds) fornece informações sobre quaisquer feeds criados.
A página 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.
Agenda: exibe a agenda de atualização do feed: Diariamente, Semanalmente, Every 2 Weeks ou Nunca.
Ú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.
Clique no ícone Personalizar Tabela (
) para selecionar ou desmarcar as colunas que deseja exibir.
Clique no ícone Informações (
) para exibir um cartão que exibe a data do último carregamento e a URL do feed.
Clique no ícone Mais Ações (
) 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 interface ou da API Target. Ou modifique os atributos do item (como inventário) para garantir que o item seja excluído da consideração.
Tipos de Source
As entidades podem ser enviadas usando arquivos CSV, o formato de feed Google Product Search e as classificações de produto Adobe Analytics.
CSV section_65CC1148C7DD448FB213FDF499D35FCA
Você pode criar um arquivo .csv usando o formato de upload CSV proprietário do Adobe. 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.
O uso do formato .csv tem as seguintes vantagens em relação ao formato de feed Google:
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.
Qualquer dado carregado por meio do arquivo .csv, feed de produto do Google ou feed de classificação de produto do Analytics 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 Recomendações 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 substituir o valor existente. 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 Google Product Search usa o formato Google em vez do formato CSV proprietário Adobe. Você pode reutilizar um Google Product Feed existente para importar dados do produto para o Recommendations.
NOTE
Você não precisa enviar os seus dados para Google. Você pode importar seus próprios dados e agendar atualizações, desde que o arquivo use os nomes de atributo Google predefinidos.
Recommendations aceita arquivos .xml, .txt e .tsv que seguem a especificação de feed Google e usa os atributos definidos pelo Google. Especifique a URL ou o local FTP do feed para que o servidor Recommendations possa recuperar o arquivo e criar o catálogo.
NOTE
O servidor que hospeda o feed Google deve permitir o método POST.
Lembre-se dos seguintes requisitos e limitações:
Uma mbox de página de produto ainda é necessária para exibir recomendações nessa página ou rastrear visualizações de produto para algoritmos baseados em visualização.
Os feeds Google não dão suporte a vários valores para um atributo personalizado.
O feed é executado quando você o salva e ativa e, em seguida, diariamente uma hora depois do tempo de execução inicial.
O exemplo a seguir mostra um feed Google Product Search no formato .xml:
Este é um exemplo de código para um arquivo .tsv de feed 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
Classificações de produto de Analytics section_79E430D2C75443BEBC9AA0916A337E0A
A classificação do Produto Adobe Analytics é a única classificação disponível para recomendações. Para obter mais informações sobre esse arquivo de classificação, consulte Sobre classificações no guia Componentes do Analytics. É possível que nem todas as informações que você precisa para as recomendações estejam disponíveis em sua implementação atual do, por isso, siga o guia do usuário se desejar adicioná-las ao arquivo de classificações.
IMPORTANT
Antes de importar dados de entidade para Recommendations usando Analytics classificações de produto, esteja ciente de que este 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 dá suporte somente a Classificações de Produto. O SKU do produto Analytics deve mapear no mesmo nível que o Recommendations entity.id. As Classificações personalizadas Analytics podem ser projetadas usando os Serviços da Adobe Consulting. 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 Source.
CSV
Feed do produto Google
Classificações do Analytics
Para obter informações sobre os tipos de feed do CSV e do Feed do produto Google, consulte a Visão geral dos feeds. Você também pode 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.
accordion
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.
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.
+++
SFTP: digite o nome do host ou endereço IP do servidor SFTP, a porta (padrão: 22), o nome de usuário, o diretório e o nome do arquivo. Para autenticação, forneça uma senha, uma chave privada SSH ou ambas.
accordion
Configurações e limitações do servidor SFTP compatíveis
A autenticação usa uma senha, uma chave privada SSH ou ambas. Pelo menos um é necessário.
O cliente gera e é proprietário do par de chaves. Instale a chave pública no arquivo authorized_keys do usuário SFTP e cole a chave privada no Target como texto PEM. Os tipos de chave aceitos são RSA, Ed25519 e ECDSA, no formato PEM (-----BEGIN RSA PRIVATE KEY-----), PKCS#8 (-----BEGIN PRIVATE KEY-----) ou OpenSSH (-----BEGIN OPENSSH PRIVATE KEY-----).
Não há suporte para chaves privadas protegidas por senha. Um feed não pode ser salvo com um.
O Target armazena a chave privada criptografada e não a exibe novamente. Para girá-lo, edite o feed e insira a nova chave.
Insira um nome de host ou endereço IP simples, sem um prefixo, porta ou caminho sftp://. Use o campo Porta para uma porta não-padrão.
A chave de host do servidor é aceita na primeira conexão; não é necessária nenhuma troca de impressão digital com o Adobe.
O SFTP está disponível na interface do Target e na API do Recommendations, mas não na interface do administrador herdada do Recommendations Classic. A Adobe não hospeda um terminal SFTP, use um servidor hospedado pelo cliente.
O servidor SFTP deve ser acessível pela Internet e permitir conexões de entrada dos endereços de download da Adobe Target. A lista de IPs de produção deve ser confirmada pela engenharia antes da publicação dessa atualização.
+++
URL: se você selecionar URL, especifique a 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 agendar 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 e especifique como deseja mapear seus dados para as definições de 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 e, em seguida, é atualizado de acordo com suas configurações. O feed deve sincronizar, processar e indexar antes que seus dados estejam disponíveis. Verifique o progresso em Status do feed na lista Feeds. O processamento continua mesmo se você fechar Target.
Durante a indexação, os cabeçalhos de produtos e feed são exibidos antes de valores individuais, para que você possa pesquisar produtos e criar coleções, exclusões, designs e atividades antes da conclusão da indexação.
O status “Success” significa que o arquivo foi encontrado e analisado corretamente. Seus dados estão disponíveis no Recommendations somente após a indexação, o que leva tempo dependendo do tamanho do arquivo. As falhas podem resultar de um URL incorreto ou informações de FTP, de um arquivo ausente ou de 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
Sincronizando
Os detalhes de configuração do feed estão sendo salvos em Target.
Falha na sincronização
Os detalhes de configuração do feed não puderam ser salvos em Target. Tente novamente.
Nenhum feed executado
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 está se preparando para baixar o arquivo de feed.
Baixando Arquivo de Feed
Target está baixando o arquivo de feed.
Importando itens
Target está importando itens do arquivo de feed.
Feed importado com êxito no momento
Target 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. Observações:
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 exclusão de um item não mais das recomendações, isso não será refletido até a atualização do próximo algoritmo, que ocorre em 24 horas.
Quando este status é exibido, as atualizações podem ainda não ser refletidas na interface do usuário da Pesquisa no catálogo. Um status separado está listado em Pesquisa no Catálogo, indicando a última vez que o catálogo pesquisável foi atualizado.
Falha na importação parcial
Anteriormente, quando todas as linhas não eram carregadas, o feed ainda era marcado como bem-sucedido. Assim, criar uma falsa impressão de que todas as linhas foram carregadas, pois o feed foi mostrado como bem-sucedido.
Este é um cenário do por que você pode encontrar uma importação parcial de feed:
Você carregou um arquivo de feed para o ambiente de produção, por exemplo, 100 linhas.
O feed executou e carregou 80 dessas linhas e descartou 20 linhas devido à formatação incorreta, o campo excedeu os caracteres e assim por diante.
O feed foi marcado como sucesso na interface do usuário, dando a impressão de que todas as 100 linhas foram carregadas.
Você está esperando alguns desses 20 produtos no delivery de uma atividade, mas isso não está acontecendo.
Você está intrigado neste momento porque carregou o feed que tem os detalhes do produto para os produtos em questão. Você não o vê no back-end ao consultar por meio da API da entidade, que informa que não está no back-end.
Para remover essa confusão, a mensagem é aprimorada para informar exatamente o que aconteceu com o feed. Em vez de marcá-la como um sucesso, ela agora é marcada como falha de importação parcial.
Falha ao indexar
Ocorreu uma falha na operação de índice. Tente novamente.
Servidor Não Encontrado
Os locais FTP, SFTP ou URL são inválidos ou inacessí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 deduzirá que o item não é mais relevante e o removerá 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 amarelo é exibido para um feed definido para execução diária, se o índice não tiver sido concluído seis horas após o horário 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:
Primeiro dia: o feed é processado diariamente às 9h PST.
Dia dois: são 15h30 e o feed não funciona desde ontem às 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:
1 de janeiro: o feed mensal é processado às 9:00 PST.
3 de fevereiro: são 10h e o feed não é executado por um mês, um dia e uma hora atrás.
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)
