Rokt Calendar

O Rokt Calendar é uma tecnologia dinâmica de marketing de calendário que ativa as marcas para empurrar eventos 1:1 e comunicações promocionais na forma de eventos e notificações de calendário.

A integração entre a Braze e a Rokt Calendar permite que seus assinantes da Rokt Calendar e seus dados sejam enviados para a Braze por webhooks da Braze. Em seguida, você pode usar esses dados no Braze Canvases para direcionamento de jornada e segmentação de público usando qualquer um dos seguintes atributos personalizados do Rokt Calendar.

Pré-requisitos

Segmentação do público

Quando o Rokt Calendar cria um novo usuário ou combina um assinante existente com um usuário do Braze, o Rokt Calendar enviará os seguintes atributos personalizados de inscrição que você pode filtrar no Braze:

O Rokt Calendar também acionará um evento personalizado do subscribe assim que o usuário se inscrever no calendário Rokt, que poderá ser usado na segmentação do Braze ou como disparador de uma campanha ou componente do Canvas.

Integração

Etapa 1: crie um público de inscritos no calendário

Para enviar eventos de calendário do Canva, é necessário ter uma configuração de calendário da Rokt Calendar com usuários já inscritos. Para fazer isso, será necessário informar aos usuários onde e como assinar o calendário. A Rokt Calendar recomenda estas sugestões:

Fornecer pontos de integração de inscrição

Para criar um público de calendários dos assinantes, será necessário oferecer um destino para o qual o usuário possa navegar e se inscrever. Alguns exemplos de pontos de integração de inscrição incluem:

• Adicione um botão de calendário ao seu site
• Adição de um link de calendário em um e-mail ou SMS
• Adicione um botão de calendário ao seu app
• Adicione um link de calendário nas redes sociais

Promover o calendário

Para criar um público de assinantes, você precisará promover o calendário para o seu público, para que ele saiba como se inscrever. Alguns exemplos de promoção de calendário incluem:

• Publicações em redes sociais
• Envio de e-mail com boletins informativos e atualizações
• Publicações no blog
• Notificações no app

Etapa 2: Criar um webhook do Rokt Calendar no Braze

No Braze, você pode configurar uma campanha de webhook ou um webhook em um Canva:

• Enviar um novo evento personalizado: Permitir que novos eventos sejam adicionados a um segmento dos calendários dos assinantes.
• Atualizar um evento personalizado: Permitir que uma atualização seja feita em um evento existente nos calendários dos assinantes.

Para criar um modelo de webhook da Rokt Calendar para ser usado em futuras campanhas ou Canvas, navegue até Modelos > Modelos de webhook na plataforma Braze.

Se quiser criar uma campanha única de webhook do Rokt Calendar ou usar um modelo existente, selecione Webhook no Braze ao criar uma nova campanha.

• enviar um novo evento
• atualizar um evento existente

Cabeçalhos de solicitação e método

A Rokt Calendar requer um HTTP Header para autorização que inclua seu nome de credencial de conteúdo conectado da Rokt Calendar. Os itens a seguir já estarão incluídos no modelo como pares de valores-chave, mas na guia Settings (Configurações), você deve substituir <Rokt-Calendar-API> pelo nome da credencial encontrado em Manage Settings > Connected Content > Credential.

• Método HTTP: POST
• Cabeçalho da solicitação:
  • Autorização: portador {% connected_content https://api.roktcalendar.com/oauth2/token :method post :basic_auth <Rokt-Calendar-API> :body grant_type=client_credentials :save token :retry %}{{token.access_token}}
  • Tipo de Conteúdo: application/json

Corpo da solicitação

• enviar um novo evento
• atualizar um evento existente
• detalhes do evento

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{% capture eventId %}Event_0001{% endcapture %}
{% capture eventTitle %}Event Title{% endcapture %}
{% capture eventDescr %}Event Description{% endcapture %}
{% capture eventLocation %}Event Location{% endcapture %}
{% capture eventStart %}2019-02-21T15:00:00{% endcapture %}
{% capture eventEnd %}2019-02-21T15:00:00{% endcapture %}
{% capture notifyBefore %}15{% endcapture %}
{% capture eventTZ %}Eastern Standard Time{% endcapture %}

{
  "event": {
    "eventId": "{{eventId}}_{{${user_id}}}",
    "title": "{{eventTitle}}",
    "description": "{{eventDescr}}",
    "location": "{{eventLocation}}",
    "start": "{{eventStart}}",
    "end": "{{eventEnd}}",
    "timezone": "{{eventTZ}}",
    "notifyBefore": "{{notifyBefore}}"
  },
  "subscriptionIds": ["{{custom_attribute.${rokt:subscription_id}| join: '","'  }}"]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{% capture eventId %}Event_0001{% endcapture %}
{% capture eventTitle %}Event Title{% endcapture %}
{% capture eventDescr %}Event Description{% endcapture %}
{% capture eventLocation %}Event Location{% endcapture %}
{% capture eventStart %}2019-02-21T15:00:00{% endcapture %}
{% capture eventEnd %}2019-02-21T15:00:00{% endcapture %}
{% capture notifyBefore %}15{% endcapture %}
{% capture eventTZ %}Eastern Standard Time{% endcapture %}

{
  "event": {
    "eventId": "{{eventId}}_{{${user_id}}}",
    "title": "{{eventTitle}}",
    "description": "{{eventDescr}}",
    "location": "{{eventLocation}}",
    "start": "{{eventStart}}",
    "end": "{{eventEnd}}",
    "timezone": "{{eventTZ}}",
    "notifyBefore": "{{notifyBefore}}"
  }
}

Etapa 3: veja uma prévia da sua solicitação

Pré-visualize a solicitação no painel Preview (Pré-visualização ) ou navegue até a guia Test (Teste ), onde é possível selecionar um usuário aleatório, um usuário existente ou personalizar o seu próprio usuário para testar o webhook.