Punchh

A Punchh é uma plataforma de fidelidade e engajamento líder do setor que ativa as marcas para oferecer programas de fidelidade do cliente omnicanal, tanto na loja quanto digitalmente.

Essa integração é mantida pela Punchh.

Sobre a integração

A integração do Braze e da Punchh permite que você sincronize dados para fins de presente e fidelidade nas duas plataformas. Os dados publicados no Braze estarão disponíveis para segmentação e poderão sincronizar os dados de usuários de volta à Punchh por meio de webhooks do Braze.

Quais são os benefícios?

• Ingerir dados de fidelidade da Punchh para o Braze em tempo real.
• Use e estratifique os poderosos dados de público da Braze para oferecer experiências significativas e dinâmicas em vários canais (app, celular, web, e-mail e SMS).
  • Os clientes abriram os e-mails? Os clientes abriram o app perto de uma loja?
• Padronize a aparência dos e-mails de transação enviados pelo Braze.
• Crie jornadas que permitam testes A/B e otimização à medida que você avança.

Pré-requisitos

O que mais devo saber?

Antes de integrar

• Ao utilizar a integração do Braze, serão necessárias duas campanhas, uma no Punchh e a segunda no Braze. Por exemplo, se você enviar uma campanha com uma oferta anexada, a campanha de presentes será configurada no Punchh, e a notificação poderá ser enviada pelo Braze.
• Os convidados já devem existir em Punchh e Braze. A Punchh filtrará qualquer cliente que ainda não seja um cliente de fidelidade.

Pontos importantes a serem notados

• A Punchh adicionou a capacidade de desativar o envio de atributos padrão de usuários para o Braze, para que o cliente não incorra em excedentes de pontos de dados. Isso é configurado durante a configuração do adaptador.
• Se estiver usando segmentos personalizados em campanhas recorrentes, o nome da campanha deve ser usado em vez do ID da campanha, pois os IDs mudam a cada vez que a campanha é executada.
• Os canais de comunicação disponíveis em cada campanha de envio de mensagens da Punchh incluem mensagens ricas, notificações por push, SMS e envio de e-mail.
• Depois que os usuários forem enviados para um segmento personalizado da Punchh do Braze, eles não poderão ser removidos. Somente novos hóspedes podem ser adicionados a um segmento personalizado existente. Se os hóspedes precisarem ser removidos de um segmento personalizado da Punchh existente, será necessário criar uma nova campanha de webhook no Braze para enviar os usuários a um novo segmento personalizado da Punchh.

Integração

A Punchh oferece vários pontos de extremidade disponíveis aos clientes do Braze para ajudar a adicionar IDs externos à plataforma Punchh usando os seguintes pontos de extremidade da API da Punchh. Depois que as IDs externas forem adicionadas, crie um adaptador no Punchh, forneça suas credenciais do Braze e selecione os eventos que deseja sincronizar. Em seguida, você pode pegar o ID do segmento do Punchh e usá-lo para criar um webhook do Punchh para disparar a sincronização do cliente em uma jornada do Canva.

Observe que o Punchh user_id e o Braze external_id precisam estar disponíveis em qualquer uma das plataformas para que a integração seja sincronizada corretamente. 

• Os eventos enviados da Punchh para o Braze incluirão o Braze external_id como identificador. Se a Punchh estiver configurada para usar o external_source_id, esse valor será definido como o Braze external_id. Caso contrário, a integração terá como padrão a configuração do Punchh user_id como Braze external_id.
• Para enviar webhooks do Braze para o Punchh, o Punchh user_id deve estar disponível no perfil do usuário do Braze. Se o Punchh user_id não for usado como Braze external_id, ele deverá ser definido como um atributo personalizado “punchh_user_id”. 

Etapa 1: Configurar endpoints externos de ingestão de ID (opcional)

As IDs externas do Braze podem ser adicionadas usando os seguintes endpoints para usuários novos e existentes do Punchh.

1. Novos usuários do Punchh
   Crie novos usuários no Punchh com um ponto de extremidade de fazer login no Punchh usando os campos external_source e external_source_id. A Punchh permite que identificadores externos sejam enviados com um perfil de usuário por meio de um dos seguintes pontos de extremidade de inscrição:
   • API de inscrição móvel
   • API de inscrição por SSO
     
     
2. Usuários existentes da Punchh
   Atualize o external_source_id para os usuários existentes da Punchh. O Punchh permite que identificadores externos sejam adicionados a um perfil por meio de um ponto de extremidade de atualização da API do usuário:
   • Atualização do usuário móvel
   • Atualização do usuário SSO
   • Atualização do usuário do dashboard
     
     

• user sign-up api example
• user update api example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
curl --location --request POST 'https://server_name_goes_here.punchh.com/api2/mobile/users' \
--header 'Content-Type: application/json' \
--header 'x-pch-digest: SIGNATURE' \
--header 'Accept-Timezone: Etc/UTC' \
--header 'Accept: application/json' \
--header 'Accept-Language: en' \
--data-raw '{
    "client":"CLIENT",
    "user" : {
      "email": "[email protected]",
      "password": "PASSWORD",
      "first_name":"FIRST_NAME",
      "last_name":"LAST_NAME",
      "terms_and_conditions":"true",
      "anniversary":"2014-02-02",
      "zip_code":"94497",
      "birthday":"2004-02-02",
      "external_source":"customer_id",
      "external_source_id":"111111111111111111"
      }
}'

1
2
3
4
5
6
7
8
9
10
11
12
13
curl --location --request PUT 'https://server_name_goes_here.punchh.com/api2/mobile/users' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Accept-Language: en' \
--header 'x-pch-digest: SIGNATURE' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--data-raw '{
    "client":"CLIENT",
    "user": {
        "external_source":"customer_id",
        "external_source_id":"111111111111111111"
    }
}'

Etapa 2: Configuração do adaptador de Braze em Punchh

Eventos disponíveis para sincronização

1. Convidado: Disparado em qualquer inscrição, atualização do perfil do convidado, desativação ou exclusão
2. Check-in de fidelidade: Disparado para transações de fidelidade ou ganhos por meio da leitura do código de barras do recibo
3. Check-in de presentes: Disparado para pontos concedidos em uma campanha
4. Redenção: Disparado no caso de qualquer resgate de recompensas, excluindo os cupons Punchh, pois eles seriam enviados separadamente como eventos de cupom, incluindo a emissão e o resgate
5. Recompensas: Disparado a partir de recompensas oferecidas por campanhas, atividades, conversão de pontos em recompensas ou ofertas de administradores
6. Notificações de transação: Disparado após a atividade transacional de um usuário no sistema Punchh (por exemplo, expiração de pontos)
7. Notificações de marketing: Disparado com base em diferentes configurações de campanha no Punchh para um segmento associado de usuários

Trabalhe com seu gerente de implementação da Punchh para configurar esse adaptador.

Para configurar a integração do Braze e do Punchh, faça o seguinte:

1. No painel do Punchh, navegue até Cockpit > Dashboard > Principais recursos > Ativar gerenciamento de webhook e ative a opção Ativar gerenciamento de webhook.
   
   
2. Em seguida, ative os adaptadores navegando até Configurações > Gerenciador de webhooks > Configurações > guia Mostrar adaptadores e ative a guia Mostrar adaptadores.
   
   
3. Navegue até o Webhooks Manager na guia Settings (Configurações), selecione a guia Adapters (Adaptadores ) e clique em Create Adapter (Criar adaptador).
   
   
   
   
4. Preencha o nome do adaptador, a descrição e o e-mail do administrador. Selecione Braze como seu adaptador e forneça seu ponto de extremidade da API REST do Braze e a chave de API do Braze.
   
   
5. Em seguida, selecione os eventos disponíveis que gostaria de ativar. Uma lista desses eventos pode ser encontrada em Eventos disponíveis para sincronização.
   
   
   
   
6. Clique em Submit para ativar o webhook.

Criar o webhook Punchh no Braze

O Braze pode adicionar usuários a um segmento da Punchh por meio de webhooks que utilizam os segmentos personalizados da Punchh.

1. Crie um segmento personalizado na Punchh e note o endereço custom_segment_id presente no URL do dashboard do segmento da Punchh, conforme mostrado abaixo. Podem ser usados os criadores de segmentos clássicos ou beta. No entanto, a versão beta é recomendada, pois a versão clássica acabará sendo descontinuada.
   
   Na plataforma Punchh, navegue até Convidado > Segmento > Lista personalizada > Nova lista personalizada.
   
   
   
   

2. Crie uma campanha de webhook no Braze usando o endpoint Punchh para adicionar um usuário a um segmento personalizado como o URL do webhook. Aqui você pode fornecer o custom_segment_id extraído do URL e o user_id como pares de valores-chave.
   
   
   
   

3. Esse webhook pode ser configurado como uma campanha singular ou como uma etapa de um Canva. Como alternativa, se o webhook que adiciona usuários a esse segmento específico do Punchh for usado em várias campanhas ou Canvas, ele poderá ser configurado como um modelo.
   
   A chave user_id no webhook mapeia o ID de usuário da Punchh. Esse identificador precisará ser adicionado a todos os webhooks criados no Braze para adicionar usuários a um segmento personalizado da Punchh. O atributo personalizado punch_user_id pode ser preenchido dinamicamente como o valor da chave user_id usando o Liquid. Você pode inserir a variável de atributo personalizado punchh_user_id usando o ícone azul de “mais”, localizado no canto superior direito de qualquer campo de texto de modelo.
   
   
   
   
   
   

4. Depois que o webhook é salvo, ele pode ser usado para sincronizar usuários, conforme mostrado abaixo. Por exemplo, 136 hóspedes seriam adicionados ao segmento personalizado Punch quando essa campanha do webhook Braze fosse lançada.
   
   

Para saber mais sobre como os webhooks são usados no Braze, consulte Criar um webhook.

Campanhas de casos de uso

Configuração da campanha e do Canva

Como gerenciar os gatilhos

Os casos de uso para envio de mensagens do Braze acionados por eventos da Punchh enviados ao Braze, como eventos de recompensas ou eventos de convidados, podem ser criados como campanhas baseadas em ações ou Canvas disparados pelo evento relevante da Punchh.

A adição de um gatilho abre a lista de eventos criados no Braze. Escolha o evento que deve disparar a campanha ou o Canva a ser enviado ao usuário que registrou o evento.

Filtros de propriedade podem ser adicionados para filtrar ainda mais o evento-gatilho. Por exemplo, a mensagem só deve ser disparada quando um cliente acionar o evento “checkins_gift” em que a propriedade do evento aprovado for true. Esse é um recurso opcional que pode não ser aplicável a todos os casos de uso.

Segmentação

Em muitos casos, as campanhas e as telas do Braze acionadas por eventos da Punchh podem ser definidas para um público de “Todos os usuários” porque a segmentação dos usuários que disparam esses eventos é determinada na Punchh. No entanto, os clientes que desejam refinar ainda mais o público de usuários que receberão o envio de mensagens do Braze disparado pelo evento podem fazê-lo adicionando filtros e segmentos adicionais na seção Públicos-alvo do criador da campanha ou no Público de entrada do criador do Canvas.

Casos de uso

• signup
• braze welcome
• mass offer
• recurring mass offer
• post check-in offer with notification
• post check-in offer without notification
• anniversary
• recall