Uso de catálogos em uma mensagem

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.

Etapa 1: Adicionar tipo de personalização

No criador de mensagens de sua escolha, selecione o ícone de adição para abrir o modal Add Personalization (Adicionar personalização ) e selecione Catalogs Items (Itens de catálogos ) para o tipo de personalização. Em seguida, selecione o nome do 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!

Casos de uso adicionais

Vários itens

Você não está limitado a apenas um item em uma única mensagem. Você pode usar o modal Add Personalization para adicionar até três itens de catálogo por vez. Para adicionar mais itens à sua mensagem, selecione Add Personalization (Adicionar personalização ) no criador de mensagens e selecione os itens adicionais do catálogo e as informações a serem exibidas.

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:

Obtenha o trio definitivo Tales, Teslagrad e Acaratus hoje mesmo!

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 declaração Liquid if em um formato como este:

1
2
3
4
5
6
{% catalog_items Test-list %}
{% if {{items[0].first-item}} == true %}
Do this
{% else %}
Do that
{% endif %}

Note que você deve declarar a lista de catálogos antes de usar as declarações if. No exemplo acima, Test-list é a lista de catálogos.

Caso de uso: Snippet do Liquid if

Nesse cenário, serão exibidas mensagens diferentes se o atributo personalizado venue_name tiver mais de 10 caracteres ou menos de 10 caracteres. Se venue_name for blank, nada será exibido.

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 less than 10 characters. 
{% else %} 
{% abort_message(no venue_name) %} 
{% endif %}

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 isso, atribua uma variável]10 ao seu atributo personalizado e, em seguida, use o modal Add Personalization para extrair um item específico da matriz.

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 just {{ items[0].price }}!

Que será exibido da seguinte forma:

Adquira o 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 reunir manualmente os catálogos Liquid logic. 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!