Ir para o conteúdo

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.

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:

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.

Área de upload onde você pode arrastar e soltar o arquivo ou selecionar Fazer upload de CSV para escolher o arquivo.

Selecione um tipo de dado para cada coluna.

Seleção do tipo de dado para cada coluna do catálogo, que não pode ser editado depois da configuração.

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

Um catálogo chamado "my_catalog".

Selecione Processar catálogo para criar o 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.

Quatro nomes de colunas do catálogo: "id", "title", "price", "image_link".

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.

Um catálogo chamado "games_catalog".

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.

Pré-requisitos

Antes de editar ou criar catálogos no navegador, você precisa das seguintes permissões de usuário no seu espaço de trabalho:

  • Visualizar catálogos
  • Editar catálogos
  • Exportar catálogos
  • Excluir catálogos

Etapa 1: Insira os detalhes do catálogo

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

Um catálogo chamado "my_catalog".

Etapa 2: Crie seu catálogo

Selecione seu catálogo na lista e, em seguida, selecione Atualizar catálogo > Adicionar campos. Insira o Nome do campo e use o menu suspenso para selecionar o tipo de dado. Repita conforme necessário.

Dois campos de exemplo, "rating" e "name".

Selecione Atualizar catálogo > Adicionar itens para adicionar um item ao catálogo, inserindo as informações com base nos campos que você adicionou. Depois, selecione Salvar item ou Salvar e adicionar outro para continuar adicionando itens.

Adicionar um item ao catálogo.

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:

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.

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.

New Stuff!