Criar 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 a Braze. Isso permite que você acesse 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.
Casos de uso
Os 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á acessá-las nas mensagens de forma semelhante ao acesso a atributos personalizados ou propriedades de eventos personalizados por meio do Liquid.
Tipos de dados suportados
A tabela a seguir lista os tipos de dados de catálogo suportados e como eles podem ser criados ou atualizados.
| Tipo de dado | Descrição | Disponível via upload de CSV | Disponível via API e CDI |
|---|---|---|---|
| String | Uma sequência de caracteres. | ✅ Sim | ✅ Sim |
| Número | Um valor numérico, inteiro ou decimal. | ✅ Sim | ✅ Sim |
| Booleano | Um valor true ou false. |
✅ Sim | ✅ Sim |
| Hora | Uma string formatada no formato ISO 8601. | ✅ Sim | ✅ Sim |
| Geolocalização | Um array de coordenadas [longitude, latitude]. A latitude deve estar entre -90 e 90; a longitude deve estar entre -180 e 180. Por exemplo, [-73.988103, 40.779109]. |
✅ Sim | ✅ Sim |
| Objeto JSON | Um objeto aninhado com pares chave-valor. Pode ser exibido na plataforma, mas só pode ser criado ou atualizado por meio da API ou CDI. | ⛔ Não | ✅ Sim |
| Array de strings | Uma lista de strings. Pode ser exibido na plataforma, mas só pode ser criado ou atualizado por meio da API ou CDI. Máximo de 100 elementos. | ⛔ Não | ✅ Sim |
Criar um catálogo
Para criar um catálogo, acesse Configurações de dados > Catálogos, selecione Criar novo catálogo e escolha uma das opções a seguir:
Etapa 1: Revise seu arquivo CSV
Antes de fazer upload do arquivo CSV, confira se ele atende aos seguintes requisitos:
| Requisito do CSV | Detalhes |
|---|---|
| Cabeçalhos | A primeira coluna do arquivo CSV deve se chamar id, e cada linha deve ter um valor de id exclusivo. |
| Colunas | Um arquivo CSV pode ter no máximo 1.000 campos (colunas), e cada nome de coluna pode ter até 250 caracteres. |
| Tamanho do arquivo | Nos planos Free, o tamanho total de todos os arquivos CSV de uma empresa é limitado a 500 MB. Nos planos Pro, o tamanho máximo de um único arquivo CSV é de 2 GB. |
| Valores dos campos | Cada célula (valor de campo) pode ter até 5.000 caracteres. |
| Caracteres válidos | A coluna id e todos os valores de cabeçalho só podem conter letras, números, hifens e sublinhados. |
| Tipos de dados | Os tipos de dados aceitos para uploads de CSV incluem string, número, booleano, horário e geolocalização. Para ver a lista completa de tipos de dados, incluindo os disponíveis apenas pela API e pela CDI, consulte Tipos de dados suportados. |
| Formatação | Formate todo o texto em letras minúsculas para manter a consistência. |
| Codificação | Salve e faça upload do arquivo CSV usando a codificação UTF-8. |

Precisa de mais espaço para seus arquivos CSV? Entre em contato com o gerente da sua conta Braze para saber mais sobre como fazer upgrade dos seus catálogos.
Etapa 2: Faça upload do CSV
Arraste e solte o arquivo na área de upload ou selecione Fazer upload de CSV e escolha o arquivo.

Selecione um tipo de dado para cada coluna.

Não é possível editar esse tipo de dado depois de configurar o catálogo. Além disso, o valor NULL não é aceito no upload de CSV e será tratado como string.

Insira um nome e uma descrição opcional para o catálogo. Ao nomear o catálogo, lembre-se dos seguintes requisitos:
- Deve ser exclusivo
- Máximo de 250 caracteres
- Só pode conter números, letras, hifens e sublinhados

Você também pode usar modelos no nome do catálogo para gerar nomes de catálogo dinamicamente com base em variáveis como idioma ou Campaign.

Selecione Processar catálogo para criar o catálogo.

A Braze rejeita seu arquivo CSV se ele não atender aos requisitos de CSV da Etapa 1, como o cabeçalho id, IDs de item exclusivos e válidos, limites de colunas, codificação UTF-8 e os limites de tamanho do seu nível. Se o arquivo CSV for rejeitado, revise esses requisitos e faça o upload novamente. Para problemas de Liquid ou personalização após um upload bem-sucedido, consulte Solução de problemas de personalização do catálogo.
Tutorial: Criar um catálogo a partir de um arquivo CSV
Neste tutorial, usamos um catálogo que lista dois jogos, o preço de cada um e um link de imagem.
| id | title | price | image_link |
|---|---|---|---|
| 1234 | Tales | 7.49 | https://picsum.photos/200 |
| 1235 | Regeneration | 22.49 | https://picsum.photos/200 |
Vamos criar o catálogo fazendo upload de um arquivo CSV. Os tipos de dados de id, title, price e image_link são, respectivamente, string, string, número e string.

Não é possível editar esse tipo de dado depois de configurar o catálogo.

Em seguida, vamos dar o nome “games_catalog” ao catálogo e selecionar o botão Processar catálogo. Então, a Braze verifica se há erros no catálogo antes de criá-lo.

Não será possível 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.
Depois de criar o catálogo, você pode começar a referenciar o catálogo em uma Campaign.

Os arquivos CSV enviados anteriormente ficam disponíveis para download na página Catálogos por 30 dias após a data do upload. Depois de 30 dias, o arquivo é excluído permanentemente e não pode mais ser acessado.
Tipos de dados do catálogo
Os catálogos aceitam vários tipos de dados para ajudar você a organizar e estruturar seus dados de forma eficaz. A tabela a seguir descreve cada tipo de dado aceito e como ele corresponde aos nomes de tipo em CSV e na API:
| Tipo de dado | Formato | Exemplo | Descrição |
|---|---|---|---|
| String | Texto | "Hello World" |
Qualquer sequência de caracteres usada para dados de texto, como nomes, descrições e IDs. Equivale ao tipo string em importações por CSV e pela API. |
| Hora | ISO 8601 ou carimbo de data/hora Unix (segundos) | "2024-03-15T14:30:00Z" |
Valores de data e hora no formato ISO 8601 ou carimbo de data/hora Unix em segundos. Equivale ao tipo time na API e ao tipo datetime em importações por CSV. |
| Booleano | true ou false |
true |
Valores lógicos que representam os estados verdadeiro ou falso. Equivale ao tipo boolean em importações por CSV e pela API. |
| Número | Inteiro ou decimal | 42 ou 19.99 |
Valores numéricos, incluindo inteiros e números de ponto flutuante, para preços, quantidades, avaliações e muito mais. Equivale aos tipos integer e float em importações por CSV e ao tipo number na API. |
| Geolocalização | Array [longitude, latitude] |
[-73.988103, 40.779109] |
Um par de coordenadas que representa um local geográfico. A longitude deve estar entre -180 e 180, e a latitude entre -90 e 90. O valor de type na API é geo. Pode ser adicionado pela gaveta Adicionar campos na interface de catálogos, por upload de CSV ou pela REST API. |
| Objeto | Objeto JSON | {"key": "value", "price": 10} |
Estruturas de dados aninhadas complexas. O valor de type na API é object. Aparece como objeto JSON no dashboard. Disponível apenas pela API ou pela ingestão de dados na nuvem (CDI). |
| Array | Array de strings | ["red", "blue", "green"] |
Listas de valores de string. O valor de type na API é array. Aparece como array de strings no dashboard. Disponível apenas pela API ou pela CDI. |
Usando modelos em nomes de catálogo
Ao nomear seu catálogo, você também pode usar modelos em um nome de catálogo. Isso permite gerar dinamicamente nomes de catálogo com base em variáveis como idioma ou Campaign. Por exemplo, você pode usar o seguinte:
{% assign language = "content_spanish" %}
{% catalog_items {{language}} fall_campaign %}
{{ items[0].body }}
Gerenciamento de catálogos
No dashboard
Para atualizar seu catálogo depois de fazer upload de um CSV ou criar um catálogo no navegador, selecione Atualizar catálogo > Fazer upload de CSV. Em seguida, escolha se deseja atualizar, adicionar ou excluir itens no seu catálogo.
Usando a REST API
Conforme você cria mais catálogos, também pode usar o endpoint Listar catálogos para retornar uma lista dos catálogos de um espaço de trabalho.
A REST API oferece suporte a todos os tipos de dados de catálogo, incluindo objetos JSON e arrays de strings. Objetos JSON e arrays de strings só podem ser criados ou atualizados pela REST API.
Usando a ingestão de dados na nuvem
Você pode manter catálogos com a ingestão de dados na nuvem sincronizando os dados do catálogo diretamente do seu data warehouse (como Snowflake, Redshift, BigQuery, Databricks, Microsoft Fabric ou S3) de forma agendada.
Gerenciamento de itens de catálogo
Além de gerenciar seus catálogos, você também pode usar endpoints assíncronos e síncronos para gerenciar os itens de catálogo. Isso inclui editar e excluir itens de catálogo e listar os detalhes dos itens de catálogo.
Por exemplo, para editar um item de catálogo individual, você pode usar o endpoint /catalogs/catalog_name/items/item_id.
Armazenamento de catálogo
A versão gratuita dos catálogos suporta tamanhos de arquivo CSV de até 500 MB para todos os arquivos CSV combinados na sua empresa, enquanto a versão Catalogs Pro suporta tamanhos de arquivo CSV de até 2 GB para um único arquivo CSV.

O direito ao pacote mostrado no dashboard da Braze é arredondado para a unidade mais próxima para fins visuais; no entanto, você ainda tem direito ao valor total adquirido. Para solicitar um upgrade do armazenamento de catálogos, fale com seu gerente de conta da Braze.
Versão gratuita
O tamanho do armazenamento da versão gratuita dos catálogos é de até 500 MB. Você pode ter itens ilimitados desde que estejam abaixo de 500 MB.
Catalogs 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. Observe que o armazenamento da versão gratuita (500 MB) está incluído em cada um desses planos.
Especificações
A tabela a seguir resume as especificações do que você pode incluir nos catálogos.
| Área | Especificações |
|---|---|
| Caracteres do valor do item | Até 5.000 caracteres em um único valor. Por exemplo, se você tiver um campo chamado description, o número máximo de caracteres nesse campo é 5.000. |
| Caracteres do nome da coluna do item | Até 250 caracteres |
| Seleções por catálogo | Até 30 seleções por catálogo |

As Liquid tags de catálogo não podem ser usadas de forma recursiva. Ou seja, não é possível referenciar um item de catálogo que, por sua vez, chama um segundo item de catálogo dentro da mesma avaliação de Liquid.

