Yotpo

Yotpo, a principal plataforma de marketing eCommerce, ajuda milhares de marcas inovadoras a acelerar o crescimento direto ao consumidor. A abordagem de plataforma única da Yotpo integra soluções baseadas em dados para avaliações, fidelidade, marketing por SMS e muito mais, capacitando as marcas a criar experiências mais inteligentes e de maior conversão para os clientes.

Esta integração é mantida pela Yotpo.

Sobre a integração

Com a integração da Braze e da Yotpo, você pode extrair e exibir dinamicamente classificações por estrelas, principais avaliações e conteúdo visual gerado pelo usuário (UGC) sobre produtos em e-mails e outros canais de comunicação na Braze. Também é possível incluir dados de fidelidade no nível do cliente em e-mails e outros métodos de comunicação para criar uma interação mais personalizada, aumentando as vendas e a fidelidade.

Pré-requisitos

Antes de continuar, confirme se o ID do produto Yotpo é igual ao product_id que será extraído dinamicamente da Braze. Isso é obrigatório para que a integração funcione.

Para encontrar seu ID de produto Yotpo, execute as etapas a seguir:

1. Acesse o site da sua loja.
2. Abra a página do produto.
3. Clique com o botão direito do mouse e selecione Inspecionar.
4. Pressione Control + F e procure por yotpo-main no código. A variável data-product ID e seu valor aparecem na div da Yotpo.

Integração

Para integrar a Yotpo e a Braze, execute as etapas a seguir:

1. Acesse seu dashboard da Braze.
2. Na página Campaigns, clique em Create Campaign e selecione Email.
3. Selecione seu modelo preferido.
4. Clique em Edit email body e adicione o respectivo snippet de Conteúdo conectado para seu caso de uso:
   • Exibir a classificação por estrelas e o número de avaliações de um produto
   • Exibir uma avaliação recente de 5 estrelas de um produto
   • Exibir conteúdo visual gerado por usuários por produto
   • Exibir o saldo de fidelidade de um cliente em um e-mail

Exibir a classificação por estrelas e o número de avaliações de um produto

Use esse snippet para fornecer a pontuação média pública e o número total de avaliações de um produto incluído no e-mail:

1
2
3
4
5
6
7
8
9
10
{% connected_content https://api.yotpo.com/products/<YOTPO-API-KEY>/{{event_properties.${product_id}}}/bottomline :save result %}

{% if {{result.response.bottomline.average_score}} != 0 %}

The average rating for this product is:

{{result.response.bottomline.average_score}}/5, based on {{result.response.bottomline.total_reviews}} reviews.

{% else %}
{% endif %}

Substitua <YOTPO-API-KEY> pela sua chave de API de avaliações da Yotpo. O product_id será extraído dinamicamente da Braze. Para que a integração funcione, o product_id na Braze deve corresponder ao ID do produto na Yotpo (normalmente o ID do produto pai do eCommerce).

Exibir uma avaliação recente de 5 estrelas de um produto

Use esse snippet para fornecer uma das principais avaliações (publicadas) de um produto específico incluído no e-mail:

1
2
3
4
5
6
7
8
9
10
{% connected_content https://api.yotpo.com/v1/widget/<YOTPO-API-KEY>/products/{{event_properties.${product_id}}}/reviews.json?per_page=50&star=5&sort=votes_up :save result %}

{% if {{result.response.reviews[0].score}} == 5 %}

Recent 5 Star Review for this product:

{{result.response.reviews[0].content}}

{% else %}
{% endif %}

Substitua <YOTPO-API-KEY> pela sua chave de API de avaliações da Yotpo. O product_id será extraído dinamicamente da Braze. Para que a integração funcione, o product_id na Braze deve corresponder ao ID do produto na Yotpo (normalmente o ID do produto pai do eCommerce).

Veja a seguir como o snippet ficará no seu editor de e-mail:

Exibir conteúdo visual gerado por usuários por produto

Use esse snippet para recuperar imagens da Yotpo marcadas e publicadas e adicioná-las aos seus e-mails em vez da imagem padrão ou como uma galeria adicional:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{% connected_content https://api.yotpo.com/v1/widget/<YOTPO-API-KEY>/albums/product/{{event_properties.${product_id}}}?per_page=1 :save result %}

{% if {{result.response.images[0].tagged_products[0].image_url}} != null %}

The Visual content of the product:

<img src="{{result.response.images[0].tagged_products[0].image_url}}" border="0" width="200" height="200" alt="" />

{% else %}

Image return NULL

{% endif %}

Substitua <YOTPO-API-KEY> pela sua chave de API de avaliações da Yotpo. O product_id será extraído dinamicamente da Braze. Para que a integração funcione, o product_id na Braze deve corresponder ao ID do produto na Yotpo (normalmente o ID do produto pai do eCommerce).

O snippet ficará assim:

Exibir o saldo de fidelidade de um cliente em um e-mail

Use esse snippet para recuperar o saldo de pontos de fidelidade de um cliente e usá-lo no seu envio de mensagens por e-mail:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{% connected_content

https://loyalty.yotpo.com/api/v2/customers?customer_email=**{{${email_address}}}**
:method get
:headers {
    "x-guid": "<YOTPO-LOYALTY-GUID>",
    "x-api-key": "<YOTPO-LOYALTY-API-KEY>"
        }
:content_type application/json
:save publication
%}

You have {{publication.points_balance}} points

Only {{publication.vip_tier_upgrade_requirements.points_needed}} more points to become part of our VIP Tier!

Substitua <YOTPO-LOYALTY-GUID> e <YOTPO-LOYALTY-API-KEY> pelas suas credenciais de fidelidade da Yotpo. O email_address é extraído dinamicamente da Braze. Para que a integração funcione, o e-mail deve ser o endereço de e-mail do cliente que está recebendo o e-mail.

O snippet ficará assim:

Perguntas frequentes

E se eu não tiver uma avaliação de 5 estrelas?

Se você não tiver nenhuma avaliação de 5 estrelas (por exemplo, se a resposta do endpoint retornar NULL para a avaliação de 5 estrelas), nenhum conteúdo será exibido.

E se eu não tiver uma imagem publicada para um produto?

Se você não tiver nenhuma imagem para um produto (por exemplo, se a resposta do endpoint retornar NULL para a imagem do produto), nenhum conteúdo será exibido.

Posso personalizar a aparência ou extrair outros campos de dados da Yotpo?

Sim! Para descobrir outros pontos de dados e opções de personalização disponíveis, consulte Fazer uma chamada de API. Talvez você precise da ajuda de um desenvolvedor de front-end para fazer isso.

Nota

A Yotpo não oferece suporte a requisitos personalizados além do que está descrito neste guia.