Punchh

A Punchh é uma plataforma de fidelidade e engajamento líder do setor que permite às marcas 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 entre a Braze e a Punchh permite sincronizar dados para fins de presentes e fidelidade entre as duas plataformas. Os dados publicados na Braze estarão disponíveis para segmentação e podem sincronizar dados de usuários de volta para a Punchh por meio de webhooks da Braze.

Quais são os benefícios?

• Ingira dados de fidelidade da Punchh para a Braze em tempo real.
• Aproveite e combine dados avançados de público da Braze para oferecer experiências dinâmicas e significativas entre canais (app, dispositivo móvel, 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 pela Braze.
• Crie jornadas que permitam testes A/B e otimização contínua.

Pré-requisitos

O que mais preciso saber?

Antes de integrar

• Ao utilizar a integração com a Braze, duas campanhas serão necessárias, uma na Punchh e a segunda na Braze. Por exemplo, se você enviar uma campanha com uma oferta anexada, a campanha de presente será configurada dentro da Punchh, e a notificação pode ser enviada a partir da Braze.
• Os convidados já devem existir na Punchh e na Braze. A Punchh filtrará qualquer cliente que ainda não seja um convidado do programa de fidelidade.

Pontos importantes a observar

• A Punchh adicionou a capacidade de desativar o envio de atributos de usuário padrão para a 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 cada vez que a campanha é executada.
• Os canais de comunicação disponíveis em cada campanha de presente da Punchh incluem mensagens ricas, notificações por push, SMS e e-mail.
• Depois que os usuários forem enviados para um Segment personalizado da Punchh a partir da Braze, eles não poderão ser removidos. Apenas novos convidados podem ser adicionados a um Segment personalizado existente. Se for necessário remover convidados de um Segment personalizado existente da Punchh, uma nova campanha de webhook precisará ser criada na Braze para enviar usuários a um novo Segment personalizado da Punchh.

Integração

A Punchh oferece vários endpoints disponíveis para clientes da Braze para ajudar a adicionar IDs externos à plataforma Punchh usando os seguintes endpoints de API da Punchh. Depois que os IDs externos forem adicionados, crie um adaptador na Punchh, forneça suas credenciais da Braze e selecione quais eventos você gostaria de sincronizar. Em seguida, você pode pegar o ID do Segment da Punchh e usá-lo para construir um webhook Punchh para disparar a sincronização de clientes em uma jornada Canvas.

Observe que o user_id da Punchh e o external_id da Braze precisam estar disponíveis em ambas as plataformas para que a integração sincronize corretamente.

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

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

IDs externos da Braze podem ser adicionados usando os seguintes endpoints para usuários novos e existentes da Punchh.

Importante

Os valores dos campos external_source e external_source_id devem ser exclusivos na Punchh e não estar associados a perfis existentes.

1. Novos usuários Punchh
   Crie novos usuários na Punchh com um endpoint de inscrição da 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 endpoints de inscrição:
   • API de inscrição mobile
   • API de inscrição SSO
     
     
2. Usuários Punchh existentes
   Atualize o external_source_id para usuários Punchh existentes. A Punchh permite que identificadores externos sejam adicionados a um perfil por meio de um endpoint de atualização de API de usuário:
   • Atualização de usuário mobile
   • Atualização de usuário SSO
   • Atualização de usuário no 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"
    }
}'

Nota

Configuração da plataforma: Para ativar identificadores externos na Punchh, no dashboard da Punchh, navegue até Cockpit > Dashboard > External User Identifier.

Etapa 2: Configuração do adaptador Braze na Punchh

Eventos disponíveis para sincronização

1. Guest: Disparado em qualquer inscrição, atualização do perfil do convidado, desativação ou exclusão
2. Loyalty Check-in: Disparado para transações de fidelidade ou pontuação ao escanear código de barras do recibo
3. Gift Check-in: Disparado para pontos presenteados por uma campanha
4. Redemption: Disparado em caso de qualquer resgate de recompensa, excluindo cupons Punchh, pois esses seriam enviados separadamente como eventos de cupom, incluindo emissão e resgate
5. Rewards: Disparado a partir de recompensas presenteadas por campanhas, atividade, conversão de pontos em recompensas ou presenteamento pelo administrador
6. Transaction Notifications: Disparado mediante atividade transacional para um usuário dentro do sistema Punchh (por exemplo, expiração de pontos)
7. Marketing Notifications: Disparado com base em diferentes configurações de campanha na Punchh para um Segment associado de usuários

Nota

Consulte a documentação da Punchh para ver exemplos de cargas úteis para esses eventos disponíveis.

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

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

1. No dashboard da Punchh, navegue até Cockpit > Dashboard > Major Features > Enable Webhook Management e ative Enable Webhook Management.
   
   
2. Em seguida, ative os adaptadores navegando até Settings > Webhooks Manager > Configurations > Show Adapters Tab e ative Show Adapters Tab.
   
   
3. Navegue até Webhooks Manager na guia Settings, selecione a guia Adapters e clique em Create Adapter.
   
   
   
   
4. Preencha o nome do adaptador, a descrição e o e-mail do administrador. Selecione Braze como seu adaptador e forneça seu endpoint da REST API da Braze e sua chave de API da Braze.
   
   
5. Em seguida, selecione os eventos disponíveis que você deseja ativar. Uma lista desses eventos pode ser encontrada em Eventos disponíveis para sincronização.
   
   
   
   
6. Clique em Submit para ativar o webhook.

Criar webhook Punchh na Braze

A Braze pode adicionar usuários a um Segment Punchh por meio de webhooks que utilizam Segments personalizados da Punchh.

1. Crie um Segment personalizado na Punchh e anote o custom_segment_id presente na URL do dashboard de Segments da Punchh, conforme mostrado no exemplo a seguir. Tanto o criador de segmentos clássico quanto o beta podem ser usados. No entanto, o beta é recomendado, pois o clássico será descontinuado eventualmente.
   
   Na plataforma Punchh, acesse Guest > Segment > Custom List > New Custom List.
   
   
   
   

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

3. Esse webhook pode ser configurado como uma Campaign singular ou como uma etapa dentro de um Canvas. Alternativamente, se o webhook que adiciona usuários a esse Segment Punchh específico for usado em múltiplas Campaigns ou Canvas, ele pode ser configurado como um modelo.
   
   A chave user_id dentro do webhook é mapeada para o ID de usuário da Punchh. Esse identificador precisará ser adicionado a todos os webhooks criados na Braze para adicionar usuários a um Segment personalizado da Punchh. O atributo personalizado punch_user_id pode ser preenchido dinamicamente como o valor da chave user_id usando Liquid. Você pode inserir a variável do atributo personalizado punchh_user_id usando o ícone azul de “mais” na barra de ferramentas do campo de texto com modelo.
   
   
   
   
   
   

4. Depois que o webhook for salvo, ele poderá ser usado para sincronizar usuários. Por exemplo, 136 convidados seriam adicionados ao Segment personalizado da Punchh quando essa campanha de webhook da Braze for lançada.
   
   

Para saber mais sobre como webhooks são usados na Braze, confira Criar um webhook.

Campanhas de casos de uso

Configuração de Campaign e Canvas

Disparo

Casos de uso para envio de mensagens da Braze disparados por eventos da Punchh enviados à Braze, como eventos de recompensa ou eventos de convidados, podem ser criados como Campaigns baseadas em ações ou Canvas disparados pelo evento relevante da Punchh.

Adicionar um disparo exibirá a lista de eventos criados na Braze. Escolha o evento que deve disparar sua Campaign ou Canvas para ser enviado ao usuário que registrou o evento.

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

Segmentação

Em muitos casos, Campaigns e Canvas da Braze disparados por eventos da Punchh podem ser definidos para um público “Todos os usuários”, já que a segmentação dos usuários que disparam esses eventos é determinada dentro da Punchh. No entanto, clientes que desejam refinar ainda mais o público de usuários que receberão as mensagens da Braze disparadas pelo evento podem fazer isso adicionando filtros e Segments adicionais na seção Públicos-alvo do criador de Campaign ou no Público de entrada do criador de Canvas.

Casos de uso

• inscrição
• boas-vindas da braze
• oferta em massa
• oferta em massa recorrente
• oferta pós-check-in com notificação
• oferta pós-check-in sem notificação
• aniversário
• recuperação