Plataforma de fidelidade SessionM
A SessionM é uma plataforma de engajamento com clientes e fidelidade que oferece recursos de gerenciamento de campanhas e soluções de gerenciamento de fidelidade para ajudar os profissionais de marketing a impulsionar o direcionamento para aumentar o engajamento e a lucratividade.
Pré-requisitos
| Origem | Requisito | Descrição |
|---|---|---|
| Braze | Uma chave da API REST da Braze | Uma chave da API REST da Braze com permissões trigger_send. Isso pode ser criado no dashboard da Braze em Configurações > Chaves de API. |
| Braze | Um endpoint REST da Braze | Sua URL de endpoint REST. Seu endpoint dependerá da URL da Braze para sua instância. |
| Braze e SessionM | Identificador correspondente | Para usar a integração, certifique-se de que tanto a SessionM quanto a Braze tenham um registro dos identificadores usados por cada plataforma. As referências a user_id correspondem ao identificador de usuário da SessionM gerado no momento da criação do perfil na SessionM. |
| SessionM | Uma conta SessionM | É necessário ter uma conta SessionM para aproveitar essa parceria. |
| SessionM | Um endpoint REST do SessionM Core | Seu endpoint dependerá da URL da SessionM da sua instância. Isso pode ser criado no dashboard da SessionM em Digital Properties. |
| SessionM | Uma chave da API REST do SessionM Core | A chave da API da SessionM associada à sua instância e à integração da Braze. Essa chave pode ser usada para todas as chamadas baseadas em core, inclusive tags. Isso pode ser criado no dashboard da SessionM em Digital Properties. |
| SessionM | Um segredo da API REST do SessionM Core | O segredo da API da SessionM associado à sua instância e à integração da Braze. Essa chave pode ser usada para todas as chamadas baseadas em core, inclusive tags. Isso pode ser criado no dashboard da SessionM em Digital Properties. |
| SessionM | Um endpoint REST do SessionM Connect | Seu endpoint dependerá da URL da SessionM da sua instância. Entre em contato com o gerente técnico de conta da SessionM ou com a equipe de Delivery para obter. |
| SessionM | Uma string de autorização REST do SessionM Connect | A string de autorização básica do SessionM Connect associada à sua instância. Essa string de autenticação pode ser usada para todas as chamadas baseadas em connect, incluindo get_user_offers. Entre em contato com o gerente técnico de conta da SessionM ou com a equipe de Delivery para obter. |
| SessionM | Um ID de varejista do SessionM Connect REST | Um GUID de identificação exclusivo para o cliente específico associado à sua instância. Entre em contato com o gerente técnico de conta da SessionM ou com a equipe de Delivery para obter. |
Se estiver usando a navegação mais antiga, você pode criar uma chave de API em Console de desenvolvedor > Configurações de API.
Casos de uso
Os casos de uso a seguir mostram algumas maneiras de aproveitar a integração da SessionM com a Braze.
- Crie uma segmentação que incorpore dados de todas as plataformas de fidelidade, gestão de clientes e envio de mensagens.
- Use a segmentação robusta para direcionar conjuntos específicos de usuários com ofertas e promoções.
- Aproveite as informações mais atualizadas sobre usuários, ofertas e fidelidade ao enviar mensagens.
- Forneça notificações detalhadas aos clientes sobre o progresso e a conclusão das atividades promocionais e de fidelidade.
- Notifique os clientes quando uma nova oferta for concedida e forneça os detalhes da oferta.
Integração da SessionM com a Braze
Etapa 1: Criar um segmento na Braze
Na Braze, crie um segmento de usuários para direcionar com promoções e ofertas da SessionM.

Etapa 2: Importar segmentos da Braze para a SessionM
Opção 1: Exportar para o endpoint SessionM Tag (recomendado)
Primeiro, crie uma campanha de webhook na Braze e defina a URL do webhook como {{endpoint_core}}/priv/v1/apps/{{appkey_core}}/users/{{${user_id}}}/tags. Use Liquid para definir o user_id na URL.
Usando um corpo de solicitação de texto bruto, crie o corpo do webhook para incluir as tags desejadas a serem adicionadas ao perfil do usuário na SessionM e o TTL desejado. Um exemplo é:
1
2
3
4
5
6
{
"tags":[
"braze_test"
],
"ttl":2592000
}

Na guia Configurações, adicione os pares de chave-valor para cada campo de cabeçalho de solicitação:
- Crie uma chave Content-Type com o valor correspondente application/json
- Crie uma chave Authorization com o valor correspondente Basic YOUR-ENCODED-STRING-KEY. Entre em contato com a equipe da SessionM para obter a chave de string codificada para o seu endpoint.

Programe sua entrega, defina seu Público-alvo para direcionar ao segmento que você criou anteriormente e, em seguida, lance sua campanha.
Esse processo também pode ser feito por meio de um cliente de API, como o Postman, fazendo uma solicitação diretamente ao endpoint SessionM Tag, especificando o cliente, o nome da tag e um TTL para cada usuário na chamada (um único usuário por chamada).
O exemplo de solicitação a seguir usa cURL.
1
2
3
4
5
6
7
8
9
10
curl --location -g --request POST '{{endpoint_core}}/priv/v1/apps/{{apikey_core}}/users/{{user_id}}/tags' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{base64_encoded_string}}' \
--data-raw '{
"tags":[
"tagname1",
"tagname2"
],
"ttl":20000
}'
Opção 2: Importação de CSV
Exporte seu segmento da Braze usando o segmentador da Braze e forneça um arquivo CSV à SessionM que contenha os clientes a serem marcados, o nome da tag e um TTL para cada usuário no arquivo.
Recuperação da carteira de ofertas em tempo real com a Braze
A integração da SessionM com a Braze permite a extração em tempo real dos dados de usuários da SessionM no momento do envio da mensagem, usando Conteúdo conectado, para eliminar o risco de comunicar aos clientes ofertas de fidelidade desatualizadas, expiradas ou já resgatadas.
O exemplo a seguir mostra o Conteúdo conectado sendo usado para modelar dados da carteira de ofertas em uma mensagem. No entanto, o Conteúdo conectado pode ser usado com qualquer um dos endpoints Connect da SessionM.
Etapa 1: Emitir oferta na SessionM
A SessionM emite ofertas para os clientes a partir de várias alavancas internas diferentes que podem ser configuradas. Após serem emitidas, as ofertas são movidas para um estado que a SessionM chama de “carteira de ofertas”.
O cliente deve concluir a ação necessária ou atender ao direcionamento, e a oferta é emitida na SessionM.
Em seguida, a SessionM adiciona a oferta à carteira do cliente no estado emitido.
Etapa 2: Chamar a API SessionM Offer Wallet
Na etapa da Campaign ou do Canvas com as ofertas da SessionM, use o Conteúdo conectado para fazer uma chamada de API para o endpoint get_user_offers da SessionM.
Na solicitação de Conteúdo conectado, especifique o user_id da SessionM do usuário e seu retailer_id para recuperar a lista completa de ofertas ativas que o cliente tem em sua carteira. Cada solicitação a esse endpoint pode incluir um único usuário. Entre em contato com a equipe da SessionM para obter a chave de string codificada para o cabeçalho de autorização básica na sua chamada de Conteúdo conectado.
No corpo da solicitação, culture tem como padrão en-US, mas é possível usar Liquid para modelar o idioma de um usuário para ofertas multilíngues da SessionM (por exemplo, usando "culture":"{{${language}}}").
1
2
3
4
5
6
7
8
9
10
11
12
13
14
{% capture postbody %}
{"retailer_id":"YOUR-RETAIL-ID","user_id":"{{${user_id}}}","skip":0,"take":1000,"include_pending_extended_data":false,"culture":"en-US"}
{% endcapture %}
{% connected_content
{{endpoint_connect}}/offers/api/2.0/offers/get_user_offers
:method post
:headers {
"Content-Type": "application/json",
"Authorization": "Basic YOUR-BASE64-ENCODED-KEY"
}
:body {{postbody}}
:save wallet
%}
Etapa 3: Preencher a carteira de ofertas para envio de mensagens da Braze
Depois que uma solicitação é feita ao endpoint, a SessionM retorna a lista completa de ofertas no estado emitido, juntamente com os detalhes completos de cada oferta. Este é um exemplo de resposta retornada:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
{
"status": "ok",
"payload": {
"user": {
"opted_in": false,
"activated": false,
...
},
"user_id": "00000000-0000-0000-0000-000000000000",
"user_offers": [
{
"offer_id": "1a2b3324-1da6-4e49-b921-afc386dabb60",
"offer_group_id": "00000000-0000-0000-0000-000000000000",
"offer_type": "manual_fulfillment",
...
}
],
"total_records": 1,
"offer_groups": [
{
"id": "00000000-0000-0000-0000-000000000000",
"name": "All Offers",
"sort_order": 0
}
],
"offer_categories": [
{
"id": "9a82f973-aae6-4e10-839b-7117a852cf9e",
"name": "All Offers",
"sort_order": 0
}
],
"total_points": 1000,
"available_points": 100
}
}
Usando a notação de ponto Liquid, isso pode ser preenchido na mensagem. Por exemplo, para personalizar a mensagem com o offer_id resultante, você pode aproveitar a carga útil de retorno usando {{wallet.payload.available_points}}, que retorna 100.
Essa é uma API individual. Se pretender enviar um lote de mais de 500 usuários, entre em contato com a equipe da conta SessionM para saber como incorporar dados em massa na integração.
Configuração do envio de mensagens disparadas
A integração entre a SessionM e a Braze permite que os dados do perfil do usuário, os detalhes da oferta e os saldos de pontos sejam preenchidos dinamicamente no envio de mensagens e enviados em tempo real para o cliente no ponto de ação.
Etapa 1: A equipe de Delivery da SessionM configura os modelos
Colabore com a equipe de Delivery da SessionM para desenvolver modelos a serem usados no envio de mensagens disparadas. A SessionM inserirá dados do perfil do usuário, detalhes da oferta e saldos de pontos nas mensagens e as disparará na Braze para envio de mensagens em tempo real para o cliente.
Os campos padrão presentes em todos os modelos da SessionM incluem:
canvas_idcampaign_idbroadcast flagcustomer identifieremail address
Ao definir o broadcast flag como true, a mensagem será enviada para todo o segmento que a Campaign ou o Canvas direciona na Braze.
Campos adicionais podem ser configurados com base em necessidades específicas:
- Dados da oferta:
offer_id,offer title,user offer id,description,terms and conditions,logo,pos discount id,expiration date - Dados do prêmio por pontos:
point award amount,point account name - Dados do evento de gatilho: qualquer dado no evento de gatilho que utilize o resultado do webhook de disparo/envio
- Dados específicos da campanha:
campaign runtime,campaign_id,campaign name,campaign custom data
Campos adicionais são enviados à Braze como trigger_properties para personalizar a mensagem.
Etapa 2: Criar uma Campaign ou Canvas na Braze
Crie uma Campaign disparada por API ou um Canvas na Braze para ser disparado pela SessionM. Se campos adicionais tiverem sido configurados, como offer_id ou offer title, use Liquid (como {{api_trigger_properties.${offer_id}}}) para adicionar os campos personalizados ao seu envio de mensagens.

Na guia Schedule Delivery, anote o ID da Campaign ou do Canvas, pois ele será adicionado às Advanced Settings da campanha SessionM.

Finalize os detalhes da sua Campaign ou Canvas e selecione Launch.
Etapa 3: Criar uma campanha promocional ou de envio de mensagens da SessionM
Em seguida, crie sua campanha na SessionM.

Atualize as configurações avançadas na campanha da SessionM para incluir a seguinte carga útil JSON contendo braze_campaign_id ou braze_canvas_id.
1
2
3
4
{
"braze_campaign_id": "{{CAMPAIGN ID}}",
"braze_canvas_id": "{{CANVAS ID}}",
}

Crie um disparo de mensagem com a programação ou o comportamento desejado. Em seguida, selecione Braze Messaging Variant como a Messaging Variant no menu External Message para usar o modelo.

Esse modelo extrai os atributos estáticos e dinâmicos relevantes e faz a chamada ao endpoint da Braze.
