Criação de um catálogo

A criação de um catálogo envolve a importação de um arquivo CSV de dados de não usuários para o Braze. Isso lhe permite acessar essas informações para enriquecer suas mensagens. Você pode trazer qualquer tipo de dados para um catálogo. Normalmente, esses dados são algum tipo de metadados da sua empresa, como informações sobre produtos para uma empresa de comércio eletrônico ou informações sobre cursos para um provedor de educação.

Alguns casos de uso comuns para catálogos incluem:

• Produtos
• Serviços
• Alimentos
• Próximos eventos
• Música
• Pacotes

Depois que essas informações forem importadas, você poderá começar a acessá-las nas mensagens de forma semelhante ao acesso a atributos personalizados ou propriedades de eventos personalizados por meio do Liquid.

Preparando seu arquivo CSV

Antes de criar um catálogo, prepare seu arquivo CSV se seu método preferido de criação de catálogo for upload.

Diretrizes para o arquivo CSV

Observe estas diretrizes ao criar seu arquivo CSV. A primeira coluna do arquivo CSV deve ser um cabeçalho de id, e o id de cada item deve ser exclusivo. Todos os outros nomes de colunas devem ser exclusivos. Além disso, as seguintes limitações se aplicam aos arquivos CSV do catálogo:

• Máximo de 1.000 campos (colunas)
• Nome máximo do campo (coluna) de 250 caracteres
• Máximo de 100 MB para todos os arquivos CSV combinados em sua empresa (gratuito)
• Tamanho máximo do arquivo CSV de 2 GB (Pro)
• Valor máximo do campo (célula) de 5.000 caracteres
• Somente letras, números, hífens e sublinhados para id e valores de cabeçalho

Também recomendamos a formatação de todo o texto em seus arquivos CSV em letras minúsculas. Codifique o arquivo CSV usando o formato UTF-8 para fazer upload do arquivo CSV na próxima etapa.

Escolha do método

Para criar um catálogo, acesse Configurações de dados > Catálogos.

Selecione Criar novo catálogo e, em seguida, escolha fazer upload de CSV ou criar no navegador.

Método 1: Fazer upload de CSV

1. Arraste e solte seu arquivo na zona de upload ou clique em Upload CSV e escolha seu arquivo.
   
   
   
2. Selecione um dos seguintes tipos de dados para cada coluna: booleano, número, string ou hora.
   
   
   
3. Dê um nome ao seu catálogo. Tenha em mente os seguintes requisitos para um nome de catálogo:
   • Deve ser exclusivo
   • Máximo de 250 caracteres
   • Só pode incluir números, letras, hífens e sublinhados
     
     
4. (opcional) Adicione uma descrição para o catálogo.
5. Clique em Processar catálogo para criar o catálogo.

Também é possível usar modelos em um nome de catálogo. Por exemplo, você pode usar o seguinte:

1
2
3
4
{% assign language = "content_spanish" %}

{% catalog_items {{language}} fall_campaign %}
{{ items[0].body }}

Você também pode atualizar o arquivo CSV depois de selecionar a criação de um catálogo no navegador. Clique em Atualizar catálogo > Fazer upload de CSV e, em seguida, selecione se deseja atualizar, adicionar ou excluir itens em seu catálogo.

Método 2: Criar no navegador

1. Digite um nome para seu catálogo. Tenha em mente os seguintes requisitos para o nome do seu catálogo:
   • Deve ser exclusivo
   • Até 250 caracteres
   • Só pode incluir números, letras, hífens e sublinhados
     
     
     
2. (opcional) Digite uma descrição para seu catálogo.
3. Selecione o catálogo que você acabou de criar na página List Catalogs para atualizar seu catálogo.
4. Selecione Update Catalog > Add fields para adicionar seus campos. Em seguida, digite o nome do campo e use a lista suspensa para selecionar o tipo de dados. Repita conforme necessário.
   
   
   
5. Selecione Update Catalog > Add items para adicionar um item ao seu catálogo, inserindo as informações com base nos campos adicionados anteriormente. Em seguida, selecione Salvar item ou Salvar e adicionar outro para continuar adicionando seus itens.
   

Também é possível fazer upload de um arquivo CSV depois de selecionar a criação de um catálogo no navegador.

Tutorial: Criação de um catálogo a partir de um arquivo CSV

Para este tutorial, estamos usando um catálogo que lista dois jogos, seu custo e um link de imagem.

Criaremos o catálogo fazendo upload de um arquivo CSV. Os tipos de dados para id, title, price e image_link são string, string, number e string, respectivamente.

Em seguida, nomearemos esse catálogo como “games_catalog” e clicaremos no botão Process Catalog (Processar catálogo ). Em seguida, a Braze verificará se há erros no catálogo antes da criação do catálogo.

Note que você não poderá editar esse nome depois que o catálogo for criado. Você pode excluir um catálogo e fazer upload novamente de uma versão atualizada usando o mesmo nome de catálogo.

Depois de criar o catálogo, você pode começar a fazer referência ao catálogo em uma campanha.

Gerenciamento de catálogos por meio da API

À medida que cria mais catálogos, você também pode usar o ponto de extremidade List catalogs para retornar uma lista dos catálogos em um espaço de trabalho.

Gerenciamento de itens do catálogo

Além de gerenciar seus catálogos, você também pode usar endpoints assíncronos e síncronos para gerenciar os itens do catálogo. Isso inclui a capacidade de editar e excluir itens de catálogo e de listar detalhes de itens de catálogo.

Por exemplo, para editar um item de catálogo individual, use o endpoint /catalogs/catalog_name/items/item_id.

Níveis de catálogo

A tabela a seguir descreve as diferenças entre as versões gratuita e profissional dos catálogos:

Armazenamento do catálogo

Versão gratuita

O tamanho do armazenamento da versão gratuita dos catálogos é de até 100 MB. Você pode ter itens ilimitados, desde que tenham menos de 100 MB. As seleções contribuirão para seu armazenamento. Quanto mais complexa for uma seleção, mais espaço de armazenamento ela ocupará. Haverá também uma incompatibilidade de tamanho entre os dados do catálogo CSV e a representação desses dados em nosso repositório de dados.

Catálogos Pro

Em nível de empresa, o armazenamento máximo do Catalogs Pro é baseado no tamanho dos dados do catálogo. As opções de tamanho de armazenamento são: 5 GB, 10 GB ou 15 GB. Note que o armazenamento da versão gratuita (100 MB) está incluído em cada um desses planos.