Usando catálogos

Depois de criar um catálogo, é possível fazer referência a dados de não usuários em suas campanhas do Braze por meio do Liquid. Você pode usar catálogos em todos os seus canais de envio de mensagens, inclusive em qualquer lugar do editor de arrastar e soltar em que o Liquid seja compatível.

Uso de catálogos em uma mensagem

Etapa 1: Adicionar tipo de personalização

No criador de mensagem de sua escolha, selecione o ícone de mais para abrir o modal Adicionar Personalização e selecione Itens do Catálogo para o Tipo de Personalização. Em seguida, selecione o nome do seu catálogo. Usando nosso exemplo anterior, selecionaremos o catálogo “Games” (Jogos).

Podemos ver imediatamente a prévia do Liquid a seguir:

1
{% catalog_items Games %}

Etapa 2: Selecione os itens do catálogo

Em seguida, é hora de adicionar seus itens de catálogo! Usando o menu suspenso, selecione os itens do catálogo e as informações a serem exibidas. Essas informações correspondem às colunas do arquivo CSV feito upload e usado para gerar seu catálogo.

Por exemplo, para fazer referência ao título e ao preço do nosso jogo Tales, poderíamos selecionar id para Tales (1234) como o item do catálogo e solicitar title e price para as informações exibidas.

1
2
3
{% catalog_items Games 1234 %}
 
Get {{ items[0].title }} for just {{ items[0].price }}!

O resultado é o seguinte:

Adquira o Tales por apenas 7,49!

Exportando catálogos

Existem duas maneiras de exportar catálogos do dashboard:

• Passe o mouse sobre a linha do catálogo na seção Catálogos. Em seguida, selecione o botão Exportar catálogo.
• Selecione seu catálogo. Em seguida, selecione o botão Exportar catálogo na guia Prévia do catálogo.

Você receberá um e-mail para baixar o arquivo CSV após iniciar a exportação. Você terá até quatro horas para recuperar este arquivo.

Casos de uso adicionais

Vários itens

Você não está limitado a um item em uma mensagem. Use o modal Adicionar Personalização para adicionar até três itens do catálogo de cada vez. Para adicionar mais, selecione Adicionar Personalização novamente no criador e selecione itens e informações adicionais do catálogo para exibir.

Veja este exemplo em que adicionamos o endereço id de três jogos, Tales, Teslagrad e Acaratus, para Catalog Items e selecionamos title para Information to Display.

Podemos personalizar ainda mais nossa mensagem adicionando algum texto ao redor de nosso Liquid:

1
2
Get the ultimate trio {% catalog_items Games 1234 1235 1236 %}
{{ items[0].title }}, {{ items[1].title }}, and {{ items[2].title }} today!

O retorno é o seguinte:

Get the ultimate trio Tales, Teslagrad, and Acaratus today!

Usando declarações do Liquid if

Você pode usar itens de catálogo para criar instruções condicionais. Por exemplo, você pode disparar uma determinada mensagem para ser exibida quando um item específico for selecionado em sua campanha.

Para fazer isso, você usará uma instrução Liquid if, como neste exemplo:

1
2
3
4
5
6
7
8
{% catalog_selection_items item-list selections %} 
{% if items[0].venue_name.size > 10 %}
Message if the venue name's size is more than 10 characters. 
{% elsif items[0].venue_name.size <= 10 %}
Message if the venue name's size is 10 characters or fewer. 
{% else %} 
{% abort_message('no venue_name') %} 
{% endif %}

Neste exemplo, mensagens diferentes são exibidas dependendo do número de caracteres no campo do item do catálogo venue_name. Se venue_name estiver em branco, a mensagem é abortada.

Note que você deve declarar a lista de catálogos e, se aplicável, a seleção antes de usar as declarações if. No exemplo, item-list é a lista de catálogos e selections é o nome da seleção.

Usando imagens

Você também pode fazer referência a imagens no catálogo para usar em seu envio de mensagens. Para fazer isso, use a tag catalogs e o objeto item no campo Liquid para imagens.

Por exemplo, para adicionar o image_link do nosso catálogo de jogos à nossa mensagem promocional para Tales, selecione id para o campo Catalog Items (Itens do catálogo ) e image_link para o campo Information to Display (Informações a serem exibidas ). Isso adiciona as seguintes tags Liquid ao nosso campo de imagem:

1
2
3
{% catalog_items Games 1234 %}

{{ items[0].image_link }}

Veja como isso se parece quando o Liquid é renderizado:

Modelo de itens de catálogo

Você também pode usar modelos para extrair dinamicamente itens do catálogo com base em atributos personalizados. Por exemplo, digamos que um usuário tenha o atributo personalizado wishlist, que contém uma matriz de IDs de jogos do seu catálogo.

1
2
3
4
5
6
7
8
{
    "attributes": [
        {
            "external_id": "user_id",
            "wishlist": ["1234", "1235"]
        }
    ]
}

Usando o envio de mensagens Liquid, você pode extrair dinamicamente os IDs da lista de desejos e usá-los em sua mensagem. Para fazer isso, atribuir uma variável ao seu atributo personalizado, depois use o modal Adicionar Personalização para puxar um item específico do array. Variáveis referenciadas como o ID do item do catálogo devem estar envolvidas em chaves para serem referenciadas corretamente, como ``.

Por exemplo, para informar a um usuário que o Tales (um item do nosso catálogo que ele desejou) está em promoção, podemos adicionar o seguinte ao nosso criador de mensagens:

1
2
3
4
{% assign wishlist = {{custom_attribute.${wishlist}}}%}
{% catalog_items Games {{ wishlist[0] }} %}

Get {{ items[0].title }} now for {{ items[0].price }}!

Que será exibido da seguinte forma:

Adquira Tales agora por apenas 7,49!

Com o modelo, é possível renderizar um item de catálogo diferente para cada usuário com base em seus atributos personalizados individuais, propriedades de eventos ou qualquer outro campo modelável.

Fazendo upload de um CSV

Você pode fazer upload de um CSV de novos itens de catálogo a serem adicionados ou de itens de catálogo a serem atualizados. Para excluir uma lista de itens, você pode fazer upload de um CSV de IDs de itens para excluí-los.

Usando Liquid

Você também pode montar catálogos manualmente com lógica Liquid. No entanto, note que se você digitar um ID que não existe, a Braze ainda retornará um vetor de itens sem objetos. Recomendamos que você inclua o tratamento de erros, como a verificação do tamanho da matriz e o uso de uma instrução if para considerar o caso de uma matriz vazia.

Modelo de itens de catálogo, incluindo Liquid

Semelhante ao Connected Content, você deve usar o sinalizador :rerender em uma tag Liquid para renderizar o conteúdo Liquid de um item de catálogo. Observe que o sinalizador :rerender tem apenas um nível de profundidade, o que significa que não se aplicará a nenhuma chamada de tag Liquid aninhada.

Se um item de catálogo contiver campos de perfil de usuário (dentro de uma tag de personalização do Liquid), esses valores deverão ser definidos no Liquid no início da mensagem e antes do modelo para que o Liquid seja renderizado corretamente. Se o sinalizador :rerender não for fornecido, ele renderizará o conteúdo bruto do Liquid.

Por exemplo, se um catálogo chamado “Messages” tiver um item com este Liquid:

Para renderizar o seguinte conteúdo Liquid:

1
2
3
4
Hi ${first_name},

{% catalog_items Messages greet_msg :rerender %}
{{ items[0].Welcome_Message }}

Isso será exibido da seguinte forma:

1
2
3
Hi Peter,

Welcome to our store, Peter!