Skip to content

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 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 do Commons 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 modo semelhante ao acesso a atributos personalizados ou propriedades de eventos personalizados por meio do Liquid.

Criação de um catálogo

Para criar um catálogo, vá para Configurações de dados > Catálogos, selecione Criar novo catálogo e escolha uma das seguintes opções:

Etapa 1: Revise seu arquivo CSV

Antes de carregar o arquivo CSV, verifique se ele atende aos seguintes requisitos:

Etapa 2: Carregar CSV

Arraste e solte seu arquivo na zona de upload ou selecione Upload CSV e escolha seu arquivo.

!

Selecione um tipo de dados para cada coluna.

!

Digite um nome e uma descrição opcional para seu catálogo. Tenha em mente os seguintes requisitos ao nomear seu catálogo:

  • Deve ser exclusivo
  • Máximo de 250 caracteres
  • Só pode incluir números, letras, hífens e sublinhados

!Um catálogo chamado “my_catalog”.

Selecione Process Catalog para criar o catálogo.

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.

id título preço image_link
1234 Contos 7.49 https://picsum.photos/200
1235 Regeneração 22.49 https://picsum.photos/200

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

!Quatro nomes de coluna do catálogo: “id”, “title”, “price”, “image_link”.

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

!Um catálogo chamado “games_catalog”.

Observe que você não poderá editar esse nome depois que o catálogo for criado. Você pode excluir um catálogo e fazer o 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.

Pré-requisitos

Antes de poder editar ou criar catálogos no navegador, você precisará da permissão Manage Catalogs Dashboard.

Digite um nome e uma descrição opcional para seu catálogo. Tenha em mente os seguintes requisitos ao nomear seu catálogo:

  • Deve ser exclusivo
  • Máximo de 250 caracteres
  • Só pode incluir números, letras, hífens e sublinhados

!Um catálogo chamado “my_catalog”.

Selecione seu catálogo na lista e, em seguida, selecione Update Catalog > Add fields( Atualizar catálogo > Adicionar campos). Digite o nome do campo e use o menu suspenso para selecionar o tipo de dados. Repita conforme necessário.

!Dois campos de exemplo “rating” e “name”.

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.

!Adicionar um item de catálogo.

Uso de modelos em nomes de catálogos

Ao nomear seu catálogo, você também pode usar modelos em um nome de catálogo. Isso permite que você gere dinamicamente nomes de catálogos com base em variáveis como idioma ou campanha. Por exemplo, você pode usar o seguinte:

1
2
3
4

{% assign language = "content_spanish" %}

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

Gerenciamento de catálogos

No painel de controle

Para atualizar o catálogo após carregar um CSV ou criar um catálogo no navegador, selecione Update Catalog > Upload CSV e, em seguida, selecione se deseja atualizar, adicionar ou excluir itens do catálogo.

Usando a API REST

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

Os tipos de dados compatíveis com o uso da API incluem: string, integer, float, boolean ou datetime. Você também pode fazer upload de matrizes e objetos ao gerenciar seus catálogos com a API.

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, se você quiser editar um item de catálogo individual, poderá usar o ponto de extremidade/catalogs/catalog_name/items/item_id .

Armazenamento do catálogo

A versão gratuita do Catalogs suporta tamanhos de arquivo CSV de até 100 MB para todos os arquivos CSV combinados em 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é 100 MB. Você pode ter itens ilimitados, desde que eles tenham menos de 100 MB.

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. Observe que o armazenamento da versão gratuita (100 MB) está incluído em cada um desses planos.
Github   Editar esta página no GitHub
New Stuff!