Rokt Calendar

Rokt Calendar es una tecnología de marketing de calendario dinámico que permite a las marcas impulsar eventos 1:1 y comunicaciones promocionales en forma de eventos de calendario y notificaciones.

Esta integración está mantenida por Rokt Calendar.

Sobre la integración

La integración de Braze y Rokt Calendar permite que tus suscriptores de Rokt Calendar y sus datos sean enviados a Braze a través de Braze webhook. A continuación, puede utilizar estos datos en Braze Canvases para la segmentación de la audiencia y la segmentación de viajes utilizando cualquiera de los siguientes atributos de Rokt Calendar personalizados.

Requisitos previos

Segmentación de la audiencia

Cuando Rokt Calendar crea un nuevo usuario o hace coincidir un suscriptor existente con un usuario Braze, Rokt Calendar enviará los siguientes atributos de suscripción personalizados que puede filtrar dentro de Braze:

Rokt Calendar también activará un evento personalizado subscribe tan pronto como el usuario se haya suscrito a su calendario Rokt que se puede utilizar tanto en la segmentación Braze o ser utilizado como un disparador para una campaña o componente Canvas.

Integración

Paso 1: Crear una audiencia de suscriptores del calendario

Para enviar eventos de calendario desde Canvas, primero debes tener configurado un calendario Rokt con usuarios ya suscritos. Para ello, deberá informar a sus usuarios de dónde y cómo suscribirse al calendario. Rokt Calendar te recomienda que:

Proporcionar puntos de integración de suscripciones

Para crear una audiencia de suscriptores al calendario, tendrá que ofrecer un destino al que el usuario pueda navegar y suscribirse. Algunos ejemplos de puntos de integración de suscripciones son:

• Añada un botón de calendario a su sitio web
• Añadir un enlace de calendario en un correo electrónico o SMS
• Añade un botón de calendario a tu aplicación
• Añadir un enlace al calendario en las redes sociales

Promocionar el calendario

Para crear una audiencia de suscriptores, tendrás que promocionar el calendario entre tu público para que sepan cómo suscribirse. Algunos ejemplos de promoción de calendarios son:

• Publicaciones en las redes sociales
• Boletines y actualizaciones por correo electrónico
• Entradas de blog
• Notificaciones en la aplicación

Paso 2: Crear un webhook de Calendario Rokt en Braze

En Braze, puede configurar una campaña webhook o un webhook dentro de un Canvas para cualquiera de los dos:

• Enviar un nuevo evento personalizado: Permite añadir nuevos eventos a un segmento de los calendarios de los abonados.
• Actualizar un evento personalizado: Permitir la actualización de un evento existente en los calendarios de los abonados.

Para crear una plantilla de webhook de Calendario Rokt para usar en futuras campañas o Lienzos, navega a Plantillas > Plantillas de Webhook en la plataforma Braze.

Si desea crear una campaña de webhook de Calendario Rokt única o utilizar una plantilla existente, seleccione Webhook en Braze al crear una nueva campaña.

• enviar un nuevo evento
• actualizar un evento existente

Encabezados de solicitud y método

Rokt Calendar requiere un HTTP Header para la autorización que incluya tu nombre de credencial de contenido conectado de Rokt Calendar. Lo siguiente ya estará incluido dentro de la plantilla como pares clave-valor, pero en la pestaña Configuración, debe sustituir <Rokt-Calendar-API> por el nombre de la credencial que se encuentra en Manage Settings > Connected Content > Credential.

• Método HTTP: POST
• Encabezado de solicitud:
  • Autorización: 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}}
  • Content-Type: application/json

Cuerpo de la solicitud

• enviar un nuevo evento
• actualizar un evento existente
• detalles del 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}}"
  }
}

Paso 3: Vista previa de su solicitud

Previsualiza tu solicitud en el panel de Previsualización o navega a la pestaña de Prueba, donde puedes seleccionar un usuario al azar, un usuario existente, o personalizar el tuyo propio para probar tu webhook.