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 da Braze com a Punchh permite que você sincronize dados para fins de presentes e fidelidade nas duas plataformas. Os dados publicados na Braze estarão disponíveis para segmentação e poderão sincronizar os dados de usuários de volta à Punchh por meio de webhooks da Braze.

Quais são os benefícios?

• Ingerir dados de fidelidade da Punchh para a Braze em tempo real.
• Usar e estratificar 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?
• Padronizar a aparência dos e-mails de transação enviados pela Braze.
• Criar 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 da Braze, serão necessárias duas campanhas, uma na Punchh e a segunda na Braze. Por exemplo, se você enviar uma campanha com uma oferta anexada, a campanha de presentes será configurada na Punchh, e a notificação poderá ser enviada pela Braze.
• Os convidados já devem existir na Punchh e na 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 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 a cada vez que a campanha é executada.
• Os canais de comunicação disponíveis em cada campanha de presentes da Punchh incluem mensagens ricas, notificações por push, SMS e e-mail.
• Depois que os usuários forem enviados para um segmento personalizado da Punchh a partir da Braze, eles não poderão ser removidos. Somente novos convidados podem ser adicionados a um segmento personalizado existente. Se os convidados precisarem ser removidos de um segmento personalizado da Punchh existente, será necessário criar uma nova campanha de webhook na Braze para enviar os usuários a um novo segmento personalizado da Punchh.

Integração

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

Observe que o user_id da Punchh e o external_id da Braze precisam estar disponíveis em qualquer uma das plataformas para que a integração seja sincronizada 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 terá como padrão a configuração do user_id da Punchh como external_id da Braze.
• Para enviar webhooks da Braze para a Punchh, o user_id da Punchh deve estar disponível no perfil do usuário da Braze. Se o user_id da Punchh não for usado como external_id da Braze, ele deverá ser definido como um atributo personalizado “punchh_user_id”.

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

Os 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 da Punchh e não devem estar associados a perfis existentes.

1. Novos usuários da 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 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. A Punchh permite que identificadores externos sejam adicionados a um perfil por meio de um endpoint 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"
    }
}'

Nota

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

Etapa 2: Configuração do adaptador da Braze na 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. Resgate: Disparado no caso de qualquer resgate de recompensas, excluindo os cupons da 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 na Punchh para um segmento associado de usuários

Nota

Consulte a documentação da Punchh para saber como podem ser as cargas úteis de exemplo desses eventos disponíveis.

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

Para configurar a integração da Braze com a Punchh, faça o seguinte:

1. No dashboard da Punchh, navegue até Cockpit > Dashboard > Major Features > Enable Webhook Management e ative a opção 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 a chave de API da 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 webhook da Punchh na Braze

A 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 anote o custom_segment_id presente na 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é 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 segmento personalizado como a URL do webhook. Aqui você pode fornecer o custom_segment_id extraído da 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 Canvas. Como alternativa, se o webhook que adiciona usuários a esse segmento específico da Punchh for usado em várias Campaigns 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 na Braze para adicionar usuários a um segmento personalizado da Punchh. O atributo personalizado punchh_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 convidados seriam adicionados ao segmento personalizado da Punchh quando essa campanha de webhook da Braze fosse lançada.
   
   

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

Campanhas de casos de uso

Configuração de Campaign e Canvas

Disparo

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

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

Filtros de propriedade podem ser adicionados para filtrar 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 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 Campaigns e Canvas da Braze acionados por eventos da Punchh podem ser definidos 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 da Braze disparado pelo evento podem fazê-lo adicionando filtros e segmentos adicionais na seção Target Audiences do criador da Campaign ou no Entry Audience 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